MCP Server Integration
What is the Ranketta MCP Server?
The Ranketta MCP Server lets AI clients access your Ranketta data through the Model Context Protocol (MCP).
With MCP, you can ask tools like Claude Desktop or Cursor to:
- fetch your latest prompts and metrics
- inspect citations and source domains
- analyze fan-out query performance
- review site audit results
Where to find setup instructions
The easiest path is to go to mcp.ranketta.com, where you can find up-to-date, client-specific setup instructions.
How authentication works
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 according to your existing permissions.
Setup steps
- Open mcp.ranketta.com.
- Choose the client you want to connect (for example, Claude Desktop or Cursor).
- Copy the recommended server configuration for that client.
- Add a new remote MCP server in your client and paste the configuration.
- Complete the Ranketta OAuth login and authorization flow.
- Validate the connection with a test query (for example, list prompts or citations).
Citation tools
The MCP server exposes the same citation data as the Citations dashboard:
| Tool | What it returns |
|---|---|
get_citation_domains | Paginated domains with usage rates |
get_citation_urls | Paginated URLs with usage rates |
get_citation_domain_types_breakdown | Share of citations by domain type |
get_citation_page_types_breakdown | Share of citations by page type |
get_prompt_citations | Citation URLs for one prompt |
Optional filters on list tools: domain_types, page_types, mention (customer mentioned or not), search, limit, offset. Breakdown tools also accept start_date and end_date (ISO dates).
Domain types include corporate, ugc, editorial, review, institutional, social_media, ecommerce, wiki, news, and other. Page types include blog_post, product_page, guide, listicle, comparison, and others — see Understand Citations for the full lists.
These endpoints are also available on the public REST API (api.ranketta.com/v1/citations/overall/...) for integrations that use API keys instead of MCP.
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?"
- "Show the latest citation URLs for prompt X."
- "Compare fan-out results by provider."
- "Show unresolved issues from the latest site audit."
Troubleshooting
- If authorization fails, reconnect the MCP server and repeat OAuth.
- If results are empty, verify that the active company context is correct.
- If access is denied, check your Ranketta role and module permissions.