MCP Server (Claude, Cursor…)

DURUM's MCP server plugs your data directly into your AI assistant. You ask in natural language — "What was my ROAS last month?", "Summarize the scorecards of my calls with jean@example.com" — and the assistant queries your DURUM account read-only.

It's a thin wrapper over the REST API: your key carries your account and scopes, so every tool is automatically limited to your data.

There are two ways to connect DURUM.

Option A — DURUM Connector (recommended, OAuth)

A remote MCP server with "Sign in with DURUM" — nothing to install.

1. In Claude (or any connector-compatible client), add a connector with the URL: https://app.durum.ai/mcp
2. A DURUM page opens: log in and authorize access (read-only, you pick the permissions).
3. Done — DURUM tools appear.

Access is revocable anytime in Settings → API keys. No key to copy: auth is done through your DURUM account (OAuth 2.1 + PKCE).

Option B — Local via API key (developers)

For Claude Desktop/Code or Cursor with manual config using an API key:

1. Create a key — see Authentication.
2. Add to your MCP client config:

{
  "mcpServers": {
    "durum": {
      "command": "npx",
      "args": ["-y", "@durum/mcp"],
      "env": { "DURUM_API_KEY": "durum_sk_live_YOUR_KEY" }
    }
  }
}

Restart the client — DURUM tools appear.

3. Ask away

"What was my ROAS last month, and which campaign drove the most attributed revenue?"

"Show my funnel conversion by source for the last 30 days."

"Summarize the scorecards of my calls with jean@example.com."

Available tools

Tool	Scope	Returns
get_dashboard_kpis / _daily / _breakdowns	read:dashboard	KPIs
get_ad_spend / get_ad_campaigns	read:ads	Spend & performance
get_attribution / get_attribution_health	read:attribution	Multi-touch attribution
get_events / get_events_summary	read:events	CRM events
get_sales_summary	read:sales	Sales KPIs
get_finance_pnl	read:finance	P&L (margins not exposed)
get_funnel	read:funnel	Funnel & conversion
get_contacts / get_contact_calls	read:contacts / read:calls	Contacts & calls
get_icp_criteria	read:icp	ICP criteria
get_capi_health	read:capi	Conversion health
get_health_scores / get_goals	read:health / read:goals	Health & goals

A tool returns insufficient_scope if your key doesn't include its scope — mint a new key with the scopes you need.

Configuration

• DURUM_API_KEY (required) — your API key.
• DURUM_API_BASE (optional) — defaults to https://app.durum.ai/api/v1.