Rankscale MCP server
Connect Claude, ChatGPT, Cursor, or any Model Context Protocol client to your Rankscale data. Reading is always included. Creating content and spending credits are separate permissions that you turn on only if you want them.
Server URL
https://mcp.rankscale.ai/mcpAvailable on Essentials, Pro, Pro+, Growth, and Enterprise plans. Nothing is installed on your machine.
Connect
Claude (web and desktop)
- Open Settings, then Connectors, and choose Add custom connector.
- Enter https://mcp.rankscale.ai/mcp and confirm.
- Sign in to Rankscale in the tab that opens, pick the permissions you want, and choose Allow access.
ChatGPT
- Add a custom connector (app) with the URL https://mcp.rankscale.ai/mcp, then sign in to Rankscale when asked.
Cursor and other MCP clients
- Add a remote MCP server with the URL https://mcp.rankscale.ai/mcp. Any client that supports Streamable HTTP and OAuth can connect.
Your client registers itself automatically (OAuth Dynamic Client Registration or Client ID Metadata Documents). There is no API key to copy.
Permissions
When you connect, Rankscale shows a consent screen. Read access is always granted. Each write permission is its own switch and starts off.
mcp:readRead your Rankscale data
Always included. Lets your assistant read your brands, search terms, topics, executions, analytics, and saved dashboard views.
Always on
mcp:write:contentCreate and update your search terms, topics, and dashboards
Optional, off by default. New search terms are created inactive, so nothing runs or spends credits until you activate it.
Off unless you turn it on
mcp:executeRun search terms and activate tracking
Optional, off by default. Spends your Rankscale credits. Every credit-spending call shows the cost first and waits for your confirmation.
Off unless you turn it on
Every tool that changes data is marked as a write, so Claude asks you before it runs one. Your assistant cannot delete brands or your account, and cannot change brand or competitor settings.
Tools
Read: brands, search terms, and runs
Look up how your account is set up and what recent runs returned. Requires mcp:read.
| Tool | What it does |
|---|---|
rankscale_brands_list | Lists the brands you own or that are shared with you. |
rankscale_brands_get | Returns one brand by id. |
rankscale_search_terms_list | Lists the search terms tracked for a brand. |
rankscale_search_terms_get | Returns one search term and its configuration. |
rankscale_topics_list | Lists the topics that group a brand’s search terms. |
rankscale_executions_list | Lists recent runs as compact summaries (paginated). |
rankscale_executions_get | Returns one run in full: the AI answer, cited URLs, and mentioned companies. |
rankscale_operation_get | Reports the progress of a “run now” request. |
Read: analytics
Each analytics tool accepts the same filters (time frame, engine, topic, tags, query) and returns a summary plus an optional time series. Requires mcp:read.
| Tool | What it does |
|---|---|
rankscale_dashboard_summary | Your brand’s topline: AI Visibility Score, mentions, citations, sentiment, average position. |
rankscale_competitors_summary | Competitor leaderboard and per-competitor trend. |
rankscale_citations_summary | Top cited URLs and the sites that cite you most. |
rankscale_sources_summary | Domains that appear in AI source boxes next to you. |
rankscale_sentiment_summary | Sentiment breakdown and the keywords driving it. |
rankscale_shopping_summary | Products, providers, buybox winners, price and rating signals. |
rankscale_custom_dashboard_views_list | Lists a brand’s saved dashboard views. |
rankscale_custom_dashboard_view_get | Returns one saved view’s full configuration. |
Write: search terms, topics, and dashboard views
Only available if you turn on the content permission when you connect. None of these tools spend credits. Requires mcp:write:content.
| Tool | What it does |
|---|---|
rankscale_search_terms_create | Creates a search term in the inactive state. Duplicate-safe. |
rankscale_search_terms_update | Updates a search term’s allowed fields (for example query, tags, cadence, engine). |
rankscale_search_terms_deactivate | Pauses 1 to 50 search terms. Shows a preview and asks you to confirm first. |
rankscale_topics_create | Creates a topic (a grouping for search terms). |
rankscale_topics_assign_terms | Groups search terms under a topic. Moving a term between topics asks you to confirm first. |
rankscale_topics_unassign_terms | Removes search terms from their topic. |
rankscale_custom_dashboard_view_create | Saves a new dashboard view. |
rankscale_custom_dashboard_view_update | Renames or reconfigures a saved view. |
rankscale_custom_dashboard_view_set_default | Makes one saved view the brand default. |
Run tracking (spends credits)
Only available if you turn on the credit-spending permission when you connect. Both tools show the cost first and wait for your confirmation. Requires mcp:execute.
| Tool | What it does |
|---|---|
rankscale_search_terms_activate | Starts recurring tracking on 1 to 50 inactive terms. Spends credits on every scheduled run. |
rankscale_search_terms_execute | Runs 1 to 20 terms once, right now, without changing their schedule. Spends credits. |
Security, data, and revoking access
- Tools only return data the signed-in Rankscale user can already see in the dashboard. Your assistant asks for one piece of data at a time during a conversation; it never gets a bulk export.
- Sign-in uses OAuth 2.1 with PKCE. Access tokens last one hour and refresh automatically. Rankscale never issues long-lived API keys for MCP.
- See and revoke every connected assistant at Settings, Connections, MCP. Revoking ends access for that connection immediately.
- How we handle MCP data is described in our privacy policy.
Troubleshooting and support
- “This authorization request has expired.”
- The consent link is single-use and lasts a few minutes. Close the tab, go back to your assistant, and connect again.
- “Your Rankscale account is not eligible for MCP access.”
- MCP needs a completed signup on an Essentials plan or higher. The consent page shows which Rankscale account is signed in; choose Use a different account if it is the wrong one.
- My assistant says the session expired.
- Tokens refresh automatically. This usually means the connection was revoked in Settings, or was ended after a suspected security event. Connections also need fresh consent after one year. Connect again from your assistant.
- I see only read tools.
- Write tools appear only for the permissions you turned on at connect time. Disconnect, then connect again and turn on the permission you need.
- “Rate limit exceeded.”
- The server limits calls per user to protect everyone. Wait about a minute and try again.
Still stuck? Email support@rankscale.ai.
Reference
- Server URL
- https://mcp.rankscale.ai/mcp
- Transport
- Streamable HTTP
- Auth
- OAuth 2.1, PKCE (S256), DCR and CIMD
- Resource identifier
- https://mcp.rankscale.ai/mcp
- Scopes
- mcp:read, mcp:write:content, mcp:execute
- Metadata
- https://mcp.rankscale.ai/.well-known/oauth-protected-resource