Analytics MCP server

Overview

The server speaks MCP over HTTP at https://www.webtoapp.guru/api/mcp and authenticates with an API token sent as a bearer credential. Any MCP client that supports remote HTTP servers can use it.

Get a token

Tokens are issued in the dashboard under Settings → MCP. The secret is shown once, at creation time; if you lose it, revoke the token and issue a new one.

Connect a client

For Claude Code, run this in your terminal, replacing YOUR_TOKEN with the secret you copied:

claude mcp add --transport http webtoapp-guru https://www.webtoapp.guru/api/mcp --header 'Authorization: Bearer YOUR_TOKEN'

For Claude Desktop, Cursor and other clients, add the server to the client's MCP config file:

{
  "mcpServers": {
    "webtoapp-guru": {
      "type": "http",
      "url": "https://www.webtoapp.guru/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Restart the client afterwards: the header is read when the connection opens, so a running client keeps using the old token.

Tools

Each tool is documented with its parameters on its own page. Start with list_funnels: the funnel ids it returns are required by the other tools.

What the numbers mean

Every figure is computed strictly inside the requested range. The same visitor counted as new in one window can be counted as returning in another — that is by design, not a bug.

• visits — distinct sessions (arrivals). This is NOT the number of screen views: one visitor moving through five screens is one visit.
• uniqueVisitors — distinct identified visitors inside the range.
• returningVisitors — visitors with two or more visits inside this range.
• newVisitors — visitors seen for the first time inside this range.
• unknownVisits — visits with no identified visitor. They are counted in visits but NOT in uniqueVisitors, so visits can exceed the sum of new and returning visitors.

Limitations

• Read-only: there are no tools that create, edit or delete funnels.
• A date range longer than 366 days is rejected.
• An unknown funnelId returns zeros rather than an error — check the id against list_funnels if the numbers look empty.
• Data covers published funnels' traffic only; editor previews are not tracked.
• One token maps to one account; it cannot be shared across accounts.

Troubleshooting

• Every call fails with an authorization error — the token was revoked or mistyped. Issue a new one and reconnect the client.
• The client still uses an old token after you changed it — claude mcp add does not overwrite an existing entry. Run claude mcp remove webtoapp-guru first, then add it again.
• The server does not appear at all — restart the client, then check claude mcp list.
• All numbers are zero — verify the funnel id with list_funnels and confirm the date range covers days when the funnel was published.