Developers

Diald MCP server

Diald exposes its full deal platform over the Model Context Protocol. Connect it to Claude, ChatGPT, Cursor, or any MCP client and work your deals in natural language: create a property from an address, upload the OM, kick off analyses, and interrogate the proforma — all backed by the same engine as the Diald web app.

Endpoint https://YOUR-DIALD-HOST/api/mcp (Streamable HTTP)

Auth OAuth 2.1 (sign-in flow, used automatically by Claude and ChatGPT) or a Diald API key from Settings → API Keys sent as a Bearer token. The tool list is public — any client can connect and browse the available tools without signing in — but calling a tool requires a linked Diald account (or an API key): unauthenticated calls return an authentication challenge that prompts the client to start the sign-in flow.

Connect from Claude

  1. Open Settings → Connectors → Add custom connector.
  2. Enter the endpoint URL above and click Add.
  3. Claude discovers Diald's OAuth server automatically — click Connect, sign in to Diald, and approve access.

Connect from ChatGPT

  1. Enable Settings → Apps & Connectors → Advanced → Developer mode.
  2. Choose Create app, paste the endpoint URL, and select OAuth authentication.
  3. Sign in to Diald and approve access when prompted.

Connect from Cursor (or any MCP client)

Add this to mcp.json, using an API key if you prefer not to use the OAuth flow:

{
  "mcpServers": {
    "diald": {
      "url": "https://YOUR-DIALD-HOST/api/mcp",
      "headers": { "Authorization": "Bearer diald_sk_..." }
    }
  }
}

Available tools

Account & portfolio

  • listProperties — Find properties by name or address; returns the ids every other tool needs.
  • getTokenBalance — Check your remaining Diald token balance.
  • queryPortfolio — Ask questions across your whole portfolio.

Deal lifecycle

  • createProperty — Create a deal with the same intake as the web onboarding (asset class, plan, physical facts) and auto-start the free setup analysis. Tells the agent exactly which facts are still missing.
  • uploadDocument — Upload an OM, rent roll, or ARGUS/STAR export — extraction feeds the proforma automatically.
  • runAnalysis — Start the NIR data layer (unlock-nqs), DIALD analyses (unlock-diald), or the memo PDF.
  • getPipelineStatus — Track analysis progress per level (setup, NIR, findings, proforma, memo).
  • listComps — List the sales or rent comps NIR collected, with selection state and Diald’s suggested picks.
  • setCompSelection / confirmCompSelection / unlockCompSelection — Curate and lock in the comp set for each side — confirming both sides is what unlocks DIALD.

Underwriting & analysis

  • getProformaMetric / getCellValue / setCellValue — Read and update proforma assumptions and computed returns.
  • runScenario / runSensitivity / solveForTarget — Stress assumptions, build sensitivity tables, back-solve for target returns.
  • analyzeAssumptions / flagGuardrails / reconcileFindings / getTopFindings — Sanity-check assumptions against market data and research findings.
  • generateMemo / generateLOI / generateChart / shareProperty — Produce deliverables and share deals.

Tokens & security

  • Tool calls spend tokens from your Diald balance — the same pricing as the web app. Ask the agent to check getTokenBalance before expensive unlocks.
  • OAuth connections are scoped: diald:read for analysis, diald:write for changes (creating properties, editing assumptions, uploads).
  • Revoke a connection anytime from the client's settings, or rotate your API key in Diald settings — access dies immediately.