MCP

Use PerchLens from Claude Desktop

Ask Claude "how's my site doing today?" and get a real answer with numbers. PerchLens ships a Model Context Protocol (MCP) server that lets AI assistants query your live analytics directly.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json on macOS (or the Windows equivalent) and merge:

claude_desktop_config.json

{
  "mcpServers": {
    "perchlens": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://perchlens.com/api/mcp",
        "--header",
        "Authorization:Bearer cvk_YOUR_API_KEY"
      ]
    }
  }
}

Swap cvk_YOUR_API_KEY for a real key from Settings → API keys, then restart Claude Desktop. It'll pick up the server and expose the tools below.

Cursor / other MCP clients

Any MCP-capable client with HTTP transport works. Add to your client's MCP config:

mcp-config.json

{
  "mcpServers": {
    "perchlens": {
      "url": "https://perchlens.com/api/mcp",
      "headers": {
        "Authorization": "Bearer cvk_YOUR_API_KEY"
      }
    }
  }
}

Exposed tools

These are the tool names your AI assistant can call. All require a tracking_id except list_sites.

list_sitesList all PerchLens sites owned by the authenticated user.

get_overviewVisitors / sessions / pageviews / conversion rate for a site.

top_pagesTop-performing pages.

top_sourcesTop traffic sources — search, social, AI engines, direct.

ai_trafficAI engine breakdown (ChatGPT, Claude, Perplexity, Gemini, Copilot, Phind).

realtime_visitorsHow many visitors are on the site right now.

Try asking

"How's perchlens.com doing this week?"
"Which AI engine is sending me the most traffic?"
"What's my top page right now?"
"How many people are on my site at this moment?"