MCP Server

Ask Demiton exposes your operational data as tools that any MCP-compatible AI client - including Claude - can call directly. Ask questions about project financials, workforce, site records, and civil memory in natural language, with every response sourced from your connected data.

Available on every tier. What changes between tiers is the scope of data the MCP can read:

Tier	What the MCP can read
Public	AusTender, ABR, BOM, and CKAN open data
Insights	Public data + your uploaded contracts and estimating data
Connected	Public data + uploads + your live integrated systems (ERP, field ops, payroll, documents)

Every tool call is identity-bound and audited.

Tip

Not sure which tier you need? Try the Cross River Rail public preview - real contractor and weather data, no account required. When you’re ready to ask questions about your own contracts, sign up for Insights.

Note

Invited by your organisation? If a colleague sent you a Demiton invitation, you are joining a Connected-tier workspace. After accepting the invite and signing in with your Microsoft work account, follow the Connected tier tab below. When the sign-in browser window appears during setup, use the same Microsoft work account your invite was sent to.

---

How do I connect Claude or ChatGPT to Demiton?

Claude (web)

The fastest way to connect if you use claude.ai in a browser. No config file, no installer, no command line.

1. Open any Claude conversation and click Customize (bottom-left of the sidebar).
2. Select Connectors, then click +.
3. Enter the server URL: https://api.demiton.io/mcp
4. Sign in with your Demiton account when the OAuth prompt appears.

That’s it. Demiton will appear in your Connectors list and its tools become available in every conversation.

The same tier model applies: Public (free), Insights, or Connected. Your account tier determines which tools and data sources are available.

Note

Don’t have an account? Sign up at demiton.io - the Public tier is free with a verified business email.

ChatGPT

ChatGPT supports MCP connectors natively through its connector builder. No command-line tools or config file edits needed.

Create a new connector with these values:

Field	Value
Name	Demiton
Server URL	https://api.demiton.io/mcp
Authentication	OAuth

Leave the advanced OAuth panel as-is. ChatGPT auto-discovers the OAuth endpoints from the server - no manual endpoint configuration required. Click Create, then sign in with your Demiton account when the OAuth prompt appears.

The same tier model applies: Public (free), Insights, or Connected. Your account tier determines which tools and data sources are available - the connection setup is identical for all three.

Note

Don’t have an account? Sign up at demiton.io - the Public tier is free with a verified business email.

Claude Desktop

The MCP server is at https://api.demiton.io/mcp. Connect via OAuth using mcp-remote - your tier permissions apply automatically on sign-in.

One-line installer (recommended):

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/demitonapp/claude-desktop-installer/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/demitonapp/claude-desktop-installer/main/install.ps1 | iex

Source and uninstall: github.com/demitonapp/claude-desktop-installer

Or add manually to claude_desktop_config.json:

{
  "mcpServers": {
    "demiton": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.demiton.io/mcp"]
    }
  }
}

On first run, a browser window opens to sign in with your Demiton account. No API key is stored in the config.

Note

Microsoft organisation? If your organisation uses Entra ID (Azure AD), the sign-in window will show a Microsoft login prompt. Use your Microsoft work account - the same one your Demiton invitation was sent to.

Note

Headless or CI access? Generate an API key in HQ → API Keys and use it as a Bearer token instead:

