Quickstart

Create an MCP token

Log in to Atribu
Go to Developer in the sidebar
Switch to the MCP Tokens tab
Click New token
Select at least the Read analytics scope
Copy the token

Save your token

The token starts with atb_user_ and is shown only once. Store it somewhere secure.

Connect your AI tool

Terminal

claude mcp add atribu --transport http \
  https://mcp.atribu.app/mcp \
  --header "Authorization: Bearer atb_user_YOUR_TOKEN"

Add to your Cursor MCP settings (.cursor/mcp.json):

.cursor/mcp.json

{
  "mcpServers": {
    "atribu": {
      "url": "https://mcp.atribu.app/mcp",
      "headers": {
        "Authorization": "Bearer atb_user_YOUR_TOKEN"
      }
    }
  }
}

Add to your Claude Desktop config (claude_desktop_config.json):

claude_desktop_config.json

{
  "mcpServers": {
    "atribu": {
      "url": "https://mcp.atribu.app/mcp",
      "headers": {
        "Authorization": "Bearer atb_user_YOUR_TOKEN"
      }
    }
  }
}

Any MCP client that supports Streamable HTTP transport works. Configure it with:

URL: https://mcp.atribu.app/mcp
Transport: Streamable HTTP
Auth header: Authorization: Bearer atb_user_YOUR_TOKEN

Try it out

Open your AI tool and ask a question about your ad performance:

What's my ROAS this month? Which campaigns are performing best?

The AI tool will automatically call the right Atribu tools and return a narrative answer grounded in your real data.

Workspace resolution

If you belong to multiple workspaces, the AI tool will ask you to specify which one. If you have only one workspace with one profile, it's selected automatically.

Verify the connection

You can verify the MCP server is reachable:

Health check

curl https://mcp.atribu.app/health/live

Response

{ "status": "ok" }

Example conversation

Here's what a typical interaction looks like in Claude Code:

You: What happened to our ad performance last week vs the week before?

Claude: I'll compare the two periods for you.

[calls compare_periods with last week vs prior week]

Your ad performance improved last week:
- Spend: $2,450 → $2,680 (+9.4%)
- Revenue: $8,200 → $11,400 (+39.0%)
- ROAS: 3.35 → 4.25 (+26.9%)
- Conversions: 42 → 58 (+38.1%)

The jump in revenue is driven primarily by "Summer Sale - Retargeting"
which generated $4,200 in attributed revenue at a 6.8x ROAS.

Data as of: 2026-04-14T18:30:00Z | Model: last_touch | Currency: USD

Next steps

Authentication

Token scopes, rate limits, and usage metering

Available Tools

All 13 tools with parameters and examples

Privacy & PII

How PII masking works and how to configure it