vantage-mcp
Vantage is an MCP server for AI visibility: it measures whether ChatGPT, Gemini and Perplexity cite your domain, who gets cited instead, and what to change to get cited.
Check citation coverage (
analyze_citation_coverage): test up to 10 keywords against a domain per engine/market, with multiple samples, cited vs. merely mentioned reported separately, and 180-day change tracking (previous,change,newly_cited).Find questions that already cite you (
find_cited_questions): start from your domain and get the most-asked questions where it is cited, your position, and who else is cited.See who wins a topic (
find_citation_leaders): top cited domains for a keyword, plus rank checks for one domain or up to 10 competitors side by side.Track visibility over time (
analyze_citation_trend): month-by-month citation counts for a domain and up to 5 competitors, with up/down/flat direction.Analyze winning answers (
analyze_citation_structure,..._batch): the shape of the cited answer — list-led, opening length, table, section outline, source count and domains — for one topic or up to 10 at once.Get a fix brief for your page (
analyze_citation_gap): diff your URL against the cited answer and return ordered rewrite instructions, ending in one off-site step from the answer's source mix.Read your own history (
get_check_history): past coverage checks for a domain, keyword, or a single page, newest first, free.Check quota and valid arguments (
get_usage,get_supported_options): remaining monthly units, plus supported engines, platforms, markets and per-call limits, free.Source-mix signal: most tools report how much of a topic's citations go to community sites (Reddit, YouTube, X, Quora) versus other domains.
Market coverage: optional
country/languageon most tools; live-answer tools work in any supported market, whilefind_citation_leadersandanalyze_citation_trendhave ChatGPT data for the US/English only (useplatform: "google"elsewhere).
Allows checking whether a domain is cited in Perplexity answers, analyzing citation leaders for a topic, and inspecting the citation structure of winning answers.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
Vantage: the AI visibility MCP server
Find out whether ChatGPT, Gemini and Perplexity cite your site, and what to change if they don't.
Vantage is an MCP server. Your coding agent (Claude Code, Cursor, VS Code, or any MCP client) asks it which questions already cite your domain, who is cited instead, how the winning answer is built, and how your page differs. No dashboard to read: the answer comes back where you are working.
Add to Cursor · Add to VS Code · Try one check with no account
Claude Code:
claude mcp add --transport http vantage https://vantagemcp.dev/mcpFree tier: 30 units a month, no card. Sign in with your email the first time a tool runs.
https://github.com/user-attachments/assets/38df5876-16ac-403d-b39f-170a2458cfb1
A real check on vantagemcp.dev, 50 seconds, not sped up. Answers vary run to run: this keyword was cited in 0 of 3 answers earlier today (see the output below) and in 1 of 3 here, which is why Vantage reports cited_runs.
What a real check looks like
We ran Vantage on its own domain on 19 October 2026: five questions people ask when they look for a tool like this, three ChatGPT answers per question. Output trimmed to fit; the values are as returned.
> Is vantagemcp.dev cited by ChatGPT for these five questions? Read three answers each.
< analyze_citation_coverage(
domain: "vantagemcp.dev",
keywords: ["ai visibility mcp server", "check if chatgpt cites my website",
"llm citation tracking tool", "ai search visibility tool", "mcp server for seo"],
brand: "Vantage", samples: 3)
{
"keywords_checked": 5,
"keywords_cited": 0,
"coverage_pct": 0.0,
"results": [
{
"keyword": "ai visibility mcp server",
"cited": false, "cited_runs": 0, "samples_ok": 3,
"source_frequency": [
{ "domain": "github.com", "runs": 2 },
{ "domain": "www.npmjs.com", "runs": 2 },
{ "domain": "seekinweb.com", "runs": 1 }
],
"previous": { "checked_at": "2026-10-01", "cited_runs": 0 },
"change": "same"
},
{
"keyword": "llm citation tracking tool",
"cited": false, "cited_runs": 0, "samples_ok": 3,
"source_frequency": [
{ "domain": "www.tryprofound.com", "runs": 3 },
{ "domain": "otterly.ai", "runs": 3 },
{ "domain": "ahrefs.com", "runs": 3 }
],
"change": "first_check"
}
]
}Not cited for any of the five, and that is the point of checking. Each result is remembered for 180 days, so
the next run reports change and newly_cited instead of starting from nothing. From there the agent can call
analyze_citation_gap on a page and get an ordered fix brief.
Related MCP server: ai-visibility-mcp
Tools
Ten tools. Units are what a call costs against your monthly quota (Free: 30, Pro: 500, Scale: 1,500).
Tool | Answers | Units |
| Which engines, platforms and markets each tool accepts, and the per-call limits | 0 |
| How much of this month's quota is left | 0 |
| Your earlier coverage results for a domain, newest first | 0 |
| Which questions already cite your domain, most asked first | 10 |
| Which of up to 10 keywords cite a domain, and which do not | 1 per keyword per sample |
| How your page differs from the answer that is cited, plus a fix brief | 1 |
| How the winning answer for a topic is built | 1 per sample |
| The same, across up to 10 related topics | 1 per keyword |
| Who dominates AI citations for a topic | 10 |
| Month-by-month citation counts for a domain | 1 per domain |
Install
Claude Code, Cursor, VS Code: use the buttons or the command at the top. All three sign in to Vantage in your browser on first use.
Any client that supports MCP sign-in (OAuth): add https://vantagemcp.dev/mcp with no key and sign in with
an email (a free account) or an existing key.
Any other client: add to its MCP config:
{
"mcpServers": {
"vantage": {
"url": "https://vantagemcp.dev/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}A client that only starts local commands: use the npm package
vantage-ai-visibility-mcp, which connects to the
same hosted server:
{
"mcpServers": {
"vantage": {
"command": "npx",
"args": ["-y", "vantage-ai-visibility-mcp"],
"env": { "VANTAGE_API_KEY": "YOUR_API_KEY" }
}
}
}Get a free API key at vantagemcp.dev. To try before installing, vantagemcp.dev/check runs a real check with no account, no email and no card: give it a keyword and it returns the measured shape of the answer ChatGPT cites for it.
Published on the Official MCP Registry under the
domain-verified namespace dev.vantagemcp/vantage.
Tools in detail
get_supported_options
Which engines, platforms and markets each tool accepts, and the per-call limits. Costs 0 units; a fixed list.
"Which markets can I check?"
get_usage
How much of this billing period's quota is left, before spending any of it. Costs 0 units: reads Vantage's own record, never calls the paid data provider.
"How many checks do I have left?"
find_cited_questions
Starts from your domain instead of a keyword: the questions where AI answers already cite it, most asked first. 10 units.
"What does ChatGPT already cite us for?"
analyze_citation_coverage
Which of several prompts actually cite a specific domain, and which don't, up to 10 keywords in one call. ChatGPT, Gemini or Perplexity (engine), 1 unit per keyword per sample. Pass samples=3 to get "cited in 2 of 3 answers" instead of one yes or no. Each result is remembered for 180 days, so the next check reports what changed (previous, change, newly_cited).
Cited and named are reported separately. An answer can name your brand without linking you (mentioned_not_cited: the model already knows you, it just isn't citing you) or link a page it never names. Pass brand (e.g. "Notion") so the name check looks for your real brand instead of a guess from the domain.
"Out of everything we care about, where do we already show up?"
get_check_history
Your earlier analyze_citation_coverage results for a domain, newest first. 0 units.
"Did our changes last week move anything?"
find_citation_leaders
Who dominates AI-answer citations for a topic, and whether a domain is among them.
"Who's winning AI search for this?"
analyze_citation_trend
Month-by-month mention counts for a domain, so you can see whether visibility is growing or fading.
"Is our AI visibility improving?"
analyze_citation_structure
How the winning AI answer for a topic is actually shaped: list-led, sources cited, opening length.
"What does a winning answer look like?"
analyze_citation_structure_batch
Same as analyze_citation_structure, across up to 10 related topics in one call, for content planning across a cluster.
"What do winning answers look like across this whole topic cluster?"
analyze_citation_gap
Diffs your own page's structure against the winning AI-cited answer for the same keyword and returns a fix_brief: ordered rewrite instructions your agent can carry out on the page (opening, sections, the answer's points your page does not cover, table, sources), ending with one step beyond the page: which community sites or other websites the answer relies on. The brief never contains the cited answer's text.
"What should I actually change on this page to get cited?"
Source mix
Every tool that returns cited domains also returns source_mix: how much of them are community sites (Reddit, YouTube, X, Quora and similar) and which. A high share means the topic is won by what people say about a brand elsewhere, not by any one site's pages.
Country and language
Every tool except get_usage takes optional country (e.g. "Italy") and language (e.g. "it"), default United States / en. Tools that read a live ChatGPT answer work in any supported market; find_citation_leaders and analyze_citation_trend only have ChatGPT data for the United States in English, so use platform: "google" for other countries.
What it can and cannot tell you
Answers change from run to run. One answer is a sample, not a verdict. Use
samples=3before telling anyone they are or are not cited.Cited is not the same as named. Vantage reports a link to your domain and a mention of your brand separately, and never merges them.
It reads what a person would see. ChatGPT and Gemini results are the answers a person sees in those apps, fetched through DataForSEO; Perplexity results come from its search API. It cannot see private conversations, and a result is the answer at the time of the check (
modelandchecked_atare on every result).A fix brief is a hypothesis. It shows how your page differs structurally from the answer that is cited. Page shape gets a page into the running; being cited is decided mostly by what other sites say about the brand, which is why every brief ends with an off-site step.
Agent skill
vantage-citation-audit teaches your agent the whole loop:
measure which keywords cite you, diagnose one page, apply the fix brief, re-check. It only describes the workflow;
every check is a Vantage tool call.
Monthly research
Every month Vantage asks ChatGPT, Gemini and Perplexity the same everyday questions and publishes which sites they cite, by engine and topic, with the raw data: vantagemcp.dev/research. Free to quote.
Running your own instance
This repo is the MCP server itself: API-key auth, usage metering, one tool per read (see Tools above). Billing and account provisioning are a separate internal service, not included here.
uv pip install -e .
export DATAFORSEO_USERNAME=...
export DATAFORSEO_PASSWORD=...
# stdio (local MCP client, e.g. Claude Desktop config pointing at this command)
python -m vantage_mcp.server
# streamable-http (network service, bind to loopback behind your own reverse proxy)
export VANTAGE_PORT=8420
python -m vantage_mcp.server --httpRequires a DataForSEO account for the underlying SERP/AI-answer data.
Not to be confused with: vantage.sh, a cloud cost-management company with its own, unrelated MCP server also named Vantage. Different product, same name.
Star it
Useful? A star on GitHub helps others find it. Already starred? Tell us what brought you here: support@vantagemcp.dev.
License
MIT
Available Tools
10 toolsanalyze_citation_coverageCheck if AI cites your siteARead-onlyIdempotentInspect
Check which of several prompts/keywords actually cite a specific domain, and which ones don't. It answers "out of everything we care about, where do we already show up, and where are we invisible"; its not_cited list is the set of keywords worth a closer look.
Read-only for the caller, safe to retry. Costs 1 quota unit per keyword per sample (1 sample by default; free tier is 30 units/month shared across every metered tool, so up to 30 keyword checks that period if nothing else is used). A per-keyword provider error doesn't fail the whole call - that keyword's entry just carries an "error" field instead. On the hosted endpoint each keyword's result is remembered for 180 days against your API key, so the next check of the same domain and keyword reports what changed (see "previous" and "change"); get_check_history reads that record back for free.
Returns: {"domain", "engine", "samples", "keywords_checked" (int, excludes any that errored), "keywords_cited" (int), "coverage_pct" (float, 0-100), "not_cited" (list of the keyword strings where domain was not cited - the actionable list), "newly_cited" and "no_longer_cited" (keywords whose status flipped since your last check of them), "results" (one entry per keyword, in the order given: {"keyword", "cited" (bool: cited in at least half of the samples), "cited_runs" (how many sampled answers cited it), "samples_ok" (how many answers came back), "rank" (int|null, best 1-based position among the answers' sources, null when never cited), "cited_pages" (list of your own page URLs the answers cited, empty when none - saved with the check, so get_check_history can follow one page over time), "num_sources_cited", "source_domains" (who IS cited, for a keyword you are not in), "source_mix" (how much of that is community sites such as Reddit, YouTube, X - where to get discussed to close the gap), "source_frequency" (only with samples above 1: {"domain", "runs"} per domain), "leads_with_list", "opening_word_count", "mentioned" (bool - the answer's text names the domain or brand in at least half of the samples, whether or not it links to it), "model", "checked_at", "previous" ({"checked_at", "cited_runs", "samples", "best_rank"} from your last check of this domain and keyword on the same engine and market with the same number of samples, or null), "change" ("first_check", "up", "down" or "same", comparing citation rates)}, or {"keyword", "error"} for one that failed), "keywords_mentioned" (int), "mentioned_not_cited" (keywords where the answer names you but does not cite you - the model already knows you, it just isn't linking you), "mention_terms" (exactly what was looked for in the answer text)}. "Cited" and "mentioned" are separate claims and are never merged. Answers change from run to run: with samples=1 a single answer decides "cited", so one sample is weak evidence either way.
Args: domain: bare domain to check, e.g. "example.com" (no https://, no www). keywords: prompts/topics to check it against, e.g. ["best project management software", "asana alternatives", "free project management tool"]. Max 10. brand: optional brand name to look for in the answer text, e.g. "Notion". Without it, the domain's first label is used ("notion" for notion.so), which can match an ordinary word by accident for a dictionary-word domain, so pass the real brand when known. country: market to read the answers in, e.g. "Italy". Defaults to "United States". language: language code, e.g. "it". Defaults to "en". Write the keywords in that language too. engine: "chat_gpt" (default), "gemini" or "perplexity", as in analyze_citation_structure. samples: independent answers to read per keyword, 1 to 5. Default 1.
Inputs: domain (required), keywords (required), brand, engine, +3 more.
analyze_citation_gapCompare your page with the cited answerARead-onlyIdempotentInspect
Compare your own page's structure against the AI-generated answer actually cited for this keyword, and return a fix brief: ordered rewrite instructions for your page, not just a description of the winner. Use this to answer 'what should I change on this page to get cited' rather than only 'what does a winning answer look like'. The fix brief never contains the cited answer's text.
Read-only: no side effects, safe to retry. Costs 1 quota unit/call (free tier is 30 units/month shared across every metered tool, so up to 30 calls to this tool alone if nothing else is used that period).
Returns: {"keyword", "your_url", "winning" (structure of the AI-cited answer, same shape as analyze_citation_structure), "yours" (same structure computed for your_url, including its own "outline" and "has_table", with "num_links_out"/"linked_domains" standing in for source count), "gaps" (list of plain-English differences worth acting on), "possibly_missing" (heads from the winning outline whose key words mostly do not appear on your page; word matching, so check each before adding it), "fix_brief" (list of instructions, most important first: opening, number, list, sections, missing points, table, sources, then a reminder to write in your own words - or a "no structural change indicated" line when every check already matches - and always last, one off-site step drawn from the winning answer's source_mix: which community sites (Reddit, YouTube, X...) it cites, or which other sites to get mentioned on. Page shape gets a page into the running; being cited is decided mostly by what other sites say about the brand)}, or {"error"} if either side couldn't be fetched/parsed.
Args: keyword: the topic/query to check, e.g. "best project management tool". your_url: full URL of your own page to compare, e.g. "https://example.com/best-project-management-tools". country: market to read the cited answer in, e.g. "Italy". Defaults to "United States". language: language code, e.g. "it". Defaults to "en". engine: "chat_gpt" (default), "gemini" or "perplexity": whose answer to compare your page against.
Inputs: keyword (required), your_url (required), engine, country, +1 more.
analyze_citation_structureAnalyze a winning AI answerARead-onlyIdempotentInspect
Analyze the structural shape of the AI-generated answer actually cited for a keyword: does it lead with a list, how long is the opening passage, how many sources does it cite and from which domains. Use this to understand what a winning AI-search answer looks like for a topic, e.g. before writing content meant to get cited.
Read-only: no side effects, safe to retry. Costs 1 quota unit per sample (1 by default; free tier is 30 units/month shared across every metered tool, so up to 30 single-sample calls to this tool alone if nothing else is used that period).
Returns: {"keyword", "engine", "model" (the answering model's version, as the provider reports it), "checked_at" (when the answer was fetched, UTC), "leads_with_list" (bool), "opening_word_count" (int), "opening_has_number" (bool), "outline" (list of up to 12 section heads, in order: the answer's headings, or its top-level list items when it has fewer than two headings; heads only, never the text under them), "has_table" (bool), "num_sources_cited" (int), "source_domains" (list of up to 10 domain strings), "source_urls" (the exact cited page URLs, up to 30, so you can see which page of a domain was cited), "source_mix" ({"community_pct" (share of those sources that are community sites such as Reddit, YouTube, X, Quora), "community_domains", "other_domains"}), "country", "language"}. With samples above 1 the shape fields describe the first answer, plus "samples_ok" (answers that came back) and "source_frequency" (list of {"domain", "runs"}: how many of the answers cited each domain, most often first). Answers change from run to run, so a domain cited in every sample is a far stronger signal than one sample.
Args: keyword: the topic/query to analyze, e.g. "how to reduce churn". country: market to read the answer in, e.g. "Italy". Defaults to "United States". For perplexity a 2-letter code also works. language: language code, e.g. "it". Defaults to "en". Write the keyword in that language too. engine: "chat_gpt" (default), "gemini" or "perplexity". chat_gpt and gemini are the answers a person sees in those apps; perplexity is Perplexity's sonar API with web search. samples: how many independent answers to read, 1 to 5. Default 1.
Inputs: keyword (required), engine, country, samples, +1 more.
analyze_citation_structure_batchAnalyze winning AI answers in bulkARead-onlyIdempotentInspect
Analyze the structural shape of the winning AI answer across several related keywords/topics in one call: does each lead with a list, how long is the opening, how many sources it cites. It covers a topic cluster in one call, for content planning across related pieces.
Read-only: no side effects, safe to retry. Costs 1 quota unit per keyword in the batch (free tier is 30 units/month shared across all the metered tools, so up to 30 keywords total that period if nothing else is used). A per-keyword provider error doesn't fail the whole batch - that keyword's entry just carries an "error" field instead.
Returns: {"results" (list, one {"keyword", ...same shape as analyze_citation_structure, or "error"} per keyword, in the order given), "summary": {"topics_analyzed", "topics_requested", "list_led_count", "avg_sources_cited", "avg_community_pct" (average source_mix.community_pct across the analyzed topics)}}.
Args: keywords: topics/queries to analyze, e.g. ["how to reduce churn", "churn rate benchmarks", "reduce customer churn saas"]. Max 10. country: market to read the answers in, e.g. "Italy". Defaults to "United States". language: language code, e.g. "it". Defaults to "en". engine: "chat_gpt" (default), "gemini" or "perplexity", as in analyze_citation_structure. One answer per topic.
Inputs: keywords (required), engine, country, language.
analyze_citation_trendTrack a site's AI citations over timeARead-onlyIdempotentInspect
Track how a domain's AI-citation count has moved month over month, so you can see whether visibility is growing or fading instead of only ever checking a single point in time. Use this to answer 'is our AI visibility improving' or 'did that content push actually move the needle'. Pass compare_domains to put competitors' trends next to it.
Read-only: no side effects, safe to retry. Costs 1 quota unit per domain (the main domain plus each one in compare_domains; free tier is 30 units/month shared across every metered tool, so up to 30 single-domain calls to this tool alone if nothing else is used that period).
Returns: {"domain", "platform", "months" (list of {"year", "month",
"mentions" (int, 0 for a month with no tracked citations. A zero
between two large months can be a gap in the provider's history rather
than a real drop, so read isolated zeros with care), "ai_search_volume"},
oldest to newest),
"trend": {"direction" ("up"/"down"/"flat"/"no_data"), "earliest_mentions",
"latest_mentions", "excluded_current_partial_month" (bool, only present
and true when the most recent calendar month was excluded from the trend
calculation because it is still in progress and its count is not yet
final - it is still returned inside months, just not compared)}}.
The most recent entry in months (or trend.latest_mentions when the
current month is not excluded) already IS the current count, so there is
no need for a separate call just to see it right now.
With compare_domains the result also carries "comparisons" (one {"domain", "months", "trend"} per extra domain, same shape and month window as above, in the order given, or {"domain", "error"} for one the provider failed on - that one is refunded and the rest still return).
Args: domain: bare domain to check, e.g. "example.com" (no https://, no www). compare_domains: optional list of up to 5 more bare domains to track over the same months, e.g. ["asana.com", "monday.com"]. platform: "chat_gpt" or "google" (Google's AI Overview). Defaults to chat_gpt. Perplexity and Gemini aren't available - the underlying data provider doesn't cover them for this check. months: how many recent months of history to return. Defaults to 6, capped at 13 - DataForSEO's historical data only goes back to 2025-08-01. country: market to check, e.g. "Italy". Defaults to "United States". chat_gpt only has data for the United States; use platform "google" for any other country. language: language code, e.g. "it". Defaults to "en" (the only option for chat_gpt).
Inputs: domain (required), months, country, language, +2 more.
find_citation_leadersFind who AI cites for a questionARead-onlyIdempotentInspect
Find which domains dominate AI-answer citations for a topic/keyword, and optionally check where one domain, or several competitors at once, show up among them. Use this to answer 'who's winning AI search for this topic' or 'is my competitor cited more than me for X'. Comparing several domains costs the same single call.
Read-only: no side effects, safe to retry. Costs 10 quota units/call (free tier is 30 units/month shared across every metered tool, so up to 3 calls to this tool alone if nothing else is used that period).
Returns: {"keyword", "platform", "top_domains" (list of {"domain",
"mentions"}, most-cited domains for this keyword/platform, order as
ranked by the provider), "top_domains_limit" (int, the provider's own
cap on this list - absence from it is NOT evidence a domain has zero
citations, only that it did not rank in the top top_domains_limit),
"compare_domain_rank" (int|null, only present when compare_domain was
passed: the domain's 1-based position in top_domains, or null if it
did not rank in the top top_domains_limit), "compare_domain_ranks"
(only present when compare_domains was passed: {domain: rank or null},
same rank rule as compare_domain_rank), "country", "language",
"source_mix" ({"community_pct" (share of these mentions that go to
community sites such as Reddit, YouTube, X, Quora), "community_domains",
"other_domains"}: a high community_pct means this topic is won by what
people say about a brand elsewhere, not by any one site's pages)}.
This tool's citation universe is the provider's tracked mention corpus for the keyword, which is a different measurement from analyze_citation_structure's single live answer - the two can legitimately disagree on whether a given domain shows up.
Args: keyword: the topic/query to check, e.g. "best project management tool". platform: "chat_gpt" or "google" (Google's AI Overview). Defaults to chat_gpt. Perplexity and Gemini aren't available - the underlying data provider doesn't cover them for this check. compare_domain: optional bare domain to look up in the results (exact match against the registrable domain, e.g. "notion.so" will not match "mynotion.so.example.com"). country: market to check, e.g. "Italy". Defaults to "United States". chat_gpt only has data for the United States; use platform "google" for any other country. language: language code, e.g. "it". Defaults to "en" (the only option for chat_gpt). compare_domains: optional list of up to 10 bare domains to rank side by side, e.g. ["notion.so", "asana.com", "monday.com"]. Same exact-match rule as compare_domain.
Inputs: keyword (required), country, language, platform, +2 more.
find_cited_questionsFind questions AI cites your site forARead-onlyIdempotentInspect
Find the questions people ask AI answer engines where a domain is already cited as a source, most-asked first. Starts from the domain, so nobody has to guess keywords first. Use this to answer 'what does ChatGPT already cite us for' or to pick the keywords to feed analyze_citation_coverage and analyze_citation_gap.
Read-only: no side effects, safe to retry. Costs 10 quota units/call (free tier is 30 units/month shared across every metered tool, so up to 3 calls to this tool alone if nothing else is used that period).
Returns: {"domain", "platform", "country", "language", "total_questions"
(int, every tracked question citing the domain, which can exceed the
list), "questions" (up to limit, most-asked first: {"question",
"ai_search_volume" (monthly asks as the provider estimates them),
"your_position" (1-based position of the domain among that answer's
sources), "source_domains" (who else that answer cites), "last_seen"
(when the provider last recorded this answer, UTC)})}. An empty list means
the provider's tracked answers do not cite the domain, not that no
answer anywhere does.
This reads the provider's tracked answer corpus, the same measurement as find_citation_leaders, not a live answer: re-check a question with analyze_citation_coverage to see today's answer.
Args: domain: bare domain, e.g. "example.com" (no https://, no www). Subdomains are included. platform: "chat_gpt" (default) or "google" (Google's AI Overview). limit: how many questions to return, 1 to 20. Default 20. country: market, e.g. "Italy". Defaults to "United States". chat_gpt only has United States data; use platform "google" elsewhere. language: language code, e.g. "it". Defaults to "en", the only option for chat_gpt.
Inputs: domain (required), limit, country, language, +1 more.
get_check_historyShow your past citation checksARead-onlyIdempotentInspect
Read back your own earlier analyze_citation_coverage results for a domain,
newest first, to show progress over time or to confirm whether a change
(a rewrite, a new mention somewhere) moved anything. Use this for 'has
our citation status changed since last week' without spending units.
Pass page to follow ONE page's citations over time instead of the whole
domain's.
Costs 0 quota units: it only reads Vantage's own record of your checks, never the data provider. Results are kept 180 days per API key and are only visible to that key.
Returns: {"domain", "keyword" (or null for every keyword), "page" (the
URL asked about, or null), "checks" (newest first: {"keyword", "engine",
"country", "language", "samples", "cited_runs", "best_rank",
"mentioned_runs", "checked_at", "cited_pages" (your page URLs cited in
that check, or null for a check saved before page tracking), and with
page set, "page_cited" (true/false, or null when that check did not
record pages))}, and with page set also "times_cited" (checks that
cited that page) and "checks_with_page_data".
Args: domain: the bare domain the checks were run for, e.g. "example.com". keyword: optional, only this keyword's history. limit: how many rows to return, 1 to 200. Default 50. page: optional full URL of one page on the domain, e.g. "https://example.com/pricing". Matched ignoring "www.", the scheme, a trailing slash and any #fragment.
Inputs: domain (required), page, limit, keyword.
get_supported_optionsList supported engines and marketsARead-onlyIdempotentInspect
List which AI engines, platforms and markets each Vantage tool accepts, and the per-call limits, so you can pick valid arguments before spending any quota. Use this to answer 'does Vantage cover Gemini in Italy' or 'what can I pass as engine or platform'.
Costs 0 quota units - a fixed list, it never touches the data provider.
Returns: {"live_answer": {"tools" (analyze_citation_coverage,
analyze_citation_structure, analyze_citation_structure_batch,
analyze_citation_gap), "engines" (the values for engine),
"country" (any country name the provider accepts; for perplexity one of
"perplexity_countries" or a 2-letter ISO code), "language" (language
code), "max_samples", "max_keywords_per_call"}, "tracked_data":
{"tools" (find_citation_leaders, analyze_citation_trend,
find_cited_questions), "platforms" (the values for platform),
"chat_gpt_market" (the only market ChatGPT has tracked data for),
"other_markets" (where to get the rest), "max_trend_months",
"max_compare_domains" ({"find_citation_leaders", "analyze_citation_trend"})},
"default_market" ({"country", "language"})}. A market the provider does
not cover comes back as a refunded error, never a charge.
Inputs: no named parameters.
get_usageCheck remaining monthly unitsARead-onlyIdempotentInspect
Check how much of this billing period's quota is left, before spending any of it. Use this to answer 'how many checks do I have left' or to decide whether a batch call will fit before running it.
Costs 0 quota units - this never touches the paid data provider, it only reads Vantage's own record of what has been used.
Returns: {"tier", "period" (YYYY-MM), "units_used", "units_limit",
"units_remaining"}. find_citation_leaders and find_cited_questions cost
10 units/call; analyze_citation_trend, analyze_citation_structure (and
its batch form, per keyword), analyze_citation_coverage (per keyword) and
analyze_citation_gap cost 1, times samples where a tool takes it
(analyze_citation_trend: 1 per domain compared). get_check_history and
get_supported_options cost 0.
stdio/local-dev mode (no HTTP access token) has no metering at all - this returns tier "unmetered" with no real limit in that case.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Tools mostly target distinct operations: 'leaders' (keyword→top domains from the tracked corpus), 'questions' (domain→questions from the same corpus), 'trend' (domain over time), 'structure' (shape of one live answer), 'coverage' (does a domain get cited across keywords), and 'gap' (fix brief). The citation_* family is close cousin territory — structure, structure_batch, coverage, and gap all take keyword+engine and return source_domains/source_mix — but the descriptions repeatedly spell out the tracked-corpus-vs-live-answer distinction and the 'use this to answer X' framing to keep them separable.
All ten names are lowercase snake_case following a verb_noun pattern (find_*, analyze_*, get_*). Variants inside a family are suffixed predictably (analyze_citation_structure vs analyze_citation_structure_batch), and the meta tools (get_usage, get_supported_options, get_check_history) are consistently get_-prefixed.
Ten tools is well within the sweet spot for a focused analytics domain. Each earns its place: six analysis tools cover the core surface and three zero-cost meta tools (options, usage, history) support quota-aware operation without bloating the set.
The surface covers a full workflow: keyword discovery (find_cited_questions), leader/competitor ranking (find_citation_leaders), visibility checking (analyze_citation_coverage), diagnosis and remediation (analyze_citation_structure, _batch, analyze_citation_gap), trend tracking (analyze_citation_trend), plus meta support (get_usage, get_supported_options, get_check_history). No obvious dead ends for the stated AI-citation-visibility purpose.
Maintenance
Related MCP Connectors
Check if ChatGPT, Perplexity & Gemini mention or cite a brand. Share of voice + GEO/AEO tracking.
Check if ChatGPT, Gemini and Google AI Overviews mention your brand or competitors.
Track brand visibility in ChatGPT, Gemini and Google AI answers: competitors, cited sources, checks.
See how ChatGPT, Perplexity, Gemini and Google AI Overviews mention and cite your brand.
Related MCP Servers
- AlicenseAqualityDmaintenanceAudit your brand's visibility across ChatGPT, Perplexity, Claude, and Google AI - get citation rates, AEO health scores, content gap analysis, and a 9-page content suite to rank in AI-generated answers.5130 npmMIT
- AlicenseAqualityDmaintenanceTrack brand visibility across ChatGPT, Perplexity, Claude, and Gemini.6277 npm11MIT
- AlicenseAqualityCmaintenanceEnables users to interrogate ChatGPT, Perplexity, and Gemini with buyer questions and live web search to learn whether a business is recommended, ranked, competing with others, and having its website cited. Returns structured findings and estimated provider costs.190 npmMIT
- AlicenseAqualityBmaintenanceAI visibility and SEO data for AI agents. Check whether ChatGPT, Claude, Perplexity and Gemini mention your brand and which sources they cite, plus keyword volume and Google Trends.29862 npm1MIT