MCP Server

Pieowl runs an MCP (Model Context Protocol) server. It lets AI assistants like Claude, Cursor and Windsurf query your analytics data right in the conversation. This is how you ask questions about your data: there is no chat inside Pieowl. The server is hosted, so there is nothing to install, and it shows up in your client as Pieowl.

Endpoint

https://api.pieowl.com/mcp

Authentication

Pass the token in an Authorization header:

Authorization: Bearer YOUR_TOKEN

If your client can't set headers, pass it as a query parameter instead:

https://api.pieowl.com/mcp?token=YOUR_TOKEN

Both work. Prefer the header: query strings end up in browser history, shell history and proxy logs, so a token in the URL is easier to leak by accident.

Token format

The token is your client ID and client secret, joined by a colon and base64-encoded:

base64(clientId:clientSecret)

From the dashboard

The easiest way to get your MCP token is from the dashboard, no terminal needed:

• AI assistants — in Settings → Developers → AI assistants, pick your client (Claude Desktop, Claude Code, Cursor, Windsurf, VS Code or Raycast) and click Create token. Pieowl makes a read-data key for the site and puts the token straight into a ready-made config. Copy it right away: it is shown only once.
• New key — when you create a read-data key in Settings → Developers → Keys, the success screen shows a Token for AI assistants field ready to copy. Use Download to save your key ID, secret and token as credentials.txt.

From the terminal

echo -n "YOUR_CLIENT_ID:YOUR_CLIENT_SECRET" | base64

Then send it with every request:

Authorization: Bearer <base64-encoded-token>

Or, for clients that can't set headers, add it to the MCP URL:

https://api.pieowl.com/mcp?token=<base64-encoded-token>

Required client type

Only read and root clients can use MCP. Write-only clients are rejected.

Use a read client to limit the AI assistant to one site. Use a root client if you need access across sites or want to list all sites.

Create keys in Settings → Developers in your dashboard. See the Authentication guide for details.

Connecting to Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "pieowl": {
      "type": "streamable-http",
      "url": "https://api.pieowl.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

If your client doesn't read headers, drop that block and put the token in the URL instead: "url": "https://api.pieowl.com/mcp?token=YOUR_TOKEN".

Connecting with Claude Code CLI

Use the --header flag to pass the token as Authorization: Bearer:

claude mcp add --transport http pieowl https://api.pieowl.com/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Or with the token in the URL:

claude mcp add --transport http pieowl "https://api.pieowl.com/mcp?token=YOUR_TOKEN"

Connecting to Cursor

Add this to ~/.cursor/mcp.json (global) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "pieowl": {
      "url": "https://api.pieowl.com/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

For other clients, copy the config from Settings → Developers → AI assistants in your dashboard.

Available tools

Site access

Dashboards & reports

Dashboard management (root clients)

Discovery

Events & sessions

Profiles (users)

Groups (B2B)

Aggregated metrics

User behavior

Google Search Console

These tools need Google Search Console connected for the site. Connect it in the dashboard on the Google search page.

Rate limiting

60 requests per minute, counted per IP address.