Skip to main content

​
Overview

The MCP Data Connector is a read-only MCP server for your ChatAds widget data - usage, conversation transcripts, and inline-link clicks. It makes no changes to your account: no settings, no keys, no billing. Point any MCP-compatible client (Claude, Cursor, etc.) at it and ask questions about your widget’s performance in plain language.
Looking for product extraction or matching rather than your own widget data? That’s a separate MCP server, using a team access key (cak_...): Commerce Extract pulls scored product and purchase-intent mentions out of any text you send it, Commerce Match turns a product phrase into a shoppable link, and Commerce Insert does both at once on a full AI reply.

​
Get Your Key

The connector authenticates with your MCP Data Connector Key (uk_...), a personal key rather than a team key - see Your Account for how it’s managed.
  1. Log into app.getchatads.com
  2. Open Account
  3. In the MCP Data Connector Key card, click Create MCP Data Connector Key (or Show if you already have one)
If you created your key before this feature launched, reveal it once (or reset it) on the Account page - that’s what registers it for MCP lookups. New keys work immediately.

​
Connect

In Claude Code it’s one command. Most other clients (Claude Desktop, Cursor, Windsurf, etc.) take the JSON block - drop the transport field if your client rejects it:
Restart your MCP client and it’s ready to go.

​
Tools

All three also accept an optional team_id parameter - you only need to pass it if your account belongs to more than one team. If you do, the tool tells you your team IDs and names so you can pick one.

​
Response Fields

All responses arrive as JSON with the payload under data. Each tool always includes your team_id; an empty array is a success (no data in the range), not an error. chatads_widget_usage also returns team_name, widget_plan_tier, and daily_chat_limit: chatads_widget_conversations returns a sessions array: chatads_widget_clicks returns a clicks array by default, or a summary when group_by is set:

​
Limits

  • A per-user rate limit applies across all three tools, separate from any team’s ChatAds plan limits.
  • Conversations and clicks are retained 90 days (the same purge schedule as the dashboard).
  • Data mirrors what you’d see in the dashboard’s Conversations tab and Click Log Export - this connector doesn’t compute anything new, it just makes that data queryable from your MCP client.

​
Troubleshooting

​
”Widget data tools require a uk_ user key”

You connected with a team API key (cak_...). The widget-data tools only accept an MCP Data Connector Key (uk_...) - create one on the Account page.

​
”Your account belongs to multiple teams”

Pass the team_id from the error message as an argument to the tool call.

​
Tool not appearing in your MCP client

  1. Verify the URL is exactly: https://api.getchatads.com/mcp/mcp
  2. If your client’s config uses a transport field, it should be "http"
  3. Restart your MCP client completely
  4. Ask: “What tools do you have access to?”