API & MCP server

Snorklee exposes your data read-only to your other tools: scripts, dashboards (Google Looker Studio, Excel…), and AI assistants (Claude, Cursor and any MCP client). Everything goes through a personal API key — never through your password. API & MCP access is included in the Snorklee One subscription.

#Creating a key

In Integration → API & MCP: name the key (the tool that will use it), click Create a key, and copy it immediately — it will never be shown again; only its fingerprint is stored on our side. A key can be revoked in one click, effective immediately; you can have 10 active ones.

What a key can do: read your sites and their analytics — KPIs, top pages, the AI traffic funnel and AI presence. What it cannot do: modify 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, { 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. 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 no-code report: 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, without any SDK or third-party service: your data goes through no intermediary.