{"report":"{\"v\":1,\"package\":\"vantage-ai-visibility-mcp\",\"version\":\"1.0.0\",\"ranAt\":\"2026-11-16T11:50:58.081Z\",\"install\":{\"ok\":true,\"integrity\":\"sha512-wtRrSEo2sDBNYWGFpa17sy2I5ke7nTvouRP9rmIOSz2wtF31WaZ0ldjCIiyImhe7zAp3CY/qid7Fj6uPxikRTg==\",\"deps\":81,\"scripts\":[],\"bins\":[\"vantage-ai-visibility-mcp\"],\"license\":\"MIT\",\"engines\":\"node >=18\",\"repository\":\"git+https://github.com/vantagemcp/vantage-mcp.git\",\"bin\":\"vantage-ai-visibility-mcp\"},\"start\":{\"ok\":true,\"ms\":1749,\"serverName\":\"vantage\",\"serverVersion\":\"\",\"protocol\":\"2025-06-18\",\"stderr\":\":31421:15)\\n    at async sendToServer (file:///app/node_modules/mcp-remote/dist/chunk-HCS6J5PY.js:33012:7)\\n[66] Remote server requires authorization, completing sign-in\\n[66] Initializing auth coordination on-demand\\n[66] OAuth callback server running at http://127.0.0.1:22889\\n[66] This instance is running the sign-in for this server (callback port 22889)\\n[66] [Local→Remote] tools/call\\n[66] \\nPlease authorize this client by visiting:\\nhttps://vantagemcp.dev/authorize?response_type=code&client_id=e859cc18-17a4-4091-b2a5-40eda1429809&code_challenge=XLSCSFydM8_J3OCP0p8jnCJE-G1uXt5oOs_CXI6mZcY&code_challenge_method=S256&redirect_uri=http%3A%2F%2Flocalhost%3A22889%2Foauth%2Fcallback&state=cea683c3-ab1d-49f6-87c4-84d36f896dcb&scope=vantage&resource=https%3A%2F%2Fvantagemcp.dev%2Fmcp\\n\\n[66] Trying /usr/bin/xdg-open to open the browser...\\n[66] Trying gio to open the browser...\\n[66] Trying x-www-browser to open the browser...\\n[66] Trying sensible-browser to open the browser...\\n[66] Could not open a browser automatically. Please copy and paste the URL above into your browser.\\n[66] Error from remote server: UnauthorizedError: Unauthorized\\n    at handleOAuthUnauthorized (file:///app/node_modules/mcp-remote/dist/chunk-HCS6J5PY.js:27764:30)\\n    at process.processTicksAndRejections (node:internal/process/task_queues:104:5)\\n    at async StreamableHTTPClientTransport._send (file:///app/node_modules/mcp-remote/dist/chunk-HCS6J5PY.js:31421:15)\\n    at async sendToServer (file:///app/node_modules/mcp-remote/dist/chunk-HCS6J5PY.js:33012:7)\\n[66] Remote server requires authorization, completing sign-in\\n\"},\"tools\":[{\"name\":\"get_supported_options\",\"description\":\"List which AI engines, platforms and markets each Vantage tool\\naccepts, and the per-call limits, so you can pick valid arguments before\\nspending any quota. Use this to answer 'does Vantage cover Gemini in\\nItaly' or 'what can I pass as engine or platform'.\\n\\nCosts 0 quota units - a fixed list, it never touches the data provider.\\n\\nReturns: {\\\"live_answer\\\": {\\\"tools\\\" (analyze_citation_coverage,\\nanalyze_citation_structure, analyze_citation_structure_batch,\\nanalyze_citation_gap), \\\"engines\\\" (the values for `engine`),\\n\\\"country\\\" (any country name the provider accepts; for perplexity one of\\n\\\"perplexity_countries\\\" or a 2-letter ISO code), \\\"language\\\" (language\\ncode), \\\"max_samples\\\", \\\"max_keywords_per_call\\\"}, \\\"tracked_data\\\":\\n{\\\"tools\\\" (find_citation_leaders, analyze_citation_trend,\\nfind_cited_questions), \\\"platforms\\\" (the values for `platform`),\\n\\\"chat_gpt_market\\\" (the only market ChatGPT has tracked data for),\\n\\\"other_markets\\\" (where to get the rest), \\\"max_trend_months\\\",\\n\\\"max_compare_domains\\\" ({\\\"find_citation_leaders\\\", \\\"analyze_citation_trend\\\"})},\\n\\\"default_market\\\" ({\\\"country\\\", \\\"language\\\"})}. A market the provider does\\nnot cover comes back as a refunded error, never a charge.\\n\",\"params\":[]},{\"name\":\"get_usage\",\"description\":\"Check how much of this billing period's quota is left, before\\nspending any of it. Use this to answer 'how many checks do I have left'\\nor to decide whether a batch call will fit before running it.\\n\\nCosts 0 quota units - this never touches the paid data provider, it\\nonly reads Vantage's own record of what has been used.\\n\\nReturns: {\\\"tier\\\", \\\"period\\\" (YYYY-MM), \\\"units_used\\\", \\\"units_limit\\\",\\n\\\"units_remaining\\\"}. find_citation_leaders and find_cited_questions cost\\n10 units/call, analyze_citation_trend 10 per domain looked up;\\nanalyze_citation_structure (and its batch form, per keyword),\\nanalyze_citation_coverage (per keyword) and analyze_citation_gap cost 1,\\ntimes `samples` where a tool takes it. get_check_history,\\ncheck_page_readiness and get_supported_options cost 0.\\n\\nstdio/local-dev mode (no HTTP access token) has no metering at all -\\nthis returns tier \\\"unmetered\\\" with no real limit in that case.\\n\",\"params\":[]},{\"name\":\"find_citation_leaders\",\"description\":\"Find which domains dominate AI-answer citations for a topic/keyword,\\nand optionally check where one domain, or several competitors at once,\\nshow up among them. Use this to answer 'who's winning AI search for this\\ntopic' or 'is my competitor cited more than me for X'. Comparing several\\ndomains costs the same single call.\\n\\nRead-only: no side effects, safe to retry. Costs 10 quota units/call\\n(free tier is 30 units/month shared across every metered tool, so up to 3\\ncalls to this tool alone if nothing else is used that period).\\n\\nReturns: {\\\"keyword\\\", \\\"platform\\\", \\\"top_domains\\\" (list of {\\\"domain\\\",\\n\\\"mentions\\\"}, most-cited domains for this keyword/platform, order as\\nranked by the provider), \\\"top_domains_limit\\\" (int, the provider's own\\ncap on this list - absence from it is NOT evidence a domain has zero\\ncitations, only that it did not rank in the top `top_domains_limit`),\\n\\\"compare_domain_rank\\\" (int|null, only present when compare_domain was\\npassed: the domain's 1-based position in top_domains, or null if it\\ndid not rank in the top `top_domains_limit`), \\\"compare_domain_ranks\\\"\\n(only present when compare_domains was passed: {domain: rank or null},\\nsame rank rule as compare_domain_rank), \\\"country\\\", \\\"language\\\",\\n\\\"source_mix\\\" ({\\\"community_pct\\\" (share of these mentions that go to\\ncommunity sites such as Reddit, YouTube, X, Quora), \\\"community_domains\\\",\\n\\\"other_domains\\\"}: a high community_pct means this topic is won by what\\npeople say about a brand elsewhere, not by any one site's pages)}.\\n\\nThis tool's citation universe is the provider's tracked mention corpus\\nfor the keyword, which is a different measurement from\\nanalyze_citation_structure's single live answer - the two can\\nlegitimately disagree on whether a given domain shows up.\\n\\nArgs:\\n    keyword: the topic/query to check, e.g. \\\"best project management tool\\\".\\n    platform: \\\"chat_gpt\\\" or \\\"google\\\" (Google's AI Overview). Defaults\\n        to chat_gpt. Perplexity and Gemini aren't available - the\\n        underlying data provider doesn't cover them for this check.\\n    compare_domain: optional bare domain to look up in the results\\n        (exact match against the registrable domain, e.g. \\\"notion.so\\\"\\n        will not match \\\"mynotion.so.example.com\\\").\\n    country: market to check, e.g. \\\"Italy\\\". Defaults to \\\"United States\\\".\\n        chat_gpt only has data for the United States; use platform\\n        \\\"google\\\" for any other country.\\n    language: language code, e.g. \\\"it\\\". Defaults to \\\"en\\\" (the only\\n        option for chat_gpt).\\n    compare_domains: optional list of up to 10 bare domains to rank side\\n        by side, e.g. [\\\"notion.so\\\", \\\"asana.com\\\", \\\"monday.com\\\"]. Same\\n        exact-match rule as compare_domain.\\n\",\"params\":[\"keyword\",\"platform\",\"compare_domain\",\"country\",\"language\",\"compare_domains\"]},{\"name\":\"analyze_citation_trend\",\"description\":\"Track how a domain's AI-citation count has moved month over month,\\nso you can see whether visibility is growing or fading instead of\\nonly ever checking a single point in time. Use this to answer 'is our\\nAI visibility improving' or 'did that content push actually move the\\nneedle'. Pass compare_domains to put competitors' trends next to it.\\n\\nRead-only: no side effects, safe to retry. Costs 10 quota units per\\ndomain (the main domain plus each one in compare_domains; free tier is 30\\nunits/month shared across every metered tool, so up to 3 single-domain\\ncalls to this tool alone if nothing else is used that period). A domain\\nthe provider fails on is not charged.\\n\\nReturns: {\\\"domain\\\", \\\"platform\\\", \\\"months\\\" (list of {\\\"year\\\", \\\"month\\\",\\n\\\"mentions\\\" (int, 0 for a month with no tracked citations. A zero\\nbetween two large months can be a gap in the provider's history rather\\nthan a real drop, so read isolated zeros with care), \\\"ai_search_volume\\\"},\\noldest to newest),\\n\\\"trend\\\": {\\\"direction\\\" (\\\"up\\\"/\\\"down\\\"/\\\"flat\\\"/\\\"no_data\\\"), \\\"earliest_mentions\\\",\\n\\\"latest_mentions\\\", \\\"excluded_current_partial_month\\\" (bool, only present\\nand true when the most recent calendar month was excluded from the trend\\ncalculation because it is still in progress and its count is not yet\\nfinal - it is still returned inside `months`, just not compared)}}.\\n\\nThe most recent entry in `months` (or `trend.latest_mentions` when the\\ncurrent month is not excluded) already IS the current count, so there is\\nno need for a separate call just to see it right now.\\n\\nWith compare_domains the result also carries \\\"comparisons\\\" (one\\n{\\\"domain\\\", \\\"months\\\", \\\"trend\\\"} per extra domain, same shape and month\\nwindow as above, in the order given, or {\\\"domain\\\", \\\"error\\\"} for one the\\nprovider failed on - that one is refunded and the rest still return).\\n\\nArgs:\\n    domain: bare domain to check, e.g. \\\"example.com\\\" (no https://, no www).\\n    compare_domains: optional list of up to 5 more bare domains to track\\n        over the same months, e.g. [\\\"asana.com\\\", \\\"monday.com\\\"].\\n    platform: \\\"chat_gpt\\\" or \\\"google\\\" (Google's AI Overview). Defaults\\n        to chat_gpt. Perplexity and Gemini aren't available - the\\n        underlying data provider doesn't cover them for this check.\\n    months: how many recent months of history to return. Defaults to\\n        6, capped at 13 - DataForSEO's historical data only goes back\\n        to 2025-08-01.\\n    country: market to check, e.g. \\\"Italy\\\". Defaults to \\\"United States\\\".\\n        chat_gpt only has data for the United States; use platform\\n        \\\"google\\\" for any other country.\\n    language: language code, e.g. \\\"it\\\". Defaults to \\\"en\\\" (the only\\n        option for chat_gpt).\\n\",\"params\":[\"domain\",\"platform\",\"months\",\"country\",\"language\",\"compare_domains\"]},{\"name\":\"analyze_citation_structure\",\"description\":\"Analyze the structural shape of the AI-generated answer actually\\ncited for a keyword: does it lead with a list, how long is the opening\\npassage, how many sources does it cite and from which domains. Use\\nthis to understand what a winning AI-search answer looks like for a\\ntopic, e.g. before writing content on it.\\n\\nRead-only: no side effects, safe to retry. Costs 1 quota unit per sample\\n(1 by default; free tier is 30 units/month shared across every metered\\ntool, so up to 30 single-sample calls to this tool alone if nothing else\\nis used that period).\\n\\nReturns: {\\\"keyword\\\", \\\"engine\\\", \\\"model\\\" (the answering model's version, as\\nthe provider reports it), \\\"checked_at\\\" (when the answer was fetched, UTC),\\n\\\"leads_with_list\\\" (bool), \\\"opening\\\" (the answer's opening paragraph, as\\ntext), \\\"opening_word_count\\\" (int), \\\"opening_has_number\\\" (bool),\\n\\\"detail_preview\\\" (up to 240 characters of what follows the opening,\\ncut at a word), \\\"outline\\\" (list of up to 12 section\\nheads, in order: the answer's headings, or its top-level list items when it\\nhas fewer than two headings; heads only, never the text under them),\\n\\\"has_table\\\" (bool), \\\"num_sources_cited\\\" (int),\\n\\\"source_domains\\\" (list of up to 10 domain strings), \\\"source_urls\\\" (the\\nexact cited page URLs, up to 30, so you can see which page of a domain was\\ncited), \\\"source_mix\\\"\\n({\\\"community_pct\\\" (share of those sources that are community sites such\\nas Reddit, YouTube, X, Quora), \\\"community_domains\\\", \\\"other_domains\\\"}),\\n\\\"country\\\", \\\"language\\\"}. With samples above 1 the shape fields describe\\nthe first answer, plus \\\"samples_ok\\\" (answers that came back) and\\n\\\"source_frequency\\\" (list of {\\\"domain\\\", \\\"runs\\\"}: how many of the answers\\ncited each domain, most often first). Answers change from run to run, so\\na domain cited in every sample is a far stronger signal than one sample.\\n\\nArgs:\\n    keyword: the topic/query to analyze, e.g. \\\"how to reduce churn\\\".\\n    country: market to read the answer in, e.g. \\\"Italy\\\". Defaults to\\n        \\\"United States\\\". For perplexity a 2-letter code also works.\\n    language: language code, e.g. \\\"it\\\". Defaults to \\\"en\\\". Write the\\n        keyword in that language too.\\n    engine: \\\"chat_gpt\\\" (default), \\\"gemini\\\" or \\\"perplexity\\\". chat_gpt and\\n        gemini are the answers a person sees in those apps; perplexity is\\n        Perplexity's sonar API with web search.\\n    samples: how many independent answers to read, 1 to 5. Default 1.\\n\",\"params\":[\"keyword\",\"country\",\"language\",\"engine\",\"samples\"]},{\"name\":\"analyze_citation_structure_batch\",\"description\":\"Analyze the structural shape of the winning AI answer across several\\nrelated keywords/topics in one call: does each lead with a list, how\\nlong is the opening, how many sources it cites. It covers a topic\\ncluster in one call, for content planning across related pieces.\\n\\nRead-only: no side effects, safe to retry. Costs 1 quota unit per\\nkeyword in the batch (free tier is 30 units/month shared across all\\nthe metered tools, so up to 30 keywords total that period if nothing else\\nis used). A per-keyword provider error doesn't fail the whole batch -\\nthat keyword's entry just carries an \\\"error\\\" field instead.\\n\\nReturns: {\\\"results\\\" (list, one {\\\"keyword\\\", ...same shape as\\nanalyze_citation_structure, or \\\"error\\\"} per keyword, in the order given),\\n\\\"summary\\\": {\\\"topics_analyzed\\\", \\\"topics_requested\\\", \\\"list_led_count\\\",\\n\\\"avg_sources_cited\\\", \\\"avg_community_pct\\\" (average source_mix.community_pct\\nacross the analyzed topics)}}.\\n\\nArgs:\\n    keywords: topics/queries to analyze, e.g. [\\\"how to reduce churn\\\",\\n        \\\"churn rate benchmarks\\\", \\\"reduce customer churn saas\\\"]. Max 10.\\n    country: market to read the answers in, e.g. \\\"Italy\\\". Defaults to\\n        \\\"United States\\\".\\n    language: language code, e.g. \\\"it\\\". Defaults to \\\"en\\\".\\n    engine: \\\"chat_gpt\\\" (default), \\\"gemini\\\" or \\\"perplexity\\\", as in\\n        analyze_citation_structure. One answer per topic.\\n\",\"params\":[\"keywords\",\"country\",\"language\",\"engine\"]},{\"name\":\"analyze_citation_coverage\",\"description\":\"Check which of several prompts/keywords actually cite a specific\\ndomain, and which ones don't. It answers \\\"out of everything we care about, where do we already\\nshow up, and where are we invisible\\\"; its not_cited list is the set of\\nkeywords worth a closer look.\\n\\nRead-only for the caller, safe to retry. Costs 1 quota unit per keyword\\nper sample (1 sample by default; free tier is 30 units/month shared\\nacross every metered tool, so up to 30 keyword checks that period if\\nnothing else is used). A per-keyword provider error doesn't fail the\\nwhole call - that keyword's entry just carries an \\\"error\\\" field instead.\\nOn the hosted endpoint each keyword's result is remembered for 180 days\\nagainst your API key, so the next check of the same domain and keyword\\nreports what changed (see \\\"previous\\\" and \\\"change\\\"); get_check_history\\nreads that record back for free.\\n\\nReturns: {\\\"domain\\\", \\\"engine\\\", \\\"samples\\\", \\\"keywords_checked\\\" (int,\\nexcludes any that errored), \\\"keywords_cited\\\" (int), \\\"coverage_pct\\\"\\n(float, 0-100), \\\"not_cited\\\" (list of the keyword strings where domain\\nwas not cited - the actionable list), \\\"newly_cited\\\" and \\\"no_longer_cited\\\"\\n(keywords whose status flipped since your last check of them), \\\"results\\\"\\n(one entry per keyword, in the order given: {\\\"keyword\\\", \\\"cited\\\" (bool:\\ncited in at least half of the samples), \\\"cited_runs\\\" (how many sampled\\nanswers cited it), \\\"samples_ok\\\" (how many answers came back), \\\"rank\\\"\\n(int|null, best 1-based position among the answers' sources, null when\\nnever cited), \\\"cited_pages\\\" (list of your own page URLs the answers cited,\\nempty when none - saved with the check, so get_check_history can follow\\none page over time), \\\"num_sources_cited\\\", \\\"source_domains\\\" (who IS cited, for a\\nkeyword you are not in), \\\"source_mix\\\" (how much of that is community\\nsites such as Reddit, YouTube, X - where to get discussed to close the\\ngap), \\\"source_frequency\\\" (only with samples above 1: {\\\"domain\\\", \\\"runs\\\"}\\nper domain), \\\"leads_with_list\\\", \\\"opening_word_count\\\", \\\"mentioned\\\" (bool -\\nthe answer's text names the domain or brand in at least half of the\\nsamples, whether or not it links to it), \\\"model\\\", \\\"checked_at\\\",\\n\\\"previous\\\" ({\\\"checked_at\\\", \\\"cited_runs\\\", \\\"samples\\\", \\\"best_rank\\\"} from\\nyour last check of this domain and keyword on the same engine and\\nmarket with the same number of samples, or null), \\\"change\\\" (\\\"first_check\\\", \\\"up\\\", \\\"down\\\" or \\\"same\\\",\\ncomparing citation rates)}, or {\\\"keyword\\\", \\\"error\\\"} for one that\\nfailed), \\\"keywords_mentioned\\\" (int), \\\"mentioned_not_cited\\\" (keywords\\nwhere the answer names you but does not cite you - the model already\\nknows you, it just isn't linking you), \\\"mention_terms\\\" (exactly what was\\nlooked for in the answer text)}. \\\"Cited\\\" and \\\"mentioned\\\" are separate\\nclaims and are never merged. Answers change from run to run: with\\nsamples=1 a single answer decides \\\"cited\\\", so one sample is weak\\nevidence either way.\\n\\nArgs:\\n    domain: bare domain to check, e.g. \\\"example.com\\\" (no https://, no www).\\n    keywords: prompts/topics to check it agains\",\"params\":[\"domain\",\"keywords\",\"brand\",\"country\",\"language\",\"engine\",\"samples\"]},{\"name\":\"analyze_citation_gap\",\"description\":\"Compare your own page's structure against the AI-generated answer\\nactually cited for this keyword, and return a fix brief: the differences\\nbetween the two, each with the change worth testing, not just a\\ndescription of the winner. Use this to answer 'how does my page differ\\nfrom what AI cites for this, and what could I try'. The brief lists\\nthings to test, not proven causes of citation. It never contains the\\ncited answer's text.\\n\\nRead-only: no side effects, safe to retry. Costs 1 quota unit per sample\\n(1 by default; free tier is 30 units/month shared across every metered\\ntool, so up to 30 single-sample calls to this tool alone if nothing else\\nis used that period). A sample that fails is not charged.\\n\\nReturns: {\\\"keyword\\\", \\\"your_url\\\", \\\"already_cited\\\" (bool: your page's site\\nis among the answer's sources, in at least half of them with samples\\nabove 1; when true, fix_brief is one line saying so instead of changes),\\n\\\"basis\\\" (one sentence: how many answers, which engine and market, and\\nthat the brief lists things to test), \\\"samples_ok\\\" and\\n\\\"cited_in_answers\\\" (only with samples above 1), \\\"winning\\\" (structure of the\\nAI-cited answer, same shape as analyze_citation_structure), \\\"yours\\\"\\n(same structure computed for your_url, including its own \\\"outline\\\" and\\n\\\"has_table\\\", with \\\"num_links_out\\\"/\\\"linked_domains\\\" standing in for\\nsource count), \\\"gaps\\\" (list of plain-English differences worth acting\\non), \\\"possibly_missing\\\" (heads from the winning outline whose key words\\nmostly do not appear on your page; word matching, so check each before\\nadding it), \\\"fix_brief\\\" (list, most important first, each line what was\\nobserved then what is worth testing: opening, number, list, sections,\\nmissing points, table, then a reminder to write in your own words - or a\\n\\\"no structural change indicated\\\" line when every check already matches -\\nand always last, one off-site option drawn from the winning answer's\\nsource_mix: which community sites (Reddit, YouTube, X...) it cites, or\\nwhich other sites to get mentioned on). With samples above 1, \\\"winning\\\"\\nis the first answer, and a brief line or missing point needs at least half\\nthe answers behind it}, or {\\\"error\\\"} if either side couldn't be\\nfetched/parsed.\\n\\nArgs:\\n    keyword: the topic/query to check, e.g. \\\"best project management tool\\\".\\n    your_url: full URL of your own page to compare, e.g.\\n        \\\"https://example.com/best-project-management-tools\\\".\\n    country: market to read the cited answer in, e.g. \\\"Italy\\\". Defaults\\n        to \\\"United States\\\".\\n    language: language code, e.g. \\\"it\\\". Defaults to \\\"en\\\".\\n    engine: \\\"chat_gpt\\\" (default), \\\"gemini\\\" or \\\"perplexity\\\": whose answer\\n        to compare your page against.\\n    samples: how many independent answers to read, 1 to 5. Default 1.\\n        Answers change from run to run; 3 gives a steadier brief.\\n\",\"params\":[\"keyword\",\"your_url\",\"country\",\"language\",\"engine\",\"samples\"]},{\"name\":\"find_cited_questions\",\"description\":\"Find the questions people ask AI answer engines where a domain is\\nalready cited as a source, most-asked first. Starts from the domain, so\\nnobody has to guess keywords first. Use this to answer 'what does\\nChatGPT already cite us for' or to pick the keywords to feed\\nanalyze_citation_coverage and analyze_citation_gap.\\n\\nRead-only: no side effects, safe to retry. Costs 10 quota units/call\\n(free tier is 30 units/month shared across every metered tool, so up to 3\\ncalls to this tool alone if nothing else is used that period).\\n\\nReturns: {\\\"domain\\\", \\\"platform\\\", \\\"country\\\", \\\"language\\\", \\\"total_questions\\\"\\n(int, every tracked question citing the domain, which can exceed the\\nlist), \\\"questions\\\" (up to `limit`, most-asked first: {\\\"question\\\",\\n\\\"ai_search_volume\\\" (monthly asks as the provider estimates them),\\n\\\"your_position\\\" (1-based position of the domain among that answer's\\nsources), \\\"source_domains\\\" (who else that answer cites), \\\"last_seen\\\"\\n(when the provider last recorded this answer, UTC)})}. An empty list means\\nthe provider's tracked answers do not cite the domain, not that no\\nanswer anywhere does.\\n\\nThis reads the provider's tracked answer corpus, the same measurement as\\nfind_citation_leaders, not a live answer: re-check a question with\\nanalyze_citation_coverage to see today's answer.\\n\\nArgs:\\n    domain: bare domain, e.g. \\\"example.com\\\" (no https://, no www).\\n        Subdomains are included.\\n    platform: \\\"chat_gpt\\\" (default) or \\\"google\\\" (Google's AI Overview).\\n    limit: how many questions to return, 1 to 20. Default 20.\\n    country: market, e.g. \\\"Italy\\\". Defaults to \\\"United States\\\". chat_gpt\\n        only has United States data; use platform \\\"google\\\" elsewhere.\\n    language: language code, e.g. \\\"it\\\". Defaults to \\\"en\\\", the only\\n        option for chat_gpt.\\n\",\"params\":[\"domain\",\"platform\",\"limit\",\"country\",\"language\"]},{\"name\":\"get_check_history\",\"description\":\"Read back your own earlier analyze_citation_coverage results for a domain,\\nnewest first, to show progress over time or to confirm whether a change\\n(a rewrite, a new mention somewhere) moved anything. Use this for 'has\\nour citation status changed since last week' without spending units.\\nPass `page` to follow ONE page's citations over time instead of the whole\\ndomain's.\\n\\nCosts 0 quota units: it only reads Vantage's own record of your checks,\\nnever the data provider. Results are kept 180 days per API key and are\\nonly visible to that key.\\n\\nReturns: {\\\"domain\\\", \\\"keyword\\\" (or null for every keyword), \\\"page\\\" (the\\nURL asked about, or null), \\\"checks\\\" (newest first: {\\\"keyword\\\", \\\"engine\\\",\\n\\\"country\\\", \\\"language\\\", \\\"samples\\\", \\\"cited_runs\\\", \\\"best_rank\\\",\\n\\\"mentioned_runs\\\", \\\"checked_at\\\", \\\"cited_pages\\\" (your page URLs cited in\\nthat check, or null for a check saved before page tracking), and with\\n`page` set, \\\"page_cited\\\" (true/false, or null when that check did not\\nrecord pages))}, and with `page` set also \\\"times_cited\\\" (checks that\\ncited that page) and \\\"checks_with_page_data\\\".\\n\\nArgs:\\n    domain: the bare domain the checks were run for, e.g. \\\"example.com\\\".\\n    keyword: optional, only this keyword's history.\\n    limit: how many rows to return, 1 to 200. Default 50.\\n    page: optional full URL of one page on the domain, e.g.\\n        \\\"https://example.com/pricing\\\". Matched ignoring \\\"www.\\\", the\\n        scheme, a trailing slash and any #fragment.\\n\",\"params\":[\"domain\",\"keyword\",\"limit\",\"page\"]},{\"name\":\"check_page_readiness\",\"description\":\"Check whether one page has what AI answers look for before they cite\\nit, for the question it should answer, and say exactly what to change,\\nbefore or after a page is edited. It reads the HTML a crawler gets, so\\nit also catches content that only appears with JavaScript.\\n\\nChecks: the <title> asks the question and fits (60 characters); one\\n<h1> matching it; the first paragraph after the heading is the answer\\nitself (12 to 45 words, a sentence, with a number or date); a visible\\n\\\"Updated\\\" date that matches the JSON-LD dateModified and is under 90\\ndays old; at least 300 words without JavaScript; valid structured data,\\nand FAQ markup only for questions shown on the page; canonical and\\nnoindex; robots.txt letting OAI-SearchBot, PerplexityBot,\\nClaude-SearchBot and Googlebot reach the page.\\n\\nCosts 0 quota units: it fetches the page and its robots.txt itself and\\nnever calls the data provider. Read-only, safe to retry. Passing makes\\na page easier to cite, it does not cause a citation: whether the\\nquestion is one your site can own matters more, which only\\nanalyze_citation_coverage measures.\\n\\nReturns: {\\\"url\\\" (after redirects), \\\"question\\\", \\\"passed\\\", \\\"failed\\\",\\n\\\"fixes\\\" (what to change, one line per failed check, in page order),\\n\\\"checks\\\" (each {\\\"rule\\\", \\\"ok\\\", \\\"observed\\\", \\\"fix\\\"}), \\\"basis\\\" (one\\nsentence on where the checks come from)}, or {\\\"url\\\", \\\"error\\\"} when the\\npage cannot be fetched (not public, not HTML, an HTTP error).\\n\\nArgs:\\n    url: full address of the page, e.g. \\\"https://example.com/pricing\\\".\\n    question: what the page should answer, in the words people search\\n        with, e.g. \\\"how much does example cost\\\".\\n\",\"params\":[\"url\",\"question\"]}],\"toolsHash\":\"e79eac77a93c848513194c4b2c3bebdc9169a84cf1659c9a491d91b559203c56\",\"wrote\":[\"/tmp/.mcp-auth/mcp-remote-v1/ff5a3a83931fd38b96ffef146c351a5d_code_verifier_cea683c3-ab1d-49f6-87c4-84d36f896dcb.txt\",\"/tmp/.mcp-auth/mcp-remote-v1/ff5a3a83931fd38b96ffef146c351a5d_client_info.json\",\"/tmp/.mcp-auth/mcp-remote-v1/ff5a3a83931fd38b96ffef146c351a5d_discovery_state_ea7b1bf6-e0f9-4325-aa3b-47797ce1c978.json\",\"/tmp/.mcp-auth/mcp-remote-v1/ff5a3a83931fd38b96ffef146c351a5d_discovery_state_cea683c3-ab1d-49f6-87c4-84d36f896dcb.json\",\"/tmp/.mcp-auth/mcp-remote-v1/ff5a3a83931fd38b96ffef146c351a5d_code_verifier_ea7b1bf6-e0f9-4325-aa3b-47797ce1c978.txt\"],\"callsAt\":\"2026-11-16T11:51:04.680Z\",\"calls\":[{\"tool\":\"get_supported_options\",\"ok\":false,\"ms\":15002,\"bytes\":0,\"error\":\"tools/call timed out after 15000 ms\"},{\"tool\":\"get_usage\",\"ok\":false,\"ms\":15000,\"bytes\":0,\"error\":\"tools/call timed out after 15000 ms\"}],\"host\":{\"commit\":\"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c\",\"run\":\"https://github.com/itsHaddad/bragproof/actions/runs/43857070216\"},\"network\":{\"names\":[\"vantagemcp.dev\",\"registry.npmjs.org\"],\"conns\":[],\"callNames\":[],\"callConns\":[]}}","token":"eyJhbGciOiJSUzI1NiIsImtpZCI6IjM4ODI2YjE3LTZhMzAtNWY5Yi1iMTY5LThiZWI4MjAyZjcyMyIsInR5cCI6IkpXVCIsIng1dCI6InlrTmFZNHFNX3RhNGsyVGdaT0NFWUxrY1lsQSJ9.eyJhY3RvciI6Iml0c0hhZGRhZCIsImFjdG9yX2lkIjoiMTE0NzMyNjEiLCJhdWQiOiJicmFncHJvb2YtcmVwb3J0OjhlNzc5YTJjYWIyZTBmMmY3N2FiMjk4YWJjMDczYTljYmU5ZTFjNGRlYzEwZDliYWE2M2YwZDExMGM1MDg0MWMiLCJiYXNlX3JlZiI6IiIsImNoZWNrX3J1bl9pZCI6IjEzMzI2Mzk5NTM5OCIsImV2ZW50X25hbWUiOiJzY2hlZHVsZSIsImV4cCI6MTc5NDgzMDE5OSwiaGVhZF9yZWYiOiIiLCJpYXQiOjE3OTQ4Mjk4OTksImlzcyI6Imh0dHBzOi8vdG9rZW4uYWN0aW9ucy5naXRodWJ1c2VyY29udGVudC5jb20iLCJqb2Jfd29ya2Zsb3dfcmVmIjoiaXRzSGFkZGFkL2JyYWdwcm9vZi8uZ2l0aHViL3dvcmtmbG93cy9yZXBvcnQueW1sQHJlZnMvaGVhZHMvbWFpbiIsImpvYl93b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIiwianRpIjoiMTg4YTcyOTAtNDllMy00ZjI2LWEyZTUtYWQxMmI5NDkyMWUyIiwibmJmIjoxNzk0ODI5NTk5LCJyZWYiOiJyZWZzL2hlYWRzL21haW4iLCJyZWZfcHJvdGVjdGVkIjoiZmFsc2UiLCJyZWZfdHlwZSI6ImJyYW5jaCIsInJlcG9zaXRvcnkiOiJpdHNIYWRkYWQvYnJhZ3Byb29mIiwicmVwb3NpdG9yeV9pZCI6IjE0NTQ2MjExODMiLCJyZXBvc2l0b3J5X293bmVyIjoiaXRzSGFkZGFkIiwicmVwb3NpdG9yeV9vd25lcl9pZCI6IjExNDczMjYxIiwicmVwb3NpdG9yeV92aXNpYmlsaXR5IjoicHVibGljIiwicnVuX2F0dGVtcHQiOiIxIiwicnVuX2lkIjoiNDM4NTcwNzAyMTYiLCJydW5fbnVtYmVyIjoiMjQiLCJydW5uZXJfZW52aXJvbm1lbnQiOiJnaXRodWItaG9zdGVkIiwic2hhIjoiZWFhZmZmZmFmNTIyNTVkMWI3N2RjNGFhY2ZmZGZhZjM1M2YwYzEyYyIsInN1YiI6InJlcG86aXRzSGFkZGFkQDExNDczMjYxL2JyYWdwcm9vZkAxNDU0NjIxMTgzOnJlZjpyZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvdyI6InJlcG9ydCIsIndvcmtmbG93X3JlZiI6Iml0c0hhZGRhZC9icmFncHJvb2YvLmdpdGh1Yi93b3JrZmxvd3MvcmVwb3J0LnltbEByZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIn0.M-2jfAi-i9us4LOBHmnZOUGIXUgH1XQTxWaYeSnzsUtBXLrkoy14bmYZfITsxyqBP1DleNXlRT7wvIeQsp46dF3E_jtVwO0iFYttt5wqfgXGNVVQiLYLRK88thCyDmZ69YbnPS0Zot-aBMbOPe4qCqNsIFW-qjcLIydZgYqkiktgjfeC1grqk5bVkG78j42gUuevkH1HSl9jU-bZlqxF0c1wzIPsfWxIs23E_HSk6LtBhzXk1yNQlCctQf3YlKCKc72BUHFVRTxxBl7JF2NGUZ_bLdzZJyu987qOgaC-kZPnOpwEdKRvkaTnpRnQM7dnKOuQzAIa4kuTkQpDqJ63yA"}