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:

Table

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

Every tool call is identity-bound and audited.

Tip

Not sure which tier you need? See Quickstart - real contractor and weather data on the free Public tier. When you’re ready to ask questions about your own contracts and systems, talk to us about Baseline.

Note

Invited by your organisation? If a colleague sent you a Demiton invitation, you are joining your organisation’s workspace, and its plan decides what you can read. After accepting the invite and signing in with your Microsoft work account, follow the steps for your client 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) or Baseline. 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:

How do I connect Claude or ChatGPT to Demiton?

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) or Baseline. Your account tier determines which tools and data sources are available - the connection setup is identical for both.

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. ask_demiton is the headline tool: it routes any natural-language question to the right registers internally, so you do not call individual data sources as separate tools.

A tenant’s client is advertised four tools:

What tools does Ask Demiton provide?

Tool	What it does
ask_demiton	Ask a natural-language question. Demiton reads the register (or view) you name at the coordinates you supply and returns compact, cited records for your tier. Read-only.
tell_demiton	Propose a write to a connected system - queued for admin approval at HQ → Approvals - or record a fact into Civil Memory.
instruct_demiton	Trigger a Demiton platform agent, or poll a run you already triggered. Platform-only: the caller must hold platform:manage_workflows in at least one organisation.
switch_org	Change which organisation the connection answers for, when the user asks about a different organisation.

Report tools are not advertised separately: list_reports, run_report, and get_report_run are reachable through ask_demiton’s view parameter. See MCP tools for the generated record of the tool list.

On Baseline

On Baseline, 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 ask_demiton with a report view.

---

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

• Uploaded data: the MCP reads from your uploads only once they are indexed, so there is nothing to return before then. See Uploading Your Data.
• Connected systems: at least one system must be connected and synced before live data is returned. See Connecting a System.
• Wrong tier: uploads and live integrated-system data require Baseline. On the Public tier, ask_demiton returns public data only.

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 - upload contracts and estimating data to start querying
• Connecting a System - connect your ERP, field ops, and payroll systems
• API Access - programmatic access via API key (Baseline)
• Connectors overview - all systems Demiton integrates with