Your analytics, inside Cursor
Ask about your site from the editor. StepMetrics is an MCP server over HTTP, so it goes in Cursor's MCP settings with a read-only key and nothing else.
Connect with one prompt
Open Connect agent in your dashboard, click Copy setup prompt, and paste it into your coding agent. It installs tracking for your framework and verifies MCP access with a real analytics query. No StepMetrics npm package is required.
Manual MCP configuration
Add this to your private ~/.cursor/mcp.json configuration, with a read key from your setup prompt:
{
"mcpServers": {
"stepmetrics": {
"url": "https://app.stepmetrics.co/mcp",
"headers": { "Authorization": "Bearer dak_..." }
}
}
} Cursor lists the twenty-eight read-only tools under the server once it connects. Ask a question in the chat and it picks the tool.
What you can ask
- Which pages lost traffic compared with last week, and where that traffic came from.
- Where mobile visitors from a given source drop out of the signup funnel.
- Whether Tuesday's spike was people or a crawler, and what was filtered.
- How this month compares with last month, and with the same month last year.
- Which of your own agents cost the most this week, and which model that was.
Twenty-eight read-only tools sit behind those questions: sites, overview, live visitors, series, top pages and sources, returning visitors, each visitor and their visits, breakdowns, conversions, funnels, event checks, the ignore list, the All sites dashboard layout, clickstream on Pro and Scale, and five over agent telemetry. The agent calls the same query functions the dashboard calls, so the two cannot disagree about a number.
What it cannot do
Nothing writes. There is no tool that creates, deletes or mints anything, and the key it takes is read scope. A site id from another account returns the same "not found" as a site that does not exist. "The model would not do that" is not a security control, so the endpoint is built so that it cannot.
Try it on your site.
Add your first site for free. See where visitors come from, what they look at, and how many take the next step.
No credit card required.