supapulseMCP server
Let Claude Code, Cursor and other AI agents read your Supapulse analytics through the Model Context Protocol.
https://supapulse.app/api/mcpSupapulse runs an MCP server, so you can ask your coding agent things like "how did the launch post do this week?" and get real numbers. It reads the same data as the stats API and can't change anything.
Connect
Create an API key in Team settings → API keys, then add the server to your client.
Claude Code
claude mcp add --transport http supapulse https://supapulse.app/api/mcp \
--header "Authorization: Bearer pls_your_key"Cursor, in .cursor/mcp.json or ~/.cursor/mcp.json:
{
"mcpServers": {
"supapulse": {
"url": "https://supapulse.app/api/mcp",
"headers": { "Authorization": "Bearer pls_your_key" }
}
}
}Other clients: use the Streamable HTTP transport with the URL above and the Authorization header. The server is stateless and answers with plain JSON.
Tools
| Tool | What it returns |
|---|---|
list_sites | The sites the key can read. |
get_stats | Visitors, pageviews, sessions, bounce rate and duration, against the previous range. |
get_timeseries | Visitors and pageviews per day. |
get_breakdown | Top pages, sources, referrers, campaigns, countries, devices, browsers, OS, events, outbound links or downloads. |
get_goals | Goals with visitors, conversion rate and revenue. |
get_funnels | Funnels with conversion, drop-off and revenue per step. |
get_revenue | Revenue, transactions, refunds and MRR. |
get_seo_search | Google Search Console clicks, impressions, CTR and position, with the top queries, landing pages and ranking opportunities. |
get_seo_audit | The latest site audit: health score, and each issue with the pages it affects. |
get_journey | The pages visitors saw in the 3 steps before and after a page. Pass next or previous to follow one path. |
Every tool except list_sites takes a site domain. Most also take an optional range: period (today, 7d, 30d, 90d, 365d) or start_date and end_date. Two are different:
get_seo_searchtakes Search Console's own periods:7d,28d(the default),90dor12m. It needs Search Console connected on the site.get_seo_audithas no range. It returns the latest finished site audit.
Things to ask
- "Which pages brought the most visitors to example.com last week?"
- "Compare this month's revenue with last month and tell me which sources drove it."
- "Where do people drop off in the signup funnel?"
- "Did the launch post on the 3rd change signups?"
- "Which search queries are close to page one, and what should I change on those pages?"
- "Fix the errors from the latest site audit."
- "Where do visitors go after the pricing page?"
Security
- A key reads every site in its team. Create one key per agent or machine, so you can revoke just that one.
- Agents send tool results to their model provider. Only connect Supapulse to agents you'd share these numbers with.
- Keys are limited to 120 requests a minute.