MCP Data Connector

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.

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.

Log into app.getchatads.com
Open Account
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

Add the connector to your MCP client’s configuration:

{
  "mcpServers": {
    "chatads-widget": {
      "url": "https://api.getchatads.com/mcp/mcp",
      "transport": "http",
      "headers": {
        "x-api-key": "uk_your_user_key"
      }
    }
  }
}

Restart your MCP client and it’s ready to go.

Tools

Tool	Params	What it returns
`chatads_widget_usage`	`start_date`, `end_date` (`YYYY-MM-DD`, default: last 30 days ending today)	Daily message/page-load/click counts for the range, plus your widget plan tier and daily chat limit
`chatads_widget_conversations`	`limit` (default 25, max 1000), `session_id` (fetch one full session by UUID), `max_message_chars` (default 300, `0` = full text)	Recent chat transcripts, grouped by session, newest first; a `truncated` flag signals more sessions exist
`chatads_widget_clicks`	`limit` (default 200, max 2000), `start_date`/`end_date` (`YYYY-MM-DD`, within the last 90 days), `group_by` (`day`\|`source`\|`page` — returns per-key counts instead of rows), `include_href` (default false)	Inline affiliate-link click events from the last 90 days, with a `source` label (Amazon, Skimlinks, CJ, etc.)

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.

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

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

Verify the URL is exactly: https://api.getchatads.com/mcp/mcp
Check that transport is set to "http"
Restart your MCP client completely
Ask: “What tools do you have access to?”

Getting Started

Integrations

Configuration

Monetization

Analytics & Data

Trust & Performance

Account

Troubleshooting

MCP Data Connector

Overview

Get Your Key

Connect

Tools

Limits

Troubleshooting

”Widget data tools require a uk_ user key”

”Your account belongs to multiple teams”

Tool not appearing in your MCP client

​Overview

​Get Your Key

​Connect

​Tools

​Limits

​Troubleshooting

​”Widget data tools require a uk_ user key”

​”Your account belongs to multiple teams”

​Tool not appearing in your MCP client

Overview

Get Your Key

Connect

Tools

Limits

Troubleshooting

”Widget data tools require a uk_ user key”

”Your account belongs to multiple teams”

Tool not appearing in your MCP client