RankEcho

Command-line agent · Connects to the URL directly

Connect Search Console to Gemini CLI

Add RankEcho to Gemini CLI's settings.json as an MCP server with httpUrl https://rankecho.io/mcp, then run /mcp auth rankecho to sign in. Gemini CLI can then read your real Search Console numbers and RankEcho's opportunities from the terminal, read-only.

Server URLhttps://rankecho.io/mcp

What you need

  • Gemini CLI installed
  • RankEcho Search Intelligence: the trial or any paid plan
  • Google Search Console connected to RankEcho for at least one site

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

Set it up in Gemini CLI

  1. Add the server

    Open ~/.gemini/settings.json, or .gemini/settings.json in a project, and add RankEcho under mcpServers.

    {
      "mcpServers": {
        "rankecho": {
          "httpUrl": "https://rankecho.io/mcp"
        }
      }
    }
  2. Sign in

    Start Gemini CLI and run the auth command. Your browser opens RankEcho's sign-in.

    /mcp auth rankecho
  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

    Back in Gemini CLI, ask in plain words. Start with: Which of my sites can you read, and up to which day?

Check it worked: Run /mcp. RankEcho should be listed as connected with its 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 Gemini CLI: 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 Gemini CLI 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 Gemini CLI?

Add RankEcho to Gemini CLI's settings.json as an MCP server with httpUrl https://rankecho.io/mcp, then run /mcp auth rankecho to sign in. Gemini CLI can then read your real Search Console numbers and RankEcho's opportunities from the terminal, read-only.

Can Gemini CLI 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.

Gemini CLI says the server needs authentication

Run /mcp auth rankecho. Gemini CLI does not sign in on its own for every server.

The sign-in page rejects the redirect

Update Gemini CLI. RankEcho accepts its callback, http://localhost:PORT/oauth/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.