Documentation

MCP server

Connect Cursor, Claude Code, or Claude Desktop to Intently with your account API key.

Intently exposes a read-only Model Context Protocol (MCP) server so Cursor, Claude Code, Claude Desktop, and other MCP clients can query your attribution and Ask AI data with your account API key (adt_…).

No separate “MCP key” is required. Use the same API key from Settings → API Keys.

Endpoint

https://getintently.io/api/mcp

Local development: http://localhost:3000/api/mcp.

Authenticate every request with:

Authorization: Bearer adt_…, or
x-api-key: adt_…

Master keys are rejected.

Cursor

Add to your MCP config (Cursor Settings → MCP, or ~/.cursor/mcp.json):

{
  "mcpServers": {
    "intently": {
      "url": "https://getintently.io/api/mcp",
      "headers": {
        "Authorization": "Bearer adt_YOUR_API_KEY"
      }
    }
  }
}

Replace adt_YOUR_API_KEY with your key from Settings. Restart Cursor (or reload MCP) after saving.

Claude Code

claude mcp add --transport http intently https://getintently.io/api/mcp \
  --header "Authorization: Bearer adt_YOUR_API_KEY"

Or in .mcp.json / ~/.claude.json (Claude Code requires "type": "http"):

{
  "mcpServers": {
    "intently": {
      "type": "http",
      "url": "https://getintently.io/api/mcp",
      "headers": {
        "Authorization": "Bearer adt_YOUR_API_KEY"
      }
    }
  }
}

Tools (read-only)

Tool	What it returns
`get_attribution_overview`	Revenue, ROAS, closed-won, delivery snapshot
`get_attribution_summary`	Channel credit + delivery proof
`get_campaign_roi`	Campaign revenue / spend ROAS
`list_conversions`	Paginated attributed conversions
`get_attribution_readiness`	Setup checklist
`compare_attribution_models`	Cross-model comparison
`ask_intently`	Natural-language ask over analytics + attribution

Attribution tools require the marketing attribution feature on your plan. ask_intently requires Ask AI (ai_analytics).

Security notes

Tools only see your authenticated account.
v1 is read-only — no pause/scale ads or write actions.
Requests are rate-limited. Do not paste your key into public repos or chat logs.

Feature gates

If a tool returns FEATURE_REQUIRED, enable Attribution or Ask AI on your plan (or as an add-on), then retry.