Black Friday25% off your first month on monthly plans Get the deal

MCP server and REST API

Your ASO data, inside your AI assistant

The Rankglass MCP server lets Claude Code, Cursor, Claude Desktop, Codex, the ChatGPT desktop app and other MCP clients read your tracked keywords, ranks, competitors and listing scores. A REST API gives your own scripts the same data.

At a glance

MCP endpoint
https://app.rankglass.com/api/mcp
Transport
Streamable HTTP
Authentication
A workspace API key, sent as Authorization: Bearer YOUR_API_KEY
Access
Read-only
Plans
Starter, Pro, and Agency
Rate limits
60 requests a minute and 2,000 a day per key

Works with MCP clients that can send a header

Rankglass checks an API key on every request, so a client only has to send it as a header. These clients are set up below:

  • Claude Code
  • Cursor
  • Claude Desktop, through mcp-remote (needs Node.js)
  • Codex and the ChatGPT desktop app
  • Other MCP clients and agents you build, with the endpoint and header above

A client that can only connect through an OAuth sign-in can't send the key, so it can't add Rankglass yet.

Set it up in three steps

  1. Step 1

    Create an API key

    In Rankglass, open Settings → Workspace → API & MCP and create a key. It is shown once, so copy it right away. A key reads one workspace; make one per assistant or script so you can revoke each on its own.

  2. Step 2

    Add Rankglass to your assistant

    Paste the setup for your client and replace YOUR_API_KEY with your key.

    Claude Code

    Run this in a terminal. With --scope user, Rankglass is there in all your projects.

    claude mcp add --transport http --scope user rankglass https://app.rankglass.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

    Cursor and other clients

    For Cursor, add this to ~/.cursor/mcp.json, or to .cursor/mcp.json in a project. Other clients keep MCP servers in their own settings; the endpoint and header are all they need.

    {
      "mcpServers": {
        "rankglass": {
          "url": "https://app.rankglass.com/api/mcp",
          "headers": {
            "Authorization": "Bearer YOUR_API_KEY"
          }
        }
      }
    }

    Claude Desktop

    Add this to claude_desktop_config.json (Settings → Developer → Edit Config), then restart Claude. It runs mcp-remote with npx, so Node.js has to be installed.

    {
      "mcpServers": {
        "rankglass": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote",
            "https://app.rankglass.com/api/mcp",
            "--header",
            "Authorization:${RANKGLASS_AUTH}"
          ],
          "env": {
            "RANKGLASS_AUTH": "Bearer YOUR_API_KEY"
          }
        }
      }
    }

    Codex and the ChatGPT desktop app

    Add this to ~/.codex/config.toml, which the Codex CLI, the Codex IDE extension and the ChatGPT desktop app share. Put your key, without Bearer, in an environment variable named RANKGLASS_API_KEY.

    [mcp_servers.rankglass]
    url = "https://app.rankglass.com/api/mcp"
    bearer_token_env_var = "RANKGLASS_API_KEY"

    Clients that can't set the Authorization header can send x-api-key: YOUR_API_KEY instead.

  3. Step 3

    Ask in your own words

    Your assistant picks the right tool. None of them can change anything in your workspace.

What your assistant can read

11 read-only tools. Each one has a matching GET endpoint in the REST API.

MCP tools and their REST endpoints
MCP toolWhat it returnsREST endpoint
list_appsYour apps with their stores, tracked countries, keyword counts and this week's headline numbers. A good first call.GET /v1/apps
get_keyword_rankingsEvery tracked keyword of an app in one store and country: rank, 7-day change, movement into or out of the results, best rank, estimated monthly searches, difficulty and competitor ranks.GET /v1/keywords
get_rank_changesThe biggest rank gains and losses over the last days, across all keywords, stores and countries, and keywords that entered or left the top 10.GET /v1/rank-changes
get_competitorsFollowed competitors with ratings, how many keywords each side ranks higher on, and keywords where a competitor is in the top 10 and you aren't.GET /v1/competitors
get_competitor_keywordsThe keywords a competitor ranks for in one country, including ones you don't track yet, with monthly searches, difficulty and both ranks.GET /v1/competitor-keywords
get_competitor_insightsA competitor's store facts, ratings by stars, chart ranks, estimated monthly downloads and revenue, and its latest AI review summary.GET /v1/competitor-insights
get_competitor_growthBetaHow a competitor gets its users: its ads, social accounts, creators, store search and website, with estimated ad spend, installs from ads and social reach, and the latest AI strategy. Pro and Agency.GET /v1/competitor-growth
get_store_page_changesRecent changes to your store pages and your competitors': title, subtitle, description, screenshots, version and release notes.GET /v1/store-page-changes
get_aso_scoreYour 0–100 ASO score for one store and country, the checks behind it, quick keyword wins and the latest AI listing suggestions.GET /v1/aso-score
get_weekly_briefYour app's latest weekly brief: what changed, the likely reasons and up to three things to do next.GET /v1/weekly-brief
get_keyword_game_planBetaThe latest game plan for a tracked keyword: the goal rank and up to five steps to reach it.GET /v1/keyword-game-plan

REST API

The same data as JSON for your own scripts, dashboards and spreadsheets. Every endpoint is a GET request under https://app.rankglass.com/api/v1 and takes the same key.

A first request: the biggest rank changes of the last seven days.

curl "https://app.rankglass.com/api/v1/rank-changes?days=7" -H "Authorization: Bearer YOUR_API_KEY"

Limits and access

  • Read-only. The tools and endpoints only read what Rankglass has stored; they never start a new search. Paid work, such as finding a competitor's keywords in a new country, is started from the dashboard.
  • Each key can make 60 requests a minute and 2,000 a day, shared by the MCP server and the REST API. Past that, requests get a 429 response with a Retry-After header.
  • API and MCP access come with the Starter, Pro, and Agency plans. Without it, requests get a 403 response.
  • A key reads everything in its workspace, so treat it like a password. The settings page shows when each key was last used, and you can revoke it there.

Questions to try

  • Which of my keywords dropped this week?
  • Where does my app rank for “habit tracker” in Germany, and who is above me?
  • What does my top competitor rank for that I don't track yet?
  • What did my competitors change on their store pages this month?
  • What's my ASO score in the UK, and what should I fix first?
  • Summarize this week's brief for each of my apps.

Questions about the MCP server

Does it work with ChatGPT?

Yes, in the ChatGPT desktop app. It shares its MCP servers with the Codex CLI and the Codex IDE extension in ~/.codex/config.toml, which can send your key from an environment variable (bearer_token_env_var); the setup above shows the config. ChatGPT on the web adds tools through connectors that only offer an OAuth sign-in, and those can't send the key yet. Anything that can call an API with a header can use the REST API instead.

Can my assistant change anything in Rankglass?

No. Every tool and endpoint only reads. Adding apps, tracking keywords and starting searches happen in the dashboard.

How fresh is the data?

The same as in the dashboard: on paid plans every tracked keyword is checked once a day, and the weekly brief is written every Monday. The tools read what Rankglass has stored and never start a check.

Where does my data go?

Only to the client that asks for it, and only from the workspace the key belongs to. From there your assistant's provider handles it under its own terms. Delete the key to stop it at any time.

Prefer a walkthrough? Read how to set up the Rankglass MCP server.

Find out what to do next for your app

Add your app with one store link and see where you rank today.

Start free

Free plan · No credit card · Cancel anytime