{
  "mcpServers": {
    "demiton": {
      "type": "http",
      "url": "https://api.demiton.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

---

What tools does Ask Demiton provide?

Ask Demiton exposes a small, stable set of tools to your MCP client. The headline tool is ask_demiton, which routes any natural-language question to the right data sources internally - you do not call individual data sources as separate tools.

Tool	What it does
ask_demiton	Ask any question in natural language. Demiton classifies the intent and routes it to the right data sources for your tier - market intelligence, procurement search, weather, AusTender lookups, project financials, workforce, assets, vendors, and civil memory.
list_reports	List the reports available for you to run.
run_report	Trigger a report. Returns the results or a run id to poll.
get_report_run	Poll a report run for status and artifacts.
list_forms	List the forms available for you to fill in.
open_form	Open an interactive form in your client.
submit_form	Validate and persist a completed form.
log_memory	Remember a durable fact you have stated.

Connected tier

On the Connected tier, ask_demiton can also reach the live data in your integrated systems (ERP, field ops, payroll, documents). You do not need separate tools - just ask ask_demiton. For example:

• Project intelligence - ask about project financials, budget variance and its drivers, cost-code breakdowns, induction requirements, and the civil memory accumulated for a project.
• Workforce - ask which workers are on a project, a worker’s skills and inductions, the plant a worker can operate, who is qualified for a role or asset, who is available near a location, and the memory accumulated for a worker.
• Assets - ask which plant is on a project, an asset’s charge rate, who is qualified to operate it, and the memory accumulated for an asset.
• Site data - ask Demiton to search site diaries, safety forms, toolbox talks, inspection records, and resource allocations.
• Procurement - ask about historical procurement records and the memory accumulated for a vendor (performance, payment history, scope patterns).

For repeatable, structured output use run_report (see list_reports for what is available on your tier).

---

What questions can I ask Demiton through Claude?

Once connected, you can ask your AI assistant questions like:

• “What’s the current budget position on Pacific Highway?”
• “Which workers on site at Burringbar are qualified to operate the excavator?”
• “Show me safety incidents recorded in the last two weeks.”
• “What were the ground conditions on the Cunningham Gap project last month?”
• “Who’s available near postcode 4000 with earthworks experience?”

Every answer is sourced from your connected data and filtered to data you are authorised to see.

---

Troubleshooting

Demiton does not appear as a tool in Claude Desktop

1. Restart Claude Desktop. Config changes only take effect on restart - opening a new conversation is not enough.
2. Check the config file path. macOS: ~/Library/Application Support/Claude/claude_desktop_config.json. Windows: %APPDATA%\Claude\claude_desktop_config.json.
3. Validate your JSON. A single missing comma or bracket prevents the entire config from loading. Paste the file into jsonlint.com to check.
4. Check Node.js is installed. mcp-remote requires Node 18 or later. Run node --version in a terminal - if the command is not found, install Node from nodejs.org.

The sign-in browser window opens but authentication fails

1. Use the right sign-in method for your account.
   • Invited by your organisation via Microsoft? Sign in with your Microsoft work account.
   • Signed up via Google? Use Google sign-in.
   • Signed up with email and password? Use that.
2. Check your account is active. Log in at app.demiton.io directly to confirm your account is not suspended or pending email verification.
3. Clear the mcp-remote token cache. Tokens are stored in ~/.mcp-remote-cache (macOS/Linux) or %APPDATA%\mcp-remote-cache (Windows). Delete the folder and reconnect.

I get 401 Unauthorized on every tool call

• API key auth: the key may have been rotated or deleted. Generate a new key in HQ → API Keys and update your config.
• OAuth (mcp-remote): your session has expired. Delete ~/.mcp-remote-cache and reconnect to get a fresh token.

Claude says it cannot access my data or returns empty results

• Insights tier: Upload your contract and estimating data at app.demiton.io before querying. The MCP reads from your uploaded data - there is nothing to return until data is indexed. See Uploading Your Data.
• Connected tier: At least one system must be connected and synced before live data is returned. See Connecting a System.
• Wrong tier: Some data sources require a higher tier. Live integrated-system data requires Connected. If you are on Public or Insights, ask_demiton will only return data your tier permits.

ask_demiton cannot find a project I named

Refer to the project by its exact code (e.g. P2025-001) or a distinctive name fragment (e.g. Silverwater or Parramatta Rail). Avoid generic fragments like Road Upgrade that could match multiple projects. Project codes are shown on the Projects surface in the Demiton app.

Claude returns a quota exceeded error

Your organisation has reached its monthly MCP call limit for your plan. Contact support@demiton.io or review usage in HQ → Billing.

ChatGPT shows an error when adding the connector

1. Check the Server URL. It must be exactly https://api.demiton.io/mcp with no trailing slash.
2. Leave the advanced OAuth panel unchanged. ChatGPT discovers the OAuth configuration automatically - do not fill in the authorization or token endpoint fields manually.
3. Sign in with the right account. When the OAuth prompt appears, use your Demiton account (the same email and provider you used to sign up at app.demiton.io).

Still stuck?

Email support@demiton.io with your account email, the error message or symptom, which client you are using (Claude Desktop, Claude Code, claude.ai, ChatGPT, or other), and your operating system.

---

Next steps

• Uploading Your Data - Insights customers: upload contracts and estimating data to start querying
• Connecting a System - Connected customers: connect your ERP, field ops, and payroll systems
• API Access - programmatic access via API key (Connected tier)
• Connectors overview - all systems Demiton integrates with