GetCited MCP connector
Client-side pieces for connecting a coding agent to GetCited: the MCP server definition, a Claude Code plugin with its skills, a Gemini CLI extension, and a small stdio proxy for clients that cannot speak Streamable HTTP.
GetCited audits a site the way an answer engine reads it, tracks where it ranks, records which AI engines cite it, and files each measured problem as an action with the evidence behind it. It never proposes the fix: your agent has the repository open and it does not.
The service itself is closed source. Everything in this repository is the connector — transport, manifests and prompts — so you can read exactly what your agent is being told and what leaves your machine.
Connect
Create a key under Settings → API keys in the app, then pick your client.
Claude Code
claude mcp add --transport http getcited https://app.getcited.dev/api/mcp \
--header "Authorization: Bearer $SEO_API_KEY"
Any client that reads a JSON config
{
"mcpServers": {
"getcited": {
"type": "http",
"url": "https://app.getcited.dev/api/mcp",
"headers": { "Authorization": "Bearer ${SEO_API_KEY}" }
}
}
}
Gemini CLI
gemini extensions install https://github.com/bapierre/getcited-mcp
Clients without a remote transport (Claude Desktop, whose config takes a
command rather than a URL) use the stdio proxy in src/:
claude mcp add getcited --env SEO_API_KEY="vseo_..." -- npx -y getcited-mcp
| Variable | Required | Meaning |
|---|---|---|
SEO_API_KEY | yes | The key from Settings → API keys. |
SEO_API_URL | no | Endpoint override. Defaults to https://app.getcited.dev/api/mcp. |
Without SEO_API_KEY the proxy still starts and lists the tools from a bundled
snapshot (src/tool-snapshot.ts), so registries can inspect it; every call then
fails with a message naming the variable. Refresh the snapshot after the hosted
tool list changes with npm run build && SEO_API_KEY=vseo_... npm run snapshot.
llms-install.md is the same instructions written for an agent, so you can tell
your assistant to set this up rather than doing it yourself.
What is in here
| Path | What it is |
|---|---|
src/stdio.ts | The stdio proxy. Forwards JSON-RPC to the HTTPS endpoint and nothing else. |
src/tool-snapshot.ts | Tool definitions served when no key is set. Generated by scripts/snapshot-tools.mjs. |
Dockerfile | Builds the stdio proxy, for registries that run servers in a container. |
.claude-plugin/, skills/ | The Claude Code plugin and its two skills. |
gemini-extension.json | The Gemini CLI extension manifest. |
.mcp.json | A project-scoped Claude Code server entry. |
llms-install.md | Setup instructions addressed to an agent. |
The tools
Sites (list_projects, add_project, remove_project, get_site_health),
onboarding and profile (get_setup_status, get_project_profile,
set_project_profile), the queue (get_next_work, list_actions,
get_action, claim_action, complete_action, dismiss_action,
run_audit), growth (list_opportunities, get_content_brief,
list_regressions, get_page_history), rankings (add_keywords,
list_keywords, rank_history, check_rankings), AI visibility
(add_geo_prompts, geo_summary, check_geo, run_brain) and visitors
(get_behavior_digest, get_page_profile).
Each tool carries a title and the readOnlyHint or destructiveHint
annotation that matches what it does. Full documentation, including what every
number means and the rules the measurements follow:
https://getcited.dev/docs/mcp.
Registry
Listed in the official MCP Registry as dev.getcited/mcp, published under a
DNS-verified namespace.
Support
getcited.dev/support · privacy · terms · MIT licensed.