RankEcho

Code editor · Connects through mcp-remote

Connect Search Console to Cursor

Add RankEcho to Cursor's mcp.json as a command that runs npx -y mcp-remote https://rankecho.io/mcp. On first use a browser opens to sign in and pick sites. Cursor's agent can then read your Search Console data and RankEcho's opportunities while it edits your pages.

Server URLhttps://rankecho.io/mcp

What you need

  • Node.js 18 or newer, so the editor can run npx
  • RankEcho Search Intelligence: the trial or any paid plan

No RankEcho account yet? Connect Search Console first: the trial includes the connector.

Set it up in Cursor

  1. Add the server

    Open ~/.cursor/mcp.json for every project, or .cursor/mcp.json in one project, and add RankEcho.

    {
      "mcpServers": {
        "rankecho": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "https://rankecho.io/mcp"]
        }
      }
    }
  2. Turn it on

    Open Cursor Settings, find rankecho in the MCP list and make sure it is enabled. Cursor starts mcp-remote, which opens your browser.

  3. Sign in and choose sites

    A RankEcho page opens. Sign in, tick the sites this connection may read, and approve. It gets read-only access to those sites and nothing else.

  4. Ask about your data

    In the agent chat, ask in plain words. Start with: Which of my sites can you read, and up to which day?

Check it worked: Cursor's MCP settings should show rankecho with a green dot and nineteen tools.

Questions to start with

  • Which of my sites can you read, and up to which day?
  • Which pages lost the most clicks in the last 28 days compared with the 28 before?
  • List my top 5 opportunities and what each would take.
  • Which searches show my site on page 2, and which page ranks for each?
  • Did the changes I marked done last month help?

What it reads for rankecho.io

We connect RankEcho to our own site. These are the numbers the tools read for rankecho.io, so you can see the size of answer to expect in Cursor: the last 28 synced days, 9 October to 5 November 2026, and the 90 days of search rows behind the page and search tools.

Clicks, last 28 days155,922 impressions
Average position51.9last 28 days
Searches in the rows85090 days
Pages in the rows12413,271 impressions

Source: rankecho.io's Search Console as RankEcho synced it, read 16 November 2026. Search rows cover 8 August to 5 November 2026.

What Cursor can read

Every tool reads; none writes. Each answer comes from RankEcho's synced Search Console data and its Opportunities, for the sites you ticked.

The nineteen read-only tools
ToolWhat it reads
list_sitesWhich of your sites this connection may read, and whether their data has synced.
get_data_statusThe first and last synced day, and the last 28 days at a glance.
get_site_overviewClicks, impressions, CTR and position for any range, with the period before.
query_performanceTop pages or searches, filtered and sorted, with their change.
compare_periodsTwo ranges side by side, and the pages or searches that moved most.
list_actionsQuick wins, low CTR pages, decaying pages and content gaps, by clicks at stake.
get_page_evidenceOne page's numbers, its top searches and the actions about it.
get_action_resultsClicks 28 days before and after each change you marked done.
list_opportunitiesGoogle, answer box and AI answer opportunities, ranked as in RankEcho.
list_resultsEach test's baseline and its result against control pages and prompts.
find_striking_distanceSearches just below the top, by the clicks they would gain at a target position.
check_ctr_benchmarkYour CTR by position against a published curve, and the pages missing clicks.
find_competing_pagesSearches your own pages split, which page should own each, and the fix.
find_content_decayPages or searches well below their best month, by clicks lost.
list_new_lost_rankingsSearches you started or stopped ranking for, window against window.
list_ai_searchesSearches phrased like AI prompts, and whether AI answers cite you for them.
forecast_trafficClicks month by month with seasons, a likely range and a scenario.
list_experimentsChanges tried on half a group of pages, read against the other half.
get_index_statusTracked pages as Google last reported them, and an index health score.

Questions and fixes

How do I connect Search Console to Cursor?

Add RankEcho to Cursor's mcp.json as a command that runs npx -y mcp-remote https://rankecho.io/mcp. On first use a browser opens to sign in and pick sites. Cursor's agent can then read your Search Console data and RankEcho's opportunities while it edits your pages.

Can Cursor change my site or Search Console through RankEcho?

No. The connection is read-only. It reads the sites you ticked and cannot edit your website, start a sync or change any setting. Disconnect it any time in RankEcho under ChatGPT and AI connections.

Do I need to give it my Google password?

No. You sign in to RankEcho, which already holds your Search Console connection, and pick the sites the assistant may read. Google credentials never reach the assistant.

The browser never opens

mcp-remote opens the sign-in page on first use. Check the editor's MCP log for the link and open it by hand. If a stale sign-in is stuck, delete the ~/.mcp-auth folder and reload the server.

It says the redirect is not allowed

Update mcp-remote, or remove a custom --callback-path. RankEcho accepts http://localhost:PORT/oauth/callback, mcp-remote's default, and /callback.

Other assistants

Steps checked 2026-11-16. Clients change their menus often; if a step looks different, the server URL and the sign-in stay the same.