Ask AI assistants like Claude and ChatGPT about your own PartialLeads data — your leads, traffic sources, pages, and revenue — in plain language. This works through a secure connection called MCP (Model Context Protocol).
Who can use this: accounts on the Pro or Agency plan (and grandfathered accounts). On other plans you can’t create keys — the card appears only if you still hold an existing key, so you can review or revoke it; otherwise it doesn’t show. Upgrade under Billing to enable key creation.
1. Create a key
- Open Settings → AI Access (rail entry “AI Access”).
- (Optional) give the key a name so you recognise it later, e.g.
Laptop — Claude. - Click Create key. Your key is shown once — copy it now and store it somewhere safe. If you lose it, revoke it and create a new one.
A key works like a password. Keep it private, never paste it into a public place, and revoke it the moment you suspect it leaked. You can keep up to 20 active keys.
2. Connect a tool
Claude Code (terminal) — works today
Run this in your terminal, replacing <token> with the key you just created:
claude mcp add --transport http partialleads https://partialleads.com/api/mcp --header "Authorization: Bearer <token>"
Then start Claude Code and ask, e.g. “show my strong-ICP leads from Meta this week.”
ChatGPT (developer mode) — works today
- In ChatGPT, open Settings → Connectors → Developer mode.
- Add a connector with:
- Server URL:
https://partialleads.com/api/mcp - Authorization header:
Bearer <token>
- Server URL:
- Save, then ask ChatGPT about your account.
Claude web & desktop apps — coming soon
One-click connection (no key to copy) is coming later via a sign-in flow. For now, use Claude Code or ChatGPT developer mode above.
3. What you can ask (the tools)
The connection is read-only — it can look things up, never change anything.
| Tool | In plain words |
|---|---|
| list_leads | Your captured leads (partial + completed), filterable by date, source, match quality, confidence. “show unmatched leads over 70% from Google last month.” |
| get_lead | Full detail on one lead, including the AI persona/enrichment and journey. |
| account_status | Your plan, how many leads you’ve used this period, and enrichment credits left. |
| revenue_summary | Ecommerce revenue over a date range — totals, orders, and per-source breakdown. |
| attribution_report | Leads, conversions, and revenue attributed by traffic source/channel. |
| pages_report | Per-page views, bounce, and conversion, with a verdict on each page. Filter by traffic source. “which pages are visitors bouncing from?” |
| sources_report | Traffic sources (Meta, Google, Direct…) with visitors, leads, and conversion vs a comparison window. |
| visitor_trends | Visitors/sessions over time by source — the daily trend. |
| live_stats | Who’s on the site right now — live count, today’s count, and a recent-visitor snapshot. |
4. Troubleshooting
- “Unauthorized” / 401 — the key is wrong or was revoked. Check for a typo
(it starts with
plmcp_) or create a fresh key in Settings → AI Access. - Empty results — usually the date range. Most tools default to the last 30 days; widen the range (e.g. “in the last 90 days”) if you expect older data.
- “Upgrade” / 403 when creating a key — MCP is a Pro/Agency feature. Upgrade under Billing to enable it.
- A source filter returns nothing —
sourcematches the exact source label (e.g.Google,Meta Ads,Direct), not a channel bucket likepaid.
To cut off a tool’s access, revoke its key in Settings → AI Access — it stops working immediately.