geoseo-mcp server

by Rachit8484·io.github.Rachit8484/geoseo-mcp·v0.4.0·3 stars

No reviews yet

SEO + GEO: Search Console, Bing, Yandex, IndexNow, AI Overviews and LLM citation tracking.

B83/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B83/100

full report

Adoption

Growing

3 stars107 downloads/wk

Reviews

Write one

Nobody has reviewed geoseo-mcp yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

geoseo-mcp tools (47, 11 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

aio_checkwrite action
Run a Google search via SerpAPI and parse the AI Overview block.
aio_citation_check
For a batch of queries, report AIO fire-rate and citation share for ``target_domain``.
audit_page
Audit a single page (local file path or http(s) URL).
audit_site
Recursively audit every HTML file under a folder.
bing_crawl_issues
Crawl errors / blocked URLs / DNS issues reported by Bingbot.
bing_list_sites
List all Bing-verified sites for the API key owner.
bing_page_stats
Per-page stats from Bing Webmaster.
bing_query_stats
Last-6-months query stats from Bing Webmaster (clicks, impressions, position).
bing_submit_urlwrite action
Submit a URL for fast crawling. Daily quota applies (default ~10/day).
bing_url_info
Index status + crawl info for a single URL on Bing.
brave_query
Ask Brave's AI Answers (grounded in Brave Search); return answer + cited URLs.
claude_query
Ask Claude (with server-side web search) a question; return answer + cited URLs.
find_broken_external_links
Find dead, redirected, or flaky outbound links across a folder of HTML.
gemini_query
Ask Gemini (with Google Search grounding) a question; return answer + cited URLs.
generate_llms_txt
Generate a draft ``llms.txt`` from a folder of HTML pages.
geoseo_status
Report which engines are configured and reachable.
grok_query
Ask Grok (with live web search) a question; return answer + cited URLs.
gsc_inspect_url
Get index status for a specific URL via the URL Inspection API.
gsc_list_sites
List all Search Console properties the authenticated user can access.
gsc_performance
Query GSC search analytics.
gsc_submit_sitemapwrite action
Submit (or resubmit) a sitemap URL to GSC.
indexnow_submit_urlwrite action
Notify Bing, Yandex, Naver, Seznam, and Yep that a single URL was published or updated.
indexnow_submit_urlswrite action
Batch-notify search engines about up to 10,000 URLs (must share one host).
internal_link_graph
Audit a folder of HTML pages as a directed internal-link graph.
lint_schema_page
Validate a page's JSON-LD against Google's structured-data requirements.
lint_schema_sitewrite action
Run ``lint_schema_page`` over every HTML file in a folder.
list_llm_engines
Return the LLM engines currently configured (have an API key).
multi_llm_citation_check
How often each configured LLM cites (or mentions) ``target_domain``.
multi_llm_query
Ask the same question to all (or selected) configured LLM engines in parallel.
openai_query
Ask ChatGPT (with web search) a question; return answer + cited URLs.
perplexity_citation_check
Citation share for ``target_domain`` across a Perplexity question batch.
perplexity_query
Ask Perplexity (Agent API + web search); return answer + cited URLs/domains.
snapshot_gscwrite action
Run a GSC performance query and persist the rows as a snapshot.
snapshot_llm_citationswrite action
Run multi-LLM citation check and persist the per-question results.
snapshot_serp_aiowrite action
Run AIO citation check via SerpAPI and persist as ``serpapi_aio`` engine rows.
suggest_internal_links
Suggest top-K internal links to add to each page in a folder.
trend_gsc
Time-series of clicks/impressions/position from stored GSC snapshots.
trend_initwrite action
Create the local SQLite snapshot DB if it doesn't exist; return its path.
trend_llm_citations
Per-snapshot citation share for ``target_domain`` over time.
trend_stats
Inventory of what's stored: row counts, sites/domains, oldest/newest snapshots.
validate_llms_txt
Validate an ``llms.txt`` file (local path or URL) against the spec.
yandex_crawl_issues
Active Yandex site diagnostics (by severity) plus sample broken internal links.
yandex_list_sites
List sites in the token owner's Yandex Webmaster account.
yandex_query_stats
Top Yandex search queries: shows, clicks, average show/click position.
yandex_site_summary
Site quality index (SQI), pages in search, excluded pages, problem counts.
yandex_submit_urlwrite action
Queue a URL for Yandex recrawl. Daily quota applies.
yandex_url_info
Indexing + search status for a URL in Yandex "Monitoring important pages".

Public scan report

scanner v0.1.10 · 2026-10-24 · same rubric, same numbers if you re-run it

no findings

Code scan44 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitystatic API keys via environment variables6/15
Maintenancelast push 1 days ago15/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Overall 83/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How geoseo-mcp compares

Against every graded SEO MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 83/100; higher than 70% of 767 SEO servers
Tools: 47; the typical SEO server has 6
Tools that change things: 23%; typical: 0%. Fewer write tools means less an agent can break
GitHub stars: 3; more than 80% of 398 SEO servers
Downloads a week: 107; more than 65% of 160 SEO servers with a package

What its tools let an agent do: 34 read · 2 create · 11 change

Install geoseo-mcp in Claude Code, Cursor or VS Code

claude mcp add geoseo-mcp -- uvx geoseo-mcp

Add to Cursor

What the publisher says

From the geoseo-mcp repository's README, as published. We do not edit it. Read it on GitHub

geoseo-mcp

An open-source MCP server for traditional SEO and Generative Engine Optimization (GEO): Google Search Console, Bing, IndexNow, Google AI Overviews, and citation tracking across ChatGPT, Claude, Gemini, Perplexity, Grok and Brave, all in one server.

Try it in 30 seconds (no API keys)

# Audit any page: title, meta, headings, schema, freshness, GEO quotability, 0-100 score
uvx geoseo-mcp audit https://example.com

# Check a site's llms.txt against the spec
uvx geoseo-mcp llms-txt https://llmstxt.org

# Same audit after running JavaScript (for SPAs); needs the [render] extra
uvx --from 'geoseo-mcp[render]' geoseo-mcp audit https://your-spa.com --render

Sample output:

$ uvx geoseo-mcp audit https://example.com
https://example.com
  score: 15/100
  title: 'Example Domain'
  words: 27

  8 issue(s):
   ✗ meta_description: Meta description should be 70-160 chars  [length=0]
   ✗ h1: Exactly one H1 expected  [found=0]
   ✗ word_count: Pages under 300 words rarely rank or get cited  [words=27]
   ✗ schema: No JSON-LD schema found; LLMs and Google use this heavily
   ✗ canonical: Missing canonical URL
   ✗ open_graph: Missing core Open Graph tags (og:title, og:description)
   ✗ freshness: No published-date signal found; LLMs deprioritize stale content
   ✗ quotability: Few short, fact-dense sentences; LLMs prefer quotable lines  [quotable_sentences=0]

  3 check(s) passed. Use --json for the full report.

Other keyless commands: audit-site ./content, generate-llms-txt ./content https://yourdomain.com, status. Run uvx geoseo-mcp --help for everything.

Poke at all 47 tools in the MCP Inspector:

npx @modelcontextprotocol/inspector uvx geoseo-mcp

Running geoseo-mcp with no arguments starts the MCP server over stdio, which is what MCP clients expect.

Add it to your MCP client

Cursor

Or add it to ~/.cursor/mcp.json by hand (see examples/cursor-mcp.json).

Claude Code

claude mcp add geoseo -- uvx geoseo-mcp

# with keys
claude mcp add geoseo \
  -e GEOSEO_OPENAI_API_KEY=sk-... \
  -e GEOSEO_PERPLEXITY_API_KEY=pplx-... \
  -- uvx geoseo-mcp

Claude Desktop

Add to ~/Library/Application Support/Claude/claudedesktopconfig.json (macOS) or %APPDATA%\Claude\claudedesktopconfig.json (Windows):

{
  "mcpServers": {
    "geoseo": {
      "command": "uvx",
      "args": ["geoseo-mcp"],
      "env": {
        "GEOSEO_OPENAI_API_KEY": "sk-...",
        "GEOSEO_ANTHROPIC_API_KEY": "sk-ant-...",
        "GEOSEO_GEMINI_API_KEY": "AIza...",
        "GEOSEO_XAI_API_KEY": "xai-...",
        "GEOSEO_BRAVE_API_KEY": "...",
        "GEOSEO_PERPLEXITY_API_KEY": "pplx-...",
        "GEOSEO_SERPAPI_API_KEY": "...",
        "GEOSEO_GOOGLE_CLIENT_SECRET": "/absolute/path/to/client_secret.json",
        "GEOSEO_BING_WEBMASTER_API_KEY": "...",
        "GEOSEO_YANDEX_OAUTH_TOKEN": "y0_...",
        "GEOSEO_INDEXNOW_KEY": "..."
      }
    }
  }
}

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

geoseo-mcp: common questions

Is geoseo-mcp server safe?: Mostly: it is graded B (83/100). Read the geoseo-mcp safety report
How do I install geoseo-mcp?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does geoseo-mcp need an API key?: Yes. The registry entry asks for GEOSEO_OPENAI_API_KEY, GEOSEO_ANTHROPIC_API_KEY, GEOSEO_GEMINI_API_KEY, GEOSEO_PERPLEXITY_API_KEY and 6 more.
Is geoseo-mcp maintained?: The last commit was 9 days ago (2026-10-23). The latest release is v0.4.0.
What can I use instead of geoseo-mcp?: Servers from other publishers that do the same job: Google Ads + Meta Ads + SEO/GEO MCP server, SEO Monster MCP server and Search Console MCP server. Compare all geoseo-mcp alternatives.
How does geoseo-mcp compare with other SEO MCP servers?: safety score 83/100 (higher than 70% of 767 SEO servers); tools 47 (the typical SEO server has 6); tools that change things 23% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to geoseo-mcp

Same job from other publishers: the closest match first, then the best rated.

All geoseo-mcp alternatives →

Google Ads + Meta Ads + SEO/GEO MCP
Google Ads, Meta Ads, Google Analytics (GA4) & Search Console MCP server by Ryze AI
not reviewed
Established
A
SEO Monster
Local-first SEO MCP: track AI citations, Search Console, GA4, PageSpeed, Cloudflare, IndexNow, CrUX.
not reviewed
Established
A
Search Console MCP
Google Search Console + Bing + GA4 + AdSense — unified SEO intelligence for AI agents.
not reviewed
Established
C
Visibly AI — SEO MCP Server
Remote SEO/GEO MCP: Search Console, keyword research, backlinks, competitor & on-page audits.
not reviewed
Growing
A
zaDojo SEO and AI visibility
SEO and AI visibility for agents: keywords, SERPs, backlinks, audits, rank and AI answer tracking.
not reviewed
Growing
A

Run it through the gateway

Local package. It runs on your machine, not through the gateway.

Rating: —
Safety grade: B · 83/100
Stars: 3
Downloads/wk: 107
Price: Free
Licence: MIT
Transport: Local · pypi
Version: 0.4.0
Category: SEO
Last release: 2026-10-23

Credentials it needs

GEOSEO_OPENAI_API_KEYsecretOpenAI API key for ChatGPT citation checks
GEOSEO_ANTHROPIC_API_KEYsecretAnthropic API key for Claude citation checks
GEOSEO_GEMINI_API_KEYsecretGemini API key for Google Search grounded checks
GEOSEO_PERPLEXITY_API_KEYsecretPerplexity API key
GEOSEO_XAI_API_KEYsecretxAI API key for Grok citation checks
GEOSEO_BRAVE_API_KEYsecretBrave Search API key (Answers plan) for Brave citation checks
GEOSEO_SERPAPI_API_KEYsecretSerpAPI key for Google AI Overviews tracking
GEOSEO_BING_WEBMASTER_API_KEYsecretBing Webmaster Tools API key
GEOSEO_YANDEX_OAUTH_TOKENsecretYandex Webmaster OAuth token
GEOSEO_INDEXNOW_KEYsecretIndexNow key hosted at https://yourdomain.com/<key>.txt
GEOSEO_GOOGLE_CLIENT_SECRETPath to a Google OAuth client_secret.json for Search Console
GEOSEO_TOOLSETSComma-separated toolsets to expose (default: all)

Own this server?

Claim it to keep the listing current and reply to reviews. Claiming never changes the grade or hides a review.

Claim listing

Badge for your README

Shows the safety grade and links back to this page. It updates itself after every scan and review.

[![mcp.market](https://mcp.market/badge/rachit8484-geoseo-mcp.svg)](https://mcp.market/server/rachit8484-geoseo-mcp)

How the badge works