API & MCP server

Snorklee makes your data available to your other tools read-only: scripts, dashboards (Google Looker Studio, Excel…), and AI assistants (Claude, Cursor and any MCP client). Your tools read your numbers, they change nothing. Everything goes through a personal API key — never through your password. API & MCP access is included in the Snorklee One subscription, and active during the 14-day free trial.

#Creating a key

In Integration → API & MCP: name the key (the tool that will use it), click Create a key, then copy it right away — it's never shown again; on our side we keep only its fingerprint, not the key itself. A key can be revoked in one click, effective immediately; you can have 10 active at once.

What a key can do: read your sites and their stats — KPIs, top pages, the AI traffic funnel and AI presence. What it can't do: change anything, or read data from a site you don't own.

#The REST API

Add the Authorization: Bearer snk_… header to your requests:

GET /api/v1/sites
GET /api/v1/sites/{id}/kpis?range=28d
GET /api/v1/sites/{id}/top-pages?range=28d&limit=20
GET /api/v1/sites/{id}/ai-funnel?range=28d
GET /api/v1/sites/{id}/ai-presence?range=28d

Responses are JSON, in a { data, meta } envelope. range is one of 7d, 28d, 90d (default 28d); an optional tz sets the timezone (IANA name, default Europe/Paris). Limit: 1,000 requests per hour per key.

#The MCP server

The Model Context Protocol lets an AI assistant query your Snorklee data on your behalf: you ask your question in plain language, and the assistant fetches the answer from your numbers. Paste this configuration into Claude, Cursor or any MCP client, replacing snk_… with your key:

{
  "mcpServers": {
    "snorklee": {
      "type": "http",
      "url": "https://snorklee.com/mcp",
      "headers": { "Authorization": "Bearer snk_…" }
    }
  }
}

The assistant gets five read-only tools: list_sites, then get_kpis, get_top_pages, get_ai_funnel and get_ai_presence. Call list_sites first for a site id, then pass it as site_id with an optional range.

#Reporting

For a report without writing a single line of code: every dashboard card has a CSV export button, and the global export (button at the top of the Analytics tab) downloads a complete ZIP, category by category. These files import as-is into Google Looker Studio, Excel or any spreadsheet.

#Sovereignty

The MCP server and the API are built and hosted by Snorklee, in the European Union, with no SDK and no third-party service: your data goes through no intermediary.