X Ads · MCP

X Ads MCP Server: ask Claude about your data

The Detrics MCP server gives Claude read-only access to your X Ads account. You ask in plain language and Claude answers from your live data, not a stale export.

Try it now Read Documentation

Available on the free plan: 35 queries/month, no credit card.

Ask your agent about X Ads

Build a weekly X Ads report for my client meeting

Detect anomalies in my X Ads spend over the past 14 days

Which X Ads campaigns should I pause this quarter?

What was my X Ads spend last month vs. the month before?

What you can analyze in X Ads

Campaign Analytics

Track tweet performance with impressions, engagements, and click-through rates.

Audience Targeting Insights

Monitor follower demographics and interest-based targeting performance.

Conversion Tracking

Analyze website clicks, app installs, and custom conversion events.

What Claude can see in X Ads

60 metrics and 95 dimensions, including:

campaign namebilled charge local microimpressionsclicks

Need full history and SQL? See the X Ads BigQuery connector

HOW IT WORKS

How the X Ads MCP server works

Connect X Ads once and query it in plain language.

First step

Connect your first datasource

Link any of 32+ marketing and ecommerce platforms in a couple of clicks.

Connect a source

Second step

Connect Detrics to Claude

Add Detrics as an MCP connector in Claude. Your marketing data is ready to query in plain language.

Connect to Claude

And that's it

Start talking to your data

Ask Claude for any report in plain language. It builds the dashboard from your real numbers, no hallucinations.

Try it in Claude

Build a buyer-journey dashboard from my marketing data

Buyer journey LIVE

Sessions 12,302

Checkouts 145

Purchases 55

Close rate 37.9%

Done · generated by Detrics

Technical setup for developers

Add Detrics to any MCP-compatible client using your API key from app.detrics.io/mcp:

{
  "mcpServers": {
    "detrics": {
      "command": "npx",
      "args": ["-y", "detrics"],
      "env": {
        "DETRICS_API_KEY": "dk_••••••••"
      }
    }
  }
}

Available tools include list_connections, list_accounts, list_fields, and query_marketing_data. All X Ads access is read-only.

MCP

Frequently Asked Questions

How does Claude access my X Ads data?

You connect X Ads to Detrics once. The Detrics MCP server then exposes read-only query tools that Claude can call. Claude never sees your credentials and can never modify your X Ads account.

What kind of X Ads breakdowns can Claude run?

Anything the X Ads API exposes through Detrics, including campaign performance, creative & conversions. That covers 60 metrics and 95 dimensions, over any date range your account allows.

Which AI clients are supported?

Any MCP-compatible client: Claude Desktop, Claude.ai, Claude Code, Cursor, Windsurf, and more.

How much does it cost?

MCP access is available on every Detrics plan. On the free plan it uses your 35 monthly data refreshes (the same quota as Google Sheets), no credit card required. Paid plans unlock higher quotas.

Ask your first X Ads question today

Get Started Free

*No credit card required

Works with Claude, Cursor, Windsurf & more
Read-only access, OAuth 2.0 secured
Free plan with 35 queries/month