Connect SEO Score API to Gemini CLI and Antigravity

In Gemini CLI, run gemini mcp add --transport http --scope user --header "Authorization: Bearer ssa_your_key_here" seoscoreapi https://seoscoreapi.com/mcp, then /mcp to see the tools. In Antigravity, add the same URL as serverUrl in mcp_config.json with the same header.

Once it is connected, Gemini CLI can run SEO Score API's tools for you: SEO audits with 80+ checks, GEO and AI-visibility checks, ADA / WCAG accessibility audits, AI citation tracking, site crawls and Deep Audits, all on your own plan.

Set it up

Get a key. Copy your API key from your dashboard, or get a free one.
Add the server. Run the command below, or paste the JSON into ~/.gemini/settings.json (every project) or .gemini/settings.json (this project). Without --scope user the command saves to the project.
Check it. Start gemini and run /mcp. SEO Score API should be connected, with its tools listed.
Ask. Try one of the prompts below.

The config

Gemini CLI: one command

gemini mcp add --transport http --scope user \
  --header "Authorization: Bearer ssa_your_key_here" \
  seoscoreapi https://seoscoreapi.com/mcp

Gemini CLI: ~/.gemini/settings.json

{
  "mcpServers": {
    "seoscoreapi": {
      "httpUrl": "https://seoscoreapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ssa_your_key_here"
      }
    }
  }
}

Antigravity CLI and IDE: ~/.gemini/config/mcp_config.json

{
  "mcpServers": {
    "seoscoreapi": {
      "serverUrl": "https://seoscoreapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ssa_your_key_here"
      }
    }
  }
}

Gemini CLI uses httpUrl for a streaming HTTP server like ours; url there means an older SSE server. Antigravity is the other way round: it uses serverUrl and does not support httpUrl.

Antigravity: Google moved unpaid-tier and Google One users from Gemini CLI to Antigravity CLI on June 18, 2026. In the Antigravity CLI, type /mcp to open the MCP manager. In the Antigravity app, go to Customizations > Installed > MCP Servers; in the IDE, use ... at the top of the agent panel, then MCP Servers > Manage MCP Servers > View raw config. A workspace-only config goes in .agents/mcp_config.json.

Sign-in instead of a key: both support OAuth for remote servers. Leave out headers, then in Gemini CLI run /mcp auth seoscoreapi, or in the Antigravity app click Authenticate next to the server. Browser sign-in needs a local browser, so over SSH use the API key.

The Gemini web and mobile apps are not covered here: Google's docs we checked describe MCP servers for Gemini CLI and Antigravity only.

Prompts to try first

Swap in your own URL. The plan column says who can run each one.

Ask	Tool	Plan
Audit https://example.com and list the top 5 fixes, most important first.	`audit`	Free key
How well can AI assistants read https://example.com? Run an AI readability check.	`ai_readability`	Free key
Score the conversion of https://example.com/pricing and tell me what is costing sign-ups.	`conversion`	Free key (full fix list on paid plans)
Is https://example.com visible to ChatGPT and AI search? Run a GEO audit.	`geo_audit`	Basic ($15/mo) and up
Check https://example.com for ADA / WCAG 2.1 AA issues and list the critical ones with fixes.	`accessibility_audit`	Paid plans, from Starter ($5/mo)
Generate an llms.txt file for example.com.	`llms_txt`	Any key
Crawl example.com and show me the broken pages, redirects and orphan pages.	`crawl_site`	Pro ($39/mo), Ultra or a Deep Audit credit
Track whether ChatGPT, Gemini, Perplexity and Claude mention Acme when people ask for an SEO tool. Build starter prompts, create a citation tracker and run it.	`create_citation_tracker`	Starter ($5/mo) and up
Run a Deep Audit on https://example.com and list the high-severity findings.	`deep_audit`	Pro ($39/mo), Ultra or credits

Troubleshooting

Gemini CLI shows the server as disconnected

Check you used httpUrl, not url, for our server in settings.json, and that the header line is exactly Authorization: Bearer ssa_....

Antigravity ignores the server

Antigravity reads serverUrl (url also works) and does not support httpUrl. Restart it, or reload with /mcp, after editing the file.

The tools are listed but every call fails with an authentication error

Listing tools needs no key; running one does. Check the key starts with ssa_, that the header reads exactly Authorization: Bearer ssa_... (one space after Bearer) or X-API-Key: ssa_..., and that the key was not rotated in your dashboard since.

A tool says it needs a higher plan

Some tools are on paid plans only (GEO audits from Basic, accessibility audits and citation trackers from Starter, crawls and Deep Audits from Pro). The message names the plan; your free audits keep working.

A tool says you have used this month's audits

The free plan includes 20 audits a month. The message gives the reset date and a one-click upgrade.

FAQ

Does SEO Score API work with Gemini?

Yes, in Gemini CLI and in Antigravity (CLI, app and IDE) through the hosted MCP server. We have not found MCP server support documented for the Gemini web app.

Can I keep the key out of settings.json?

Use OAuth sign-in instead (/mcp auth seoscoreapi in Gemini CLI). Gemini CLI's docs describe environment variable expansion for a server's env block, not for headers, so we don't rely on it here.

Is it free?

Yes, to start. A free SEO Score API key includes 20 audits a month and needs no card. GEO audits, accessibility audits, citation tracking, crawls and Deep Audits need a paid plan; plans start at Starter ($5/mo). Every tool call uses your plan's allowance exactly as the REST API does.

Do I need to install anything?

No. The server is hosted at https://seoscoreapi.com/mcp, so you add a URL, not a program. If your assistant only runs local servers, the same tools are in the open-source npm package: npx -y seoscoreapi-mcp with SEO_SCORE_API_KEY set.

API key or sign-in: which should I use?

Either works. Assistants that let you set a request header can send your key as Authorization: Bearer ssa_... or X-API-Key: ssa_.... Assistants with MCP sign-in open seoscoreapi.com, you sign in with an email link, Google or GitHub (or create a free account), approve, and you are done. Listing the tools works without either; running one needs one of them.

What can't it do?

It does not download PDF reports (a tool result is text; the audit tool returns the same data), it does not change account settings such as auto-reload, and it cannot create, upgrade or rotate keys. Those stay in your dashboard.

Prefer a local server?

The same tools ship as an open-source npm package that runs on your machine over stdio. Any client that runs local MCP servers can use it:

Local stdio server (npm)

{
  "mcpServers": {
    "seoscoreapi": {
      "command": "npx",
      "args": [
        "-y",
        "seoscoreapi-mcp"
      ],
      "env": {
        "SEO_SCORE_API_KEY": "ssa_your_key_here"
      }
    }
  }
}

Source: github.com/SeoScoreAPI/seoscoreapi-mcp.

Other assistants

ChatGPT · Claude · Claude Code · Cursor · VS Code / GitHub Copilot · Codex · Windsurf / Devin Desktop · Copilot Studio

Questions? Email aaron@seoscoreapi.com. See every AI assistant guide, all integrations and the API docs.