MazeRank Agents

Ask your AI about your AI visibility. An MCP server for ChatGPT, Claude and Cursor.

Connect MazeRank to the assistant you already use. Ask how often AI recommends you, who it picks instead, and what changed this week. Answers come from your real tracking data.

01What it is

Your AI visibility data, inside your AI.

MazeRank Agents is an MCP connector. MCP (Model Context Protocol) is the open standard AI assistants use to call outside tools, so your assistant can read your MazeRank data and answer questions about it.

  • —Works with any MCP client
  • —Same data as your dashboard
  • —No copying CSVs into chats
Claude · MazeRank connected
How did Dental Studio do in AI answers this month, and who's beating us?
02Tools

Seven read-only tools.

Sites, mention rates, per-engine breakdowns, competitors, raw AI answers, alerts and reports. The assistant picks the right tool for each question.

  • —Each tool maps to one API scope
  • —Tools hidden when a key lacks the scope
  • —Every tool is marked read-only
MCP reference
tools/list · 7 read-only tools
readOnlyHint: true · filtered by your key's scopes
03Setup

Paste one URL and a key.

Create a key under Account settings → API & MCP, then add the server to your client. It's a streamable HTTP endpoint, so there's nothing to install.

  • —Cursor, Claude Code, Claude Desktop
  • —OpenAI Responses API and Agents SDK
  • —Any client that supports remote MCP
~/.cursor/mcp.json
// ~/.cursor/mcp.json
{
"mcpServers": {
"mazerank": {
"url": "https://clever-curlew-385.convex.site/mcp",
"headers": { "Authorization": "Bearer lr_YOUR_KEY" }
}
}
}
04Security

Read-only keys you control.

Keys can only read. Pick exactly which scopes a key gets, see when it was last used and revoke it in one click.

  • —Keys shown once and stored hashed
  • —Scoped per data type
  • —120 requests per minute per key
Account · API & MCP
New key
Claude desktop
Scopes
sitesratesenginescompetitorsanswersalertsreports

Example prompts

“How did my mention rate change over the last 8 weeks?”

Calls get_mention_rates with weeks: 8 and summarises the trend: “Up from 31% to 42%, with the biggest jump in week 40.”

“Which AI engine recommends us least?”

Calls get_engines: “Claude names you in 18% of answers versus 55% on Perplexity. Start there.”

“Who does ChatGPT recommend instead of us?”

Calls get_answers with engine: chatgpt and get_competitors, then lists the businesses named in the answers where you weren't.

“Draft a client update from this week's alerts.”

Calls get_alerts and get_reports, then writes a short email with the PDF link.

Set up in three steps

  1. 1. In MazeRank, open Account → API & MCP and create a key with the scopes you want.
  2. 2. Add the server URL https://clever-curlew-385.convex.site/mcp to your client with the key as a bearer token.
  3. 3. Ask: “List my MazeRank sites.”
Cursor
// ~/.cursor/mcp.json
{
  "mcpServers": {
    "mazerank": {
      "url": "https://clever-curlew-385.convex.site/mcp",
      "headers": { "Authorization": "Bearer lr_YOUR_KEY" }
    }
  }
}
Claude Code
claude mcp add --transport http mazerank \
  https://clever-curlew-385.convex.site/mcp \
  --header "Authorization: Bearer lr_YOUR_KEY"
Claude Desktop
// claude_desktop_config.json
{
  "mcpServers": {
    "mazerank": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://clever-curlew-385.convex.site/mcp",
               "--header", "Authorization:Bearer ${LR_KEY}"],
      "env": { "LR_KEY": "lr_YOUR_KEY" }
    }
  }
}
ChatGPT models (OpenAI Responses API)
// OpenAI Responses API (ChatGPT models)
const res = await openai.responses.create({
  model: "gpt-5",
  tools: [{
    type: "mcp",
    server_label: "mazerank",
    server_url: "https://clever-curlew-385.convex.site/mcp",
    headers: { Authorization: "Bearer " + process.env.LR_KEY },
    require_approval: "never",
  }],
  input: "Which competitors beat us in AI answers this week?",
});

MCP questions

What is an MCP server?

A server that exposes tools over the Model Context Protocol so AI assistants like Claude, ChatGPT and Cursor can call them. MazeRank's MCP server exposes your AI visibility data.

Can the assistant change anything in my account?

No. Every tool is read-only and keys can only read data.

Which clients are supported?

Any client that supports remote (streamable HTTP) MCP servers with a bearer token, including Cursor, Claude Code, Claude Desktop through mcp-remote, and the OpenAI Responses API.

Do agencies get all their clients?

Yes. An agency key can read every client site on the account. Start with list_sites.

Is it included in my plan?

Yes. API and MCP access come with your account at no extra charge.

Give your assistant the numbers.

Create a read-only key and connect it in under a minute.