ContextBolt SEO in Gemini CLI (2026 Setup Guide)

One entry in settings.json, and Gemini CLI pulls live keyword and SERP data.

7-day free trial · then $35/mo · 1,000 credits

SEO MCP server for Claude, Cursor & Codex Gemini CLI · ContextBolt connected live data

What should I write next?

Used keyword_research

email marketing toolsKD 49 · 4,400/mo

email automationKD 31 · 2,900/mo

welcome email examplesKD 22 · 1,600/mo

Trusted by 300+ users across the globe

It connects in 3 minutes.

Prepare your account Use your active SEO trial or subscription.

Add the shared server URL In ~/.gemini/settings.json, add contextbolt-seo under mcpServers with httpUrl set to https://seo.contextbolt.app/mcp.

Sign in to ContextBolt Run /mcp auth contextbolt-seo in Gemini CLI. Enter your ContextBolt SEO account email and email code, then allow the connection.

Check the tools Ask the agent what ContextBolt tools it has. Check authentication if the list is empty.

The guide covers every client and the compatibility options. The full setup guide

Then ask it something real.

“What keywords should my developer-tools blog target?” Gemini CLI calls keyword_research and returns related terms with volume, difficulty, and intent, so you get a content shortlist from the terminal.

“How hard is 'gemini cli mcp' to rank for, and who's in the top 10?” Chains keyword_difficulty and serp_overview so you get a difficulty score and the live page-one results without leaving the terminal.

“What does supabase.com rank for, and who competes for those terms?” Runs ranked_keywords then competitor_keywords for a content map plus the rivals chasing the same keywords.

“Who links to my top competitor but not to me?” Calls backlink_gap and returns a spam-scored prospect list, a ready-made outreach shortlist. Backlink calls cost three credits each.

What it can do in Gemini CLI.

Run keyword research in plain English from the terminal

Score how hard a keyword is to rank for before you write

See who ranks in Google's top 10 for any query

Size up any domain's traffic, keywords, and authority

Find the keywords a competitor already ranks for

Spot backlink gaps: who links to rivals but not you

Connect your own Google Search Console, read-only and free

Get a private SEO Dashboard that fills itself with your research, free

The longer story.

Gemini CLI is Google’s open-source, terminal-based AI agent. It speaks the Model Context Protocol, so you can wire in ContextBolt SEO and pull live keyword, SERP, domain, and competitor data straight into your terminal workflow.

Every lookup you run lands on your SEO Dashboard, a private page you can sign in to from any machine, instead of disappearing into the session.

SEO research where you ship

When you are building, the question “what should this rank for, and who already owns it?” is one you want answered without breaking flow. With ContextBolt SEO in Gemini CLI you ask it in the terminal and the numbers come back inline. Every answer is saved to your SEO Dashboard, with no export and no second tool.

Because these are MCP tools, Gemini CLI chains them. “Find ten low-difficulty keywords for my docs site, check which ones a competitor already ranks for, and list the gaps” is one prompt, not ten dashboard sessions, and the whole session lands on your dashboard.

The config entry

Add ContextBolt SEO to ~/.gemini/settings.json (global) or .gemini/settings.json (per project), under the mcpServers object:

{
  "mcpServers": {
    "contextbolt-seo": {
      "httpUrl": "https://seo.contextbolt.app/mcp"
    }
  }
}

Note the key is httpUrl, not url. Gemini CLI uses httpUrl for a remote streamable-HTTP server, reserves url for SSE endpoints, and uses command plus args for local stdio servers. This is the one detail that trips people up, since Cursor and Codex use url and Windsurf and Antigravity use serverUrl. Save the file, start Gemini CLI, and run /mcp auth contextbolt-seo. Enter your SEO account email and email code, then allow access. Run /mcp to confirm the tools loaded. The shared URL contains no personal secret. The full tour of tools and workflows is in the ContextBolt SEO guide.

Common questions.

Where does the Gemini CLI MCP config live?

In ~/.gemini/settings.json for a global setup, or .gemini/settings.json in your repo root per project. MCP servers go under the mcpServers object. For ContextBolt SEO, set httpUrl to https://seo.contextbolt.app/mcp and run /mcp auth contextbolt-seo. Complete the browser sign-in with your SEO account email and email code, allow access, then run /mcp to confirm the tools loaded.

Should I use url or httpUrl in Gemini CLI?

Use httpUrl for a remote streamable-HTTP server like ContextBolt SEO. In Gemini CLI, url is reserved for Server-Sent Events endpoints, and command with args is for local stdio servers. Getting this key wrong is the most common reason the tools never appear.

Where does my research get saved?

To your ContextBolt account, and it shows up on your SEO Dashboard, a private page that fills itself as you work. It is one URL, so the research follows you between machines and between agents instead of living in one project folder. Saving is free and never counts against your 1,000 monthly credits.

How many credits does a question cost?

Research tools cost one credit each. Backlink tools cost three each. The plan includes 1,000 a month, top-ups never expire, and checking your balance is free.

Does it remember past research?

Yes. Ask about the same keyword again and the answer leads with what has changed since last time, like a difficulty or volume delta, at no extra cost. Memory is automatic and free.

ContextBolt SEO in Gemini CLI (2026 Setup Guide)

It connects in 3 minutes.

Then ask it something real.

What it can do in Gemini CLI.

The longer story.

SEO research where you ship

The config entry

Common questions.

See it in your own chat.