RankedByAI ships a built-in Model Context Protocol server, so AI assistants like Claude and editors like Cursor can query your visibility data directly — “what are my biggest citation gaps this week?” becomes a question you ask your assistant.

Endpoint: https://rank.zalize.com/mcp (streamable HTTP transport)

Authentication

The MCP server uses the same workspace API keys as the REST API. Create one in Dashboard → Settings → API keys and pass it as a Bearer token.

Available tools

All tools are read-only and take no arguments — the API key already identifies your workspace.

| Tool | Returns |
| --- | --- |
| get_visibility | Latest grade, mention rate, citation funnel, platforms and week-over-week comparison. |
| list_prompts | The tracked buyer questions your weekly scans ask, with tags and status. |
| get_sources | Domains AI answers cited in the latest scan. |
| get_gaps | Citation gaps — URLs citing competitors while your brand is absent. |

Connect from Claude Desktop

Add to your claude_desktop_config.json (requires a streamable-HTTP-capable bridge such as mcp-remote):

``json
{
"mcpServers": {
"rankedbyai": {
"command": "npx",
"args": [
"mcp-remote",
"https://rank.zalize.com/mcp",
"--header",
"Authorization: Bearer rk_your_api_key"
]
}
}
}
``

Connect from Cursor

In Cursor settings → MCP, add a server with type streamableHttp:

``json
{
"mcpServers": {
"rankedbyai": {
"url": "https://rank.zalize.com/mcp",
"headers": { "Authorization": "Bearer rk_your_api_key" }
}
}
}
``

Protocol details

  • Transport: streamable HTTP — each POST /mcp carries one JSON-RPC 2.0 message and receives one JSON response. Notifications are acknowledged with 202.
  • Protocol version: 2025-03-26.
  • Rate limit: shared with the REST API — 60 requests per key per minute.
  • Errors follow JSON-RPC conventions (-32601 unknown method, -32602 unknown tool, -32700 parse error).

Security

The MCP server exposes exactly the same read-only data as the REST API — nothing can be changed through it. Treat API keys like passwords: don't commit them, and revoke any key that leaks from Settings → API keys.