Skip to content
Developers Beta

Your numbers, anywhere you need them

The REST API and the MCP server expose the same 21 operations, run the same code and return the same numbers as the dashboard. Available on every plan, in beta.

Get an API key OpenAPI document
REST · https://data.convultra.com/v1
curl -s https://data.convultra.com/v1/me \
  -H "Authorization: Bearer sk_your_key_here" | jq
MCP · https://mcp.convultra.com/mcp
{
  "mcpServers": {
    "convultra": {
      "url": "https://mcp.convultra.com/mcp",
      "headers": { "Authorization": "Bearer sk_your_key_here" }
    }
  }
}
API and MCP reference
API overview Getting started with the Convultra REST API and MCP server, authentication, sk_ versus proj_ keys, response shape, rate limits and caching. 9 min API scopes Every scope on the Convultra API and MCP server, the consent sentence a user approves, what it covers and which operations it unlocks. 4 min API operations All 21 operations on the Convultra API and MCP server, grouped by the question they answer, with every trap that would make a figure misleading. 14 min Date ranges and timezones Range presets, explicit dates, the 400-day cap, half-hour timezones, compare, and which operations still bucket on UTC days. 4 min API errors Every error code the Convultra API and MCP server return, what causes it, and what to do about it. 7 min Privacy and redaction in the API The fields the Convultra API strips from every payload, the geography floor, path-only URLs, and what conversion rows deliberately do return. 4 min Metric definitions and the figures that are easy to misread Conversion rate over visitors, null versus zero, AI referrals versus crawlers, rates as ratios, and Convultra's definition of every headline metric. 5 min The MCP server What the Convultra MCP server is, the 21 tools, the three prompts, how authentication works, and what to expect once an assistant is connected. 6 min Connect Claude to Convultra Add the Convultra MCP server to Claude.ai as a custom connector in three clicks, or to Claude Code with one command. 4 min Connect ChatGPT, Cursor and your own agents How to connect the Convultra MCP server from ChatGPT with OAuth, from Cursor with an sk_ key, and from your own agent with JSON-RPC. 4 min API keys and agency access Creating, scoping, expiring and revoking sk_ keys, who a key belongs to, the visibility rule, agency-wide keys and read-only viewers. 5 min
Tracking and install
Developer overview The browser SDK, the tracking endpoint, the REST API and the MCP server at a glance, with install methods and the architecture. 3 min Tracking conversions Method reference for trackPurchase, trackLead, trackSignup, trackSubscription, trackDownload, trackContact, trackSchedule and trackConversion. 6 min E-commerce events Track the shopping funnel with trackViewContent, trackAddToCart, trackAddToWishlist, trackBeginCheckout, trackAddPaymentInfo and trackSearch. 5 min Enhanced conversions in the SDK Four ways to attach customer data to conversions with enhance(), trackConversion userData, the trackEnhanced methods and setEnhancedUserData(). 6 min
Conversion rate is over visitorsNever sessions. A tool that divides by sessions will always show Convultra lower; the gap is a definition, not an error.
null is not zeroA null spend, ROAS or CPA means the integration is not connected. Report it as unavailable, never as 0.
Check tracking health firstA tracking outage and a bad week look identical in the numbers. Call get_tracking_health before drawing a conclusion.