geoseo-mcp
Summary: A local-first MCP server that combines traditional SEO tooling with Generative Engine Optimization (GEO) — auditing pages, tracking AI/LLM citations, and pulling data from Google Search Console, Bing, and IndexNow.
Status & config —
geoseo_status,list_llm_enginesshow which engines are configured and reachable.On-page auditing —
audit_page(URL or local file) returns title/meta/headings, word count, schema, Open Graph, freshness, GEO quotability, findings, and a 0-100 score;audit_siteaudits whole folders and surfaces worst pages.Internal linking —
internal_link_graphfinds orphans, dead-ends, hubs, and dangling links;suggest_internal_linksrecommends links with anchor hints via TF-IDF similarity.llms.txt —
generate_llms_txtdrafts a spec-compliant file from HTML folders;validate_llms_txtchecks local files or URLs against the spec.LLM citation tracking — query Perplexity, ChatGPT (OpenAI), Claude, and Gemini individually or in parallel (
multi_llm_query);multi_llm_citation_checkandperplexity_citation_checkreport citation rates and competing domains for a target domain.Google AI Overviews —
aio_checkparses AIO blocks, answers, and cited URLs via SerpAPI;aio_citation_checkreports AIO fire-rate and citation share across queries.Google Search Console — list properties, query search analytics with filters/dimensions, inspect URL index status, and submit sitemaps.
Bing Webmaster — list sites, query/page stats, URL index info, URL submission, and crawl issues.
IndexNow — notify Bing, Yandex, Naver, Seznam of single URLs or batches up to 10,000.
Trend tracking — initialize a local SQLite DB, snapshot GSC/LLM citation/AIO data, and query time series (
trend_gsc,trend_llm_citations,trend_stats).
Provides integration with Google services including Google Search Console (performance, inspections, sitemaps), Google AI Overviews (via SerpAPI), and Gemini queries with Google Search grounding.
Provides tools for interacting with Google Search Console, including listing sites, retrieving performance data, inspecting URLs, and submitting sitemaps.
Provides IndexNow submission support for Naver search engine for URL indexing.
Provides integration with OpenAI's API for querying ChatGPT with web search and checking citations.
Provides tools for querying Perplexity AI and checking citation information.
Provides local SQLite database integration for trend tracking, storing time-series snapshots of GSC, LLM citations, and AIO data.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@geoseo-mcp audit https://example.com for on-page SEO"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 --renderSample 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-mcpRunning geoseo-mcp with no arguments starts the MCP server over stdio, which is what MCP clients expect.
Related MCP server: sightvane-mcp
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-mcpClaude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.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": "..."
}
}
}
}Every key is optional; drop the ones you don't have. Other clients (Continue, Cline, Windsurf, VS Code) take the same command / args / env block. See examples/.
Then just ask:
"Which of ChatGPT, Claude, Gemini, Perplexity and Grok cite acme.com for 'best CRM for startups'? Run 3 samples each." "Audit my
./contentfolder and show the 5 worst pages." "Build the internal link graph and find orphan pages."
What it covers
Surface | Tools |
Google Search | GSC performance, URL inspection, sitemaps |
Bing Webmaster | Site stats, query/page stats, URL info, URL submission, crawl issues |
Yandex Webmaster | Site quality index, popular queries, important-page status, recrawl queue, diagnostics + broken internal links |
Bing / Yandex / Naver / Seznam | IndexNow submission |
Google AI Overviews |
|
LLM citations | ChatGPT (web search), Claude (web search), Gemini (Google Search grounding), Perplexity (Agent API), Grok (xAI web search), Brave (Answers API), plus |
On-page | Title / meta / heading / schema / internal-link audit, 0-100 score, optional JS rendering |
Internal link graph | Orphans, dead-ends, hubs, dangling links, related-page suggestions with anchor hints (TF-IDF by default, or OpenAI / Gemini / local embeddings) |
| Generate from a folder of HTML, validate against the spec |
Trend tracking | Local SQLite snapshots of GSC, LLM citations and AIO, with trend tools |
MIT licensed and local-first: your credentials and data stay on your machine.
How citation checks work
multi_llm_citation_check(questions, target_domain) asks every configured engine each question several times (samples, default 3), because LLM answers vary from run to run. For each engine you get:
citation_ratewith a 95% Wilson interval, plus a per-questioncited_rateand astableflagmention_rateandunlinked_mention_rate: answers that name your brand without linking to youtop_competing_domains: who gets cited instead of yousubdomain-aware matching (
docs.acme.comcounts foracme.com)
Brand aliases are derived from the domain (acme.com → acme) and you can pass your own via brand_aliases. Requests run in parallel up to GEOSEO_MAX_CONCURRENCY (default 8).
Rough costs
Approximate list prices as of October 2026; check each provider's pricing page before running large batches.
Engine | What we call | Approx. cost per query |
ChatGPT (pricing) | Responses API, | ~$0.01 search fee + tokens, roughly $0.01-0.02 |
Claude (pricing) | Messages API + | $10 / 1k searches + tokens |
Gemini (pricing) |
| 5,000 free grounded requests / month, then $14 / 1k + tokens |
Perplexity (pricing) | Agent API, | ~$2.50 / 1k searches + tokens |
Grok (pricing) | Responses API, | per-token + per-search-call pricing |
Brave (pricing) | Answers API, streaming with citations | ~$4 / 1k searches + $5 / M tokens |
Google AI Overviews (pricing) | SerpAPI | 250 free searches / month, then plan pricing |
A 10-question check with 3 samples across four engines is 120 calls, which is usually well under $2. Use samples=1 for quick spot checks.
Get credentials
OpenAI: API key. Uses the Responses API with the
web_searchtool. Override the model withGEOSEO_OPENAI_MODEL.Anthropic: API key. Uses Claude with the server-side web search tool.
Gemini: API key from AI Studio. Uses Google Search grounding (the same index AI Overviews use).
Perplexity: API key. Uses the Agent API with the
fastpreset; setGEOSEO_PERPLEXITY_EFFORTorGEOSEO_PERPLEXITY_MODELto change it.xAI Grok: API key from the xAI console, set as
GEOSEO_XAI_API_KEY. Uses the Responses API with theweb_searchtool; override the model (defaultgrok-4.3) withGEOSEO_GROK_MODEL.Brave Answers: API key with the Answers plan, set as
GEOSEO_BRAVE_API_KEY. Answers come from Brave's own index.SerpAPI: API key. Free plan: 250 searches/month. Used for AI Overviews tracking.
Google Search Console: see
docs/setup-gsc.md. One-time OAuth flow.Bing Webmaster: API key from Bing Webmaster Tools → Settings → API access.
Yandex Webmaster: OAuth token. Register an app with both
webmaster:hostinfoandwebmaster:verify(hostinfo alone only lists sites), then get a token viahttps://oauth.yandex.com/authorize?response_type=token&client_id=<id>and setGEOSEO_YANDEX_OAUTH_TOKEN. Docs.IndexNow: any random 32-char hex string hosted at
https://yourdomain.com/<key>.txt. Spec.
Tools that need a key you haven't set return a clear error; everything else keeps working.
Configuration
Env var | Default | What it does |
| all | Comma-separated toolsets to expose: |
|
| Default samples per question for |
|
| Max parallel LLM requests. |
|
| Model for ChatGPT checks. |
|
| Model for Claude checks. |
|
| Model for Gemini checks. |
|
| Model for Grok checks. |
|
| Perplexity Agent API preset, or a pinned model. |
|
|
|
|
| Bind address for HTTP. |
| user data dir | SQLite file for trend snapshots. |
Example: only the keyless audit tools, for a lean agent context:
"env": { "GEOSEO_TOOLSETS": "audit,graph" }Streamable HTTP
uvx geoseo-mcp serve --transport http --port 8000
# MCP endpoint: http://127.0.0.1:8000/mcpIt binds to localhost by default. There is no built-in auth, so put it behind a proxy you trust before exposing it anywhere.
JavaScript rendering
audit_page reads raw HTML by default. If a page looks like a JS shell (an empty SPA root or almost no text), it adds a js_rendering finding. Install the extra and pass render=True (or --render on the CLI) to audit the rendered DOM:
pip install 'geoseo-mcp[render]' && playwright install chromiumTools (47)
Status:
geoseo_status,list_llm_enginesGoogle Search Console:
gsc_list_sites,gsc_performance,gsc_inspect_url,gsc_submit_sitemapBing Webmaster:
bing_list_sites,bing_query_stats,bing_page_stats,bing_url_info,bing_submit_url,bing_crawl_issuesYandex Webmaster:
yandex_list_sites,yandex_site_summary,yandex_query_stats,yandex_url_info,yandex_submit_url,yandex_crawl_issuesIndexing:
indexnow_submit_url,indexnow_submit_urlsLLM citations:
perplexity_query,perplexity_citation_check,openai_query,claude_query,gemini_query,grok_query,brave_query,multi_llm_query,multi_llm_citation_checkGoogle AI Overviews:
aio_check,aio_citation_checkOn-page:
audit_page,audit_site,find_broken_external_links,lint_schema_page,lint_schema_siteLink graph:
internal_link_graph,suggest_internal_linksllms.txt:
generate_llms_txt,validate_llms_txtTrends:
trend_init,trend_stats,snapshot_gsc,snapshot_llm_citations,snapshot_serp_aio,trend_gsc,trend_llm_citations
suggest_internal_links uses TF-IDF by default (offline, free). Pass mode="openai", "gemini" or "local" (sentence-transformers) for embedding similarity; vectors are cached in SQLite by content hash.
For Yandex tools, pass a normal URL as site; it's matched to the Yandex host id (https:example.com:443), following the main mirror. yandex_url_info only covers pages in "Monitoring important pages" (Yandex has no arbitrary-URL inspect endpoint).
Snapshots are append-only and stored at $GEOSEO_DB. Schedule the snapshot_* tools weekly to build a private time series of your AI-search visibility.
Roadmap
Tracked in issues. Shipped in 0.4: broken-link prospector, schema linter, Grok and Brave citation engines, embedding-based link suggestions, Yandex Webmaster.
Contributing
PRs welcome. Each engine is a module in src/geoseo_mcp/engines/ that exposes query() and returns the standard {engine, question, model, answer, citations, cited_domains, usage} shape; tools live in src/geoseo_mcp/tools/. See docs/architecture.md.
git clone https://github.com/Rachit8484/geoseo-mcp.git && cd geoseo-mcp
uv sync --extra dev
uv run ruff check src tests && uv run pytestLicense
MIT. See LICENSE.
Available Tools
47 toolsaio_checkA
Run a Google search via SerpAPI and parse the AI Overview block.
Returns aio_present, the AIO answer text, the URLs/domains AIO
cites, and the top-10 organic results for context. Use this to
track which pages Google's generative answers actually source.
Inputs: query (required), gl, hl, location, +1 more. Returns: object
aio_citation_checkA
For a batch of queries, report AIO fire-rate and citation share for target_domain.
This is the GEO companion to multi_llm_citation_check — same
idea, but specifically for Google's on-SERP AI Overviews. Run
weekly and snapshot to snapshot_serp_aio to track AIO
visibility over time.
Inputs: queries (required), target_domain (required). Returns: object
audit_pageA
Audit a single page (local file path or http(s) URL).
Set render=True to audit the page after JavaScript runs (needs the
optional geoseo-mcp[render] extra + playwright install chromium).
Either way the report flags pages that are empty without JavaScript,
since most AI crawlers don't execute it.
Returns a structured report with: title/meta/headings, word count,
link counts, image alt coverage, JSON-LD schema types, Open Graph,
Twitter Card, freshness signals, GEO-quotability score, and a list
of human-readable findings. Plus a 0-100 overall score.
Examples:
audit_page("seo/aa-meetings-what-to-expect.html")
audit_page("https://soberpath.com/blog/quit-drinking")
Inputs: source (required), render. Returns: object
audit_siteA
Recursively audit every HTML file under a folder.
Returns per-file scores, an aggregate summary (mean score, worst pages, most common findings), and the top opportunities for improvement.
Useful as the first call against a content directory to spot the worst offenders quickly.
Inputs: folder (required), limit, pattern. Returns: object
bing_crawl_issuesC
Crawl errors / blocked URLs / DNS issues reported by Bingbot.
Inputs: site_url (required). Returns: object
bing_list_sitesB
List all Bing-verified sites for the API key owner.
Inputs: no named parameters. Returns: object
bing_page_statsC
Per-page stats from Bing Webmaster.
Inputs: site_url (required). Returns: object
bing_query_statsA
Last-6-months query stats from Bing Webmaster (clicks, impressions, position).
site_url must match what Bing has verified, e.g. https://example.com/.
Inputs: site_url (required). Returns: object
bing_submit_urlB
Submit a URL for fast crawling. Daily quota applies (default ~10/day).
Inputs: url (required), site_url (required). Returns: object
bing_url_infoC
Index status + crawl info for a single URL on Bing.
Inputs: url (required), site_url (required). Returns: object
brave_queryB
Ask Brave's AI Answers (grounded in Brave Search); return answer + cited URLs.
Brave runs its own independent web index, so it is a useful extra
signal next to Google/Bing-backed engines. Requires the Brave Answers
plan (GEOSEO_BRAVE_API_KEY).
Inputs: question (required), country, language. Returns: object
claude_queryB
Ask Claude (with server-side web search) a question; return answer + cited URLs.
Inputs: question (required), model, max_tokens, system_prompt. Returns: object
find_broken_external_linksA
Find dead, redirected, or flaky outbound links across a folder of HTML.
Every external <a href> is collected (mailto:, tel:,
javascript: and in-page anchors are skipped) and each unique URL is
checked once with HEAD, falling back to GET for servers that refuse
HEAD. Results are grouped as ok / redirect / client_error /
server_error / timeout / dns_fail / error, and every
non-ok link lists the pages it appears on plus a suggested action.
site_host (e.g. "example.com") marks absolute links to your own
site as internal so they're skipped. Results are cached locally for
cache_days (set 0 to force a fresh check); timeouts are never cached.
Inputs: folder (required), pattern, timeout, max_urls, +4 more. Returns: object
gemini_queryA
Ask Gemini (with Google Search grounding) a question; return answer + cited URLs.
Grounding sources here are the same signal Google uses for AI Overviews, so this is the closest open-API proxy for "what AIO might cite for this query".
Inputs: question (required), model, system_prompt. Returns: object
generate_llms_txtA
Generate a draft llms.txt from a folder of HTML pages.
llms.txt (https://llmstxt.org) is the emerging standard for telling
LLM crawlers where your canonical content lives. This tool reads each
page's <title> and meta description, groups by URL prefix, and
produces spec-compliant Markdown ready to drop at /llms.txt.
section_strategy controls grouping:
- first_path_segment (default): groups by first URL path
segment, e.g. all /blog/... pages under "Blog".
- flat: a single "Pages" section.
Inputs: folder (required), site_url (required), limit, pattern, +3 more. Returns: object
geoseo_statusA
Report which engines are configured and reachable.
Always safe to call. Returns a dict keyed by engine name with
configured: bool and a short message. Use this as the first call
in a session to know what's available.
Inputs: no named parameters. Returns: object
grok_queryA
Ask Grok (with live web search) a question; return answer + cited URLs.
Uses the xAI Responses API with the web_search tool. citations
are the URLs Grok actually cites inline; sources_considered lists
everything it looked at. Set x_search=True to also search X posts.
Default model: GEOSEO_GROK_MODEL (grok-4.3).
Inputs: question (required), model, x_search, system_prompt. Returns: object
gsc_inspect_urlA
Get index status for a specific URL via the URL Inspection API.
Returns coverage state, last crawl time, mobile usability, indexed verdict, and indexing rich-result data. Slow (~1s/call); rate-limited by Google.
Inputs: url (required), site_url (required), language_code. Returns: object
gsc_list_sitesA
List all Search Console properties the authenticated user can access.
Returns a list of site entries with siteUrl and permissionLevel.
Use siteUrl from this list as input to other gsc_* tools.
Inputs: no named parameters. Returns: object
gsc_performanceC
Query GSC search analytics.
Inputs: site_url (required), device, country, end_date, +4 more. Returns: object
gsc_submit_sitemapC
Submit (or resubmit) a sitemap URL to GSC.
feedpath is the absolute URL of the sitemap, e.g.
https://example.com/sitemap.xml.
Inputs: feedpath (required), site_url (required). Returns: object
indexnow_submit_urlB
Notify Bing, Yandex, Naver, Seznam, and Yep that a single URL was published or updated.
Requires GEOSEO_INDEXNOW_KEY env var (a 32-char hex string you also
host at https://yourdomain.com/<key>.txt).
Inputs: url (required). Returns: object
indexnow_submit_urlsA
Batch-notify search engines about up to 10,000 URLs (must share one host).
Best for sitemap-wide rebuilds or large content updates.
Inputs: urls (required). Returns: object
internal_link_graphA
Audit a folder of HTML pages as a directed internal-link graph.
Returns counts of files/edges, the orphans (no inbound links), dead-ends (no outbound links), top hub pages, and a list of dangling internal hrefs that don't resolve to any file.
Pass site_host (e.g. "example.com") if pages link to
themselves with absolute URLs — those will then count as internal
edges. Files are also matched by URL slug, so /blog/foo
resolves to foo.html even when paths don't match exactly.
Inputs: folder (required), limit, pattern, site_host. Returns: object
lint_schema_pageA
Validate a page's JSON-LD against Google's structured-data requirements.
source is a local HTML file or an http(s) URL. Every
application/ld+json block is parsed (@graph included) and each
typed entity is checked against Google's documented required and
recommended properties for Article, Product (with nested Offer /
AggregateRating / Review), Recipe, LocalBusiness, BreadcrumbList, Event,
VideoObject, SoftwareApplication, JobPosting, QAPage, Review and
Organization. FAQPage and HowTo are checked against schema.org since
Google no longer shows those rich results.
Returns per-entity {type, ok, required_missing, recommended_missing, line_estimate, doc}. ok is false when a required property is
missing or the JSON is invalid.
Inputs: source (required). Returns: object
lint_schema_siteA
Run lint_schema_page over every HTML file in a folder.
Returns files with errors, files that have no JSON-LD at all, a count of schema types found, the most common missing required properties, and per-file problems.
Inputs: folder (required), limit, pattern. Returns: object
list_llm_enginesA
Return the LLM engines currently configured (have an API key).
Inputs: no named parameters. Returns: object
multi_llm_citation_checkA
How often each configured LLM cites (or mentions) target_domain.
The headline GEO/AEO tool. Feed it your top 20-50 buyer questions and get a per-engine breakdown for ChatGPT/Claude/Gemini/Perplexity/Grok/Brave:
citation_rate(+ 95% interval): share of answers linking to your domain or any subdomain of it.mention_rate/unlinked_mention_rate: answers that name your brand, with or without a link. Passbrand_aliases(e.g.["Acme", "Acme CRM"]) if your brand isn't obvious from the domain.top_competing_domainsand per-question results.
LLM answers vary run to run, so every question is asked samples
times per engine (default GEOSEO_CITATION_SAMPLES, 3; max 10).
Cost scales with questions x samples x engines.
Inputs: questions (required), target_domain (required), engines, samples, +2 more. Returns: object
multi_llm_queryA
Ask the same question to all (or selected) configured LLM engines in parallel.
engines: optional subset of ["perplexity","openai","anthropic","gemini","grok","brave"].
Default: every engine with credentials configured (see geoseo_status).
Engines that error are reported per-engine and don't block the others.
Inputs: question (required), engines. Returns: object
openai_queryB
Ask ChatGPT (with web search) a question; return answer + cited URLs.
Uses the OpenAI Responses API with the web_search tool.
Default model: GEOSEO_OPENAI_MODEL (gpt-5-mini).
Inputs: question (required), model, system_prompt. Returns: object
perplexity_citation_checkC
Citation share for target_domain across a Perplexity question batch.
Inputs: questions (required), target_domain (required), model. Returns: object
perplexity_queryB
Ask Perplexity (Agent API + web search); return answer + cited URLs/domains.
Defaults to the fast effort preset. Pass model to pin one
(e.g. openai/gpt-5-mini); legacy names like sonar still work.
Inputs: question (required), model, max_tokens, system_prompt. Returns: object
snapshot_gscB
Run a GSC performance query and persist the rows as a snapshot.
Run this on a schedule (cron, n8n, launchd — anything that can
invoke an MCP tool) to build a local time-series of search
performance. Default dimensions: ["query"].
Inputs: site_url (required), end_date, row_limit, dimensions, +2 more. Returns: object
snapshot_llm_citationsA
Run multi-LLM citation check and persist the per-question results.
Builds the dataset behind trend_llm_citations. engines
defaults to every configured LLM (see geoseo_status). With
samples > 1 a question is stored as cited when most samples cite you.
Inputs: questions (required), target_domain (required), engines, samples. Returns: object
snapshot_serp_aioC
Run AIO citation check via SerpAPI and persist as serpapi_aio engine rows.
Inputs: queries (required), target_domain (required). Returns: object
suggest_internal_linksA
Suggest top-K internal links to add to each page in a folder.
By default uses TF-IDF cosine similarity over <title>, headings,
meta description and body text (offline, free). Set mode to
"openai" (text-embedding-3-small), "gemini"
(gemini-embedding-001) or "local" (sentence-transformers) for
embedding similarity; model overrides the default model. Vectors
are cached in SQLite by content hash, so re-runs are cheap. Excludes links the source already has, plus
the page itself. Returns suggestions for page only if
provided, otherwise for every page.
Each suggestion includes a cheap anchor_hint derived from
terms shared between source headings and target title.
Inputs: folder (required), mode, page, limit, +4 more. Returns: object
trend_gscA
Time-series of clicks/impressions/position from stored GSC snapshots.
Aggregates by captured_at. Filter by query and/or page
to drill in. Returns up to limit most recent snapshots in
chronological order.
Inputs: site_url (required), page, limit, query. Returns: object
trend_initB
Create the local SQLite snapshot DB if it doesn't exist; return its path.
Inputs: no named parameters. Returns: object
trend_llm_citationsB
Per-snapshot citation share for target_domain over time.
engine filters to one of perplexity|openai|anthropic|gemini|serpapi_aio.
Returns rows of {captured_at, engine, questions, cited, citation_share}.
Inputs: target_domain (required), limit, engine. Returns: object
trend_statsB
Inventory of what's stored: row counts, sites/domains, oldest/newest snapshots.
Inputs: no named parameters. Returns: object
validate_llms_txtA
Validate an llms.txt file (local path or URL) against the spec.
Returns parsed structure plus an issues list with line numbers for
any violations (missing H1, broken link syntax, non-http(s) URLs, etc).
Inputs: source (required). Returns: object
yandex_crawl_issuesC
Active Yandex site diagnostics (by severity) plus sample broken internal links.
Inputs: site (required). Returns: object
yandex_list_sitesA
List sites in the token owner's Yandex Webmaster account.
Inputs: no named parameters. Returns: object
yandex_query_statsA
Top Yandex search queries: shows, clicks, average show/click position.
order_by: TOTAL_SHOWS or TOTAL_CLICKS. device: ALL,
DESKTOP, MOBILE_AND_TABLET, MOBILE, TABLET. Dates are
YYYY-MM-DD; defaults to the last week.
Inputs: site (required), limit, device, date_to, +2 more. Returns: object
yandex_site_summaryB
Site quality index (SQI), pages in search, excluded pages, problem counts.
site can be a URL (https://example.com/) or a Yandex host id
(https:example.com:443).
Inputs: site (required). Returns: object
yandex_submit_urlC
Queue a URL for Yandex recrawl. Daily quota applies.
Inputs: url (required), site (required). Returns: object
yandex_url_infoC
Indexing + search status for a URL in Yandex "Monitoring important pages".
Inputs: url (required), site (required). Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 47 tools
Most provider-specific tools are distinguishable, but the set has notable overlap among aggregate vs provider-specific citation tools and snapshot/trend variants (e.g. multi_llm_citation_check, perplexity_citation_check, snapshot_llm_citations; aio_check, aio_citation_check, snapshot_serp_aio). An agent could reasonably misselect when asked to track or compare citation visibility.
Almost all tools use snake_case and many follow a provider_prefix_action pattern (gsc_*, bing_*, yandex_*), which is readable. However, ordering varies between provider_action, action_object, and entity_action (audit_page, trend_gsc, geoseo_status), so it is consistent but not uniform.
47 tools is far above the typical 3-15 range and creates a heavy selection surface for an agent. While the domain is broad, many tools are provider variants, aggregate wrappers, or snapshot/trend companions that could be consolidated.
The surface covers an unusually wide GEO/SEO lifecycle: multiple webmaster APIs, IndexNow submission, LLM/AIO citation checks, page/site audits, schema and link linting, llms.txt generation/validation, and trend snapshots. Minor gaps exist around destructive/update operations and broader sitemap management, but core workflows are well covered.
Maintenance
Related MCP Connectors
Monitor brand visibility, citations, competitors, sentiment, and GEO performance in AI search.
AI-search visibility: GEO audits, tracked prompts, competitors, citations.
SEO, GEO & AI Visibility — research, write, optimize, publish & monitor content. 121 tools.
SEO, GEO and ADA/WCAG audits, AI citation tracking and site crawls for AI assistants.
Related MCP Servers
- AlicenseBqualityFmaintenanceGEO (Generative Engine Optimisation). This tool shows you exactly how AI search engines see your content - claim density, writing quality, E-E-A-T signals, extractability. Research-backed metrics that correlate with 40% higher AI citation rates.260 npm21MIT
- -licenseNot gradedqualityCmaintenanceEnables AI assistants to perform comprehensive SEO and GEO measurements, including site audits, keyword research, ranking tracking, and brand visibility analysis across search engines and generative AI platforms.-
- AlicenseNot gradedqualityBmaintenanceConnects AI agents to live SEO data and hosted tools for site audits, keyword research, competitor analysis, local SEO, and link prospecting, with guided workflows for structured search optimization.2MIT
- AlicenseNot gradedqualityCmaintenanceEnables agents to research competitors, keywords, ads, and AI citations, and to audit public websites for SEO, AEO, and GEO readiness with prioritized fixes.MIT