Introduction

What is the Ranketta MCP server?

The Ranketta MCP server exposes your workspace data to AI clients through the Model Context Protocol (MCP). Once connected, a client like Claude Desktop or Cursor can query your Ranketta workspace directly and act on it, in the same conversation you're already having.

With it connected, you can ask a client to:

• pull visibility, position, and sentiment stats for any prompt or website
• inspect citation domains, URLs, and fan-out queries
• review and kick off site audits
• manage prompts, topics, and competitors
• create and act on opportunities
• generate or optimize content
• pull Shopping catalogue health, best sellers, and product detail

The full list of available tools, grouped by area, is on the Available tools page.

How it works

1. Connect: add Ranketta as a remote MCP server in your client.
2. Authenticate: sign in with your Ranketta account and authorize the client.
3. Ask: query and act on your workspace data in plain language, for example "What's my visibility trend on ChatGPT this month?" or "Start a site audit for ranketta.com."

Connection details

Authentication

Ranketta MCP uses OAuth 2.0. When you connect a client, you sign in with your Ranketta account and authorize that client to access your workspace data. Access always follows your existing role and module permissions, so a client can't see or do more than you can in the Ranketta app itself.

Setup steps

1. Open mcp.ranketta.com.
2. Choose the client you want to connect (for example, Claude Desktop or Cursor).
3. Copy the recommended server configuration for that client.
4. Add a new remote MCP server in your client and paste the configuration.
5. Complete the Ranketta OAuth login and authorization flow.
6. Validate the connection with a test query, for example "List my prompts."

Suggested first prompts

• "List my top prompts by visibility from the last 30 days."
• "Show citation domains with the highest usage rate in the last 30 days."
• "What share of my citations are editorial vs UGC domains?"
• "Start a site audit for my website and tell me the top issues once it's done."
• "Which competitors am I not tracking yet?"
• "Show my Shopping best sellers this month."

Troubleshooting

• If authorization fails, reconnect the MCP server and repeat the OAuth flow.
• If results come back empty, verify that the active website context in your client matches the workspace you expect.
• If access is denied for a tool, check your Ranketta role and module permissions for that area.

FAQ

Is my Ranketta data shared with the AI provider I connect through MCP (e.g. Claude Desktop, Cursor)?
The client you connect accesses your Ranketta data through the authorized MCP connection in order to answer your questions. Access is scoped to whatever you authorize during the OAuth flow, nothing more.

Can multiple team members connect their own MCP client to the same Ranketta workspace?
Yes. Each person authorizes the connection with their own Ranketta account, and their existing role and module permissions apply.

Can a client change my Ranketta data through MCP, or only read it?
Both. Most tools are read-only lookups (prompts, citations, fan-out, site audit results, sentiment), but some let a client take action on your behalf within your permissions, for example starting a site audit, creating a prompt or competitor, or completing an opportunity. See Available tools for which is which.