{"serverInfo":{"name":"mentionedon-discovery-evidence","title":"MentionedOn","description":"See how AI assistants mention a local business. 3 public tools need no account. 10 tools need a connected MentionedOn account to read a business's saved AI answers, competitors and changes, and to prepare and verify website fixes.","version":"2.0.0","websiteUrl":"https://mentioned-on.com/developers/mcp","icons":[{"src":"https://mentioned-on.com/icon","mimeType":"image/png","sizes":["32x32"]}]},"description":"See how AI assistants mention a local business. 3 public tools need no account. 10 tools need a connected MentionedOn account to read a business's saved AI answers, competitors and changes, and to prepare and verify website fixes.","documentationUrl":"https://mentioned-on.com/developers/mcp","transport":{"type":"streamable-http","endpoint":"https://mentioned-on.com/mcp"},"protocolVersion":"2025-11-25","supportedProtocolVersions":["2025-11-25","2025-06-18","2025-03-26","2024-11-05","2024-10-07"],"capabilities":{"tools":{"listChanged":true}},"authentication":{"required":false,"description":"3 public tools need no account. 10 tools need a connected MentionedOn account (OAuth); the 3 website-fix tools that save changes also need a paid or 7-day trial monitoring slot (Local is $99/month, with a 7-day trial). Connecting an assistant costs nothing extra.","publicTools":["analyze_discovery_readiness","build_visibility_action_plan","summarize_scan_evidence"],"accountTools":["list_monitored_businesses","get_visibility_report","get_improvement_results","get_share_of_voice","list_articles","get_ai_referrals","get_website_fixes","inspect_business_website","draft_website_fixes","verify_website_fixes"],"pricing":"https://mentioned-on.com/pricing","schemes":["oauth2"],"protectedResourceMetadata":"https://mentioned-on.com/.well-known/oauth-protected-resource/mcp","authorizationServers":["https://mentioned-on.com"],"scopes":["brands:read","website:write"]},"instructions":"Start with list_monitored_businesses and get_visibility_report for the connected account. Read saved capture dates, gaps, competitors and comparable history. Use get_share_of_voice for rank among the businesses AI names and the kinds of sites it cites, get_improvement_results to see whether a published page changed answers, AI Overview citations or AI-referred visits, list_articles for drafted buyer-question articles, and get_ai_referrals for visitors arriving from assistants. Use get_website_fixes, inspect_business_website, draft_website_fixes and verify_website_fixes to prepare and check reviewed business facts. Ask before saving a fix and preserve the exact revision; never infer owner confirmation or publish a site. The 10 business tools need a connected MentionedOn account (OAuth) and current ownership; the website-fix tools that save changes also need a paid or 7-day trial monitoring slot. No tool triggers a paid model scan. The three public tools need no account, are stateless and use only supplied observations.","tools":[{"name":"analyze_discovery_readiness","title":"Analyze AI Discovery Readiness","description":"Use when the user has no account: scores signals you collect yourself (schema present, name/address/phone consistency, profiles, reviews) for AI discovery readiness. Returns a score, the gaps in priority order and what still needs verifying. Free; it does not fetch the website, run a scan, store anything or confirm inclusion in any AI product.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"businessName":{"type":"string","minLength":2,"maxLength":120,"description":"The business name used only to label this assessment."},"websiteUrl":{"description":"Optional page URL used only as a label. The tool will not fetch this URL.","type":"string","maxLength":2048,"format":"uri"},"signals":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"signal":{"type":"string","enum":["business_identity","service_location","page_description","contact_details","structured_data","corroborating_profiles","crawlability","buyer_faq","first_party_evidence","machine_summary"],"description":"The discovery-readiness signal being assessed."},"status":{"type":"string","enum":["present","partial","missing","unknown"],"description":"Observed status. Use unknown when the caller has no evidence."},"evidence":{"type":"string","minLength":3,"maxLength":500,"description":"Concise caller-supplied evidence supporting the stated status."}},"required":["signal","status"],"additionalProperties":false},"description":"Caller-supplied signal observations. Omitted signals are treated as unknown."}},"required":["businessName","signals"],"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"scope":{"type":"string","const":"caller_supplied_signals_only"},"businessName":{"type":"string"},"websiteUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"readinessScore":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}],"description":"Weighted score over observed signals only. Null when no signal was observed or evidence coverage is below minimumCoveragePercent."},"scoreBasis":{"type":"string","const":"observed_signals_only"},"scoreStatus":{"type":"string","enum":["reported","withheld_insufficient_coverage","no_observed_signals"]},"minimumCoveragePercent":{"type":"number","minimum":0,"maximum":100},"assessment":{"type":"string","enum":["strong_observed","developing_observed","limited_observed","weak_observed","insufficient_evidence"]},"evidenceCoveragePercent":{"type":"number","minimum":0,"maximum":100},"evaluatedSignals":{"minItems":10,"maxItems":10,"type":"array","items":{"type":"object","properties":{"signal":{"type":"string","enum":["business_identity","service_location","page_description","contact_details","structured_data","corroborating_profiles","crawlability","buyer_faq","first_party_evidence","machine_summary"]},"title":{"type":"string"},"status":{"type":"string","enum":["present","partial","missing","unknown"]},"weight":{"type":"integer","minimum":0,"maximum":100},"evidence":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["signal","title","status","weight","evidence"],"additionalProperties":false}},"priorities":{"maxItems":5,"type":"array","items":{"type":"object","properties":{"signal":{"type":"string","enum":["business_identity","service_location","page_description","contact_details","structured_data","corroborating_profiles","crawlability","buyer_faq","first_party_evidence","machine_summary"]},"title":{"type":"string"},"status":{"type":"string","enum":["partial","missing"]},"impactWeight":{"type":"integer","minimum":0,"maximum":100},"action":{"type":"string"},"verification":{"type":"string"}},"required":["signal","title","status","impactWeight","action","verification"],"additionalProperties":false}},"verificationNeeded":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"signal":{"type":"string","enum":["business_identity","service_location","page_description","contact_details","structured_data","corroborating_profiles","crawlability","buyer_faq","first_party_evidence","machine_summary"]},"title":{"type":"string"},"verification":{"type":"string"}},"required":["signal","title","verification"],"additionalProperties":false}},"limitations":{"minItems":1,"type":"array","items":{"type":"string"}}},"required":["scope","businessName","websiteUrl","readinessScore","scoreBasis","scoreStatus","minimumCoveragePercent","assessment","evidenceCoveragePercent","evaluatedSignals","priorities","verificationNeeded","limitations"],"additionalProperties":false},"annotations":{"title":"Analyze AI Discovery Readiness","readOnlyHint":true,"openWorldHint":false,"destructiveHint":false},"execution":{"taskSupport":"forbidden"},"securitySchemes":[{"type":"noauth"}],"_meta":{"securitySchemes":[{"type":"noauth"}]}},{"name":"build_visibility_action_plan","title":"Build an AI Visibility Action Plan","description":"Use after analyze_discovery_readiness, or with findings you already have: turns them into a short ordered list of fixes for one goal and effort budget, with the reason and a check for each. Free; it does not edit a website, contact anyone, store data or promise rankings or mentions.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"businessName":{"type":"string","minLength":2,"maxLength":120},"goal":{"type":"string","enum":["improve_discovery_clarity","strengthen_citation_evidence","prepare_for_monitoring"],"description":"The outcome used to break ties in the deterministic priority rubric."},"effortBudget":{"type":"string","enum":["lean","balanced","comprehensive"],"description":"Controls how many actions are returned and how they are phased."},"findings":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"signal":{"type":"string","enum":["business_identity","service_location","page_description","contact_details","structured_data","corroborating_profiles","crawlability","buyer_faq","first_party_evidence","machine_summary"],"description":"The discovery-readiness signal being assessed."},"status":{"type":"string","enum":["present","partial","missing","unknown"],"description":"Observed status. Use unknown when the caller has no evidence."},"evidence":{"type":"string","minLength":3,"maxLength":500,"description":"Concise caller-supplied evidence supporting the stated status."}},"required":["signal","status"],"additionalProperties":false},"description":"Caller-supplied findings. Present findings are acknowledged but do not create actions."}},"required":["businessName","goal","effortBudget","findings"],"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"scope":{"type":"string","const":"caller_supplied_findings_only"},"businessName":{"type":"string"},"goal":{"type":"string","enum":["improve_discovery_clarity","strengthen_citation_evidence","prepare_for_monitoring"]},"goalLabel":{"type":"string"},"effortBudget":{"type":"string","enum":["lean","balanced","comprehensive"]},"actions":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"phase":{"type":"string","enum":["now","next","later"]},"signal":{"type":"string","enum":["business_identity","service_location","page_description","contact_details","structured_data","corroborating_profiles","crawlability","buyer_faq","first_party_evidence","machine_summary"]},"title":{"type":"string"},"status":{"type":"string","enum":["partial","missing","unknown"]},"effort":{"type":"string","enum":["low","medium","high"]},"priorityScore":{"type":"number","minimum":0},"suppliedEvidence":{"anyOf":[{"type":"string"},{"type":"null"}]},"action":{"type":"string"},"verification":{"type":"string"}},"required":["rank","phase","signal","title","status","effort","priorityScore","suppliedEvidence","action","verification"],"additionalProperties":false}},"omittedActionCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"excludedPresentSignals":{"type":"array","items":{"type":"string","enum":["business_identity","service_location","page_description","contact_details","structured_data","corroborating_profiles","crawlability","buyer_faq","first_party_evidence","machine_summary"]}},"limitations":{"minItems":1,"type":"array","items":{"type":"string"}}},"required":["scope","businessName","goal","goalLabel","effortBudget","actions","omittedActionCount","excludedPresentSignals","limitations"],"additionalProperties":false},"annotations":{"title":"Build an AI Visibility Action Plan","readOnlyHint":true,"openWorldHint":false,"destructiveHint":false},"execution":{"taskSupport":"forbidden"},"securitySchemes":[{"type":"noauth"}],"_meta":{"securitySchemes":[{"type":"noauth"}]}},{"name":"summarize_scan_evidence","title":"Summarize AI Scan Evidence","description":"Use when you captured AI answers yourself: calculates how often the business is mentioned and how often its own site is cited, overall and per assistant, with the statements that support each number. Free; it does not call AI providers, fetch URLs or store anything, and it says nothing beyond the answers supplied.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"businessName":{"type":"string","minLength":2,"maxLength":120},"observations":{"minItems":1,"maxItems":50,"type":"array","items":{"anyOf":[{"type":"object","properties":{"sourceLabel":{"type":"string","minLength":1,"maxLength":80,"description":"Caller-supplied label for the model, product, or source."},"surfaceType":{"type":"string","enum":["model_api_capture","consumer_app_capture","search_ai_capture","other"],"description":"How the caller obtained this capture."},"prompt":{"type":"string","minLength":3,"maxLength":1000},"observedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp for the supplied capture."},"status":{"type":"string","const":"completed"},"businessMentioned":{"type":"boolean"},"businessCitationUrls":{"default":[],"description":"URLs that the caller identified as citations specifically for the named business.","maxItems":10,"type":"array","items":{"type":"string","maxLength":2048,"format":"uri"}},"position":{"type":"integer","minimum":1,"maximum":100},"sentiment":{"type":"string","enum":["positive","neutral","negative","mixed","not_scored"]}},"required":["sourceLabel","surfaceType","prompt","observedAt","status","businessMentioned"],"additionalProperties":false},{"type":"object","properties":{"sourceLabel":{"type":"string","minLength":1,"maxLength":80,"description":"Caller-supplied label for the model, product, or source."},"surfaceType":{"type":"string","enum":["model_api_capture","consumer_app_capture","search_ai_capture","other"],"description":"How the caller obtained this capture."},"prompt":{"type":"string","minLength":3,"maxLength":1000},"observedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp for the supplied capture."},"status":{"type":"string","enum":["error","skipped"]},"reason":{"type":"string","minLength":3,"maxLength":500}},"required":["sourceLabel","surfaceType","prompt","observedAt","status","reason"],"additionalProperties":false}]},"description":"Point-in-time captures supplied by the caller. The tool will not obtain new captures."}},"required":["businessName","observations"],"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"scope":{"type":"string","const":"caller_supplied_captures_only"},"businessName":{"type":"string"},"establishesLiveInclusion":{"type":"boolean","const":false},"observationCount":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"completedCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"unavailableCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"mentionCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"businessCitationCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"mentionRatePercent":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"businessCitationRatePercent":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"observedAtRange":{"anyOf":[{"type":"object","properties":{"earliest":{"type":"string"},"latest":{"type":"string"}},"required":["earliest","latest"],"additionalProperties":false},{"type":"null"}]},"uniqueBusinessCitationHosts":{"type":"array","items":{"type":"string"}},"sentimentBreakdown":{"type":"object","properties":{"positive":{"type":"integer","minimum":0,"maximum":9007199254740991},"neutral":{"type":"integer","minimum":0,"maximum":9007199254740991},"negative":{"type":"integer","minimum":0,"maximum":9007199254740991},"mixed":{"type":"integer","minimum":0,"maximum":9007199254740991},"notScored":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["positive","neutral","negative","mixed","notScored"],"additionalProperties":false},"bySource":{"type":"array","items":{"type":"object","properties":{"sourceLabel":{"type":"string"},"completedCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"unavailableCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"mentionCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"businessCitationCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"mentionRatePercent":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"businessCitationRatePercent":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]}},"required":["sourceLabel","completedCount","unavailableCount","mentionCount","businessCitationCount","mentionRatePercent","businessCitationRatePercent"],"additionalProperties":false}},"unavailable":{"type":"array","items":{"type":"object","properties":{"sourceLabel":{"type":"string"},"surfaceType":{"type":"string","enum":["model_api_capture","consumer_app_capture","search_ai_capture","other"]},"prompt":{"type":"string"},"observedAt":{"type":"string"},"status":{"type":"string","enum":["error","skipped"]},"reason":{"type":"string"}},"required":["sourceLabel","surfaceType","prompt","observedAt","status","reason"],"additionalProperties":false}},"evidenceStatements":{"minItems":1,"type":"array","items":{"type":"string"}},"limitations":{"minItems":1,"type":"array","items":{"type":"string"}}},"required":["scope","businessName","establishesLiveInclusion","observationCount","completedCount","unavailableCount","mentionCount","businessCitationCount","mentionRatePercent","businessCitationRatePercent","observedAtRange","uniqueBusinessCitationHosts","sentimentBreakdown","bySource","unavailable","evidenceStatements","limitations"],"additionalProperties":false},"annotations":{"title":"Summarize AI Scan Evidence","readOnlyHint":true,"openWorldHint":false,"destructiveHint":false},"execution":{"taskSupport":"forbidden"},"securitySchemes":[{"type":"noauth"}],"_meta":{"securitySchemes":[{"type":"noauth"}]}},{"name":"list_monitored_businesses","title":"Find your MentionedOn businesses","description":"Needs a connected MentionedOn account. Start here: lists the businesses in the account with each one's id and monitoring status, or a setup link when there are none. Pass the id as businessId to the other tools. Read-only; starts no scan, trial or charge.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{},"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"businesses":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"website":{"anyOf":[{"type":"string"},{"type":"null"}]},"active":{"type":"boolean"},"monitoring":{"type":"string","enum":["live","paused","plan_limit","off","payment_failed"]},"onboardingStatus":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","website","active","monitoring","onboardingStatus"],"additionalProperties":false}},"setupUrl":{"type":"string"},"nextStep":{"type":"string"}},"required":["businesses","setupUrl","nextStep"],"additionalProperties":false},"annotations":{"title":"Find your MentionedOn businesses","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false,"idempotentHint":true},"securitySchemes":[{"type":"oauth2","scopes":["brands:read"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["brands:read"]}]}},{"name":"get_visibility_report","title":"See visibility evidence and changes","description":"Needs a connected MentionedOn account. Use when the user asks how their business shows up in AI answers: returns the latest saved check (score, mention and citation rates, answer excerpts per assistant, competitors, cited sources) and up to 30 earlier checks, with dates, provider gaps and a score change only when checks are comparable. Needs businessId from list_monitored_businesses. Read-only; runs no new scan, so results are dated, not live.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"businessId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Business id returned by list_monitored_businesses."},"limit":{"description":"How many saved checks to return, newest first (default 30).","type":"integer","minimum":1,"maximum":30}},"required":["businessId"],"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"business":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"website":{"anyOf":[{"type":"string"},{"type":"null"}]},"active":{"type":"boolean"},"monitoring":{"type":"string","enum":["live","paused","plan_limit","off","payment_failed"]},"onboardingStatus":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","website","active","monitoring","onboardingStatus"],"additionalProperties":false},"status":{"type":"string","enum":["ready","awaiting_baseline","awaiting_checkout","plan_required","payment_failed"]},"nextStep":{"type":"string"},"latest":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"observedAt":{"type":"string"},"source":{"type":"string"},"score":{"type":"number"},"mentionRate":{"type":"number"},"citationRate":{"type":"number"},"status":{"type":"string"},"coverage":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]}},"required":["id","observedAt","source","score","mentionRate","citationRate","status","coverage"],"additionalProperties":false},{"type":"null"}]},"baseline":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"observedAt":{"type":"string"},"source":{"type":"string"},"score":{"type":"number"},"mentionRate":{"type":"number"},"citationRate":{"type":"number"},"status":{"type":"string"},"coverage":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]}},"required":["id","observedAt","source","score","mentionRate","citationRate","status","coverage"],"additionalProperties":false},{"type":"null"}]},"scoreChange":{"anyOf":[{"type":"number"},{"type":"null"}]},"history":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"observedAt":{"type":"string"},"source":{"type":"string"},"score":{"type":"number"},"mentionRate":{"type":"number"},"citationRate":{"type":"number"},"status":{"type":"string"},"coverage":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]}},"required":["id","observedAt","source","score","mentionRate","citationRate","status","coverage"],"additionalProperties":false}},"byModel":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"competitors":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"evidence":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"evidenceTruncated":{"type":"boolean"},"recommendations":{"type":"array","items":{"type":"string"}},"improvement":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"improvementHistory":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"reportUrl":{"type":"string"},"limitations":{"type":"array","items":{"type":"string"}}},"required":["business","status","nextStep","latest","baseline","scoreChange","history","byModel","competitors","evidence","evidenceTruncated","recommendations","improvement","improvementHistory","reportUrl","limitations"],"additionalProperties":false},"annotations":{"title":"See visibility evidence and changes","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false,"idempotentHint":true},"securitySchemes":[{"type":"oauth2","scopes":["brands:read"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["brands:read"]}]}},{"name":"get_improvement_results","title":"See whether an improvement worked","description":"Needs a connected MentionedOn account. Use for 'did my new page work?': returns the question being improved, the page published for it, and before/after evidence: saved assistant answers in equal windows either side of publication (same settings only), any Google AI Overview follow-up, and AI-referred visits to that page. Needs businessId. Read-only; runs no scan. A change after publication does not prove the page caused it.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"businessId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Business id returned by list_monitored_businesses."}},"required":["businessId"],"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"businessId":{"type":"string"},"improvement":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"assistants":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"googleAiOverview":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"aiVisitors":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"nextStep":{"type":"string"},"reportUrl":{"type":"string"},"limitations":{"type":"array","items":{"type":"string"}}},"required":["businessId","improvement","assistants","googleAiOverview","aiVisitors","nextStep","reportUrl","limitations"],"additionalProperties":false},"annotations":{"title":"See whether an improvement worked","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false,"idempotentHint":true},"securitySchemes":[{"type":"oauth2","scopes":["brands:read"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["brands:read"]}]}},{"name":"get_share_of_voice","title":"See share of voice and cited sources","description":"Needs a connected MentionedOn account. Use for 'who does AI recommend instead of us?': returns how often saved answers name this business versus every other business they name, its rank over saved checks, and the kinds of sites cited (own site, directories, community, press, competitors). Needs businessId. Read-only; built from saved checks, no scan.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"businessId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Business id returned by list_monitored_businesses."}},"required":["businessId"],"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"businessId":{"type":"string"},"shareOfVoice":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"citationMix":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"capturedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"reportUrl":{"type":"string"},"limitations":{"type":"array","items":{"type":"string"}}},"required":["businessId","shareOfVoice","citationMix","capturedAt","reportUrl","limitations"],"additionalProperties":false},"annotations":{"title":"See share of voice and cited sources","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false,"idempotentHint":true},"securitySchemes":[{"type":"oauth2","scopes":["brands:read"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["brands:read"]}]}},{"name":"list_articles","title":"Read drafted articles","description":"Needs a connected MentionedOn account. Use to fetch drafted articles: returns up to 20 recent drafts with the questions each targets, the buyer it was written for and the Markdown (first 4,000 characters), plus this month's usage. Needs businessId. Read-only; new drafts are made in MentionedOn and count against the plan's monthly allowance.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"businessId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Business id returned by list_monitored_businesses."}},"required":["businessId"],"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"businessId":{"type":"string"},"articles":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"usedThisMonth":{"type":"number"},"reportUrl":{"type":"string"},"limitations":{"type":"array","items":{"type":"string"}}},"required":["businessId","articles","usedThisMonth","reportUrl","limitations"],"additionalProperties":false},"annotations":{"title":"Read drafted articles","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false,"idempotentHint":true},"securitySchemes":[{"type":"oauth2","scopes":["brands:read"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["brands:read"]}]}},{"name":"get_ai_referrals","title":"See visitors from AI assistants","description":"Needs a connected MentionedOn account. Use for 'are people arriving from ChatGPT?': returns the last 30 days of website visits that came from AI assistants, by assistant and landing page, and the install snippet when one has been issued. Needs businessId. Read-only. Counts are a floor: some assistants send no referrer.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"businessId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Business id returned by list_monitored_businesses."}},"required":["businessId"],"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"businessId":{"type":"string"},"installed":{"type":"boolean"},"snippet":{"anyOf":[{"type":"string"},{"type":"null"}]},"summary":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"nextStep":{"type":"string"},"limitations":{"type":"array","items":{"type":"string"}}},"required":["businessId","installed","snippet","summary","nextStep","limitations"],"additionalProperties":false},"annotations":{"title":"See visitors from AI assistants","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false,"idempotentHint":true},"securitySchemes":[{"type":"oauth2","scopes":["brands:read"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["brands:read"]}]}},{"name":"get_website_fixes","title":"Read saved website fixes","description":"Needs a connected MentionedOn account. Use after inspect_business_website to see the current revision of saved facts, schema and copy, and whether each fix is installed. Needs businessId from list_monitored_businesses. Read-only; returns the revision number you must pass to draft_website_fixes (and to inspect_business_website and verify_website_fixes).","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"businessId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Business id returned by list_monitored_businesses."}},"required":["businessId"],"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"businessId":{"type":"string"},"record":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"nextStep":{"type":"string"},"limitations":{"type":"array","items":{"type":"string"}}},"required":["businessId","record","nextStep","limitations"],"additionalProperties":false},"annotations":{"title":"Read saved website fixes","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false,"idempotentHint":true},"securitySchemes":[{"type":"oauth2","scopes":["brands:read"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["brands:read"]}]}},{"name":"inspect_business_website","title":"Inspect your business website","description":"Needs a connected MentionedOn account with a paid or 7-day trial monitoring slot (Local is $99/month). Use first when fixing business information: fetches a few public pages of the saved business website and saves candidate facts with where each was found. Pass revision from get_website_fixes (0 if none) and authorizationAcknowledged: true once the user confirms they own the site. Saves a new revision; refused once drafts exist; up to 20 website checks a day. Runs no AI scan and publishes nothing.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"businessId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Business id returned by list_monitored_businesses."},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer from get_website_fixes (the current saved revision); use 0 when no record exists."},"authorizationAcknowledged":{"type":"boolean","const":true,"description":"true once the user confirms they own or may inspect this website."}},"required":["businessId","revision","authorizationAcknowledged"],"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"businessId":{"type":"string"},"record":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"nextStep":{"type":"string"},"limitations":{"type":"array","items":{"type":"string"}}},"required":["businessId","record","nextStep","limitations"],"additionalProperties":false},"annotations":{"title":"Inspect your business website","readOnlyHint":false,"destructiveHint":false,"openWorldHint":true,"idempotentHint":false},"securitySchemes":[{"type":"oauth2","scopes":["website:write"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["website:write"]}]}},{"name":"draft_website_fixes","title":"Prepare confirmed website fixes","description":"Needs a connected MentionedOn account with a paid or 7-day trial monitoring slot (Local is $99/month). Use after the user confirms the facts from inspect_business_website: generates and saves business schema, website copy and a business-profile description from those facts only. Pass the current revision and confirmed: true; never invent missing facts. Saves a new revision; no AI model cost, nothing is published or sent.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"businessId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Business id returned by list_monitored_businesses."},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer from get_website_fixes (the current saved revision); use 0 when no record exists."},"facts":{"type":"object","properties":{"name":{"type":"string","maxLength":300},"description":{"type":"string","maxLength":700},"streetAddress":{"type":"string","maxLength":300},"addressLocality":{"type":"string","maxLength":300},"addressRegion":{"type":"string","maxLength":300},"postalCode":{"type":"string","maxLength":300},"addressCountry":{"type":"string","maxLength":300},"telephone":{"type":"string","maxLength":300},"email":{"type":"string","maxLength":300},"openingHours":{"type":"string","maxLength":300},"services":{"type":"string","maxLength":1000}},"additionalProperties":false,"description":"Business facts the user confirmed, from the inspection."},"businessType":{"type":"string","enum":["LocalBusiness","ProfessionalService","HomeAndConstructionBusiness","Plumber","Electrician","HVACBusiness","RoofingContractor","Dentist","MedicalBusiness","LegalService","RealEstateAgent","Restaurant","LodgingBusiness","Store","AutoRepair","BeautySalon"],"description":"schema.org business type for the generated schema."},"confirmed":{"type":"boolean","const":true,"description":"true once the user has reviewed and confirmed these facts."}},"required":["businessId","revision","facts","businessType","confirmed"],"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"businessId":{"type":"string"},"record":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"nextStep":{"type":"string"},"limitations":{"type":"array","items":{"type":"string"}}},"required":["businessId","record","nextStep","limitations"],"additionalProperties":false},"annotations":{"title":"Prepare confirmed website fixes","readOnlyHint":false,"destructiveHint":false,"openWorldHint":false,"idempotentHint":false},"securitySchemes":[{"type":"oauth2","scopes":["website:write"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["website:write"]}]}},{"name":"verify_website_fixes","title":"Verify installed website fixes","description":"Needs a connected MentionedOn account with a paid or 7-day trial monitoring slot (Local is $99/month). Use after the user installs the fixes: fetches one page on the business's own website and checks it for the saved schema and text, saving found, not-found or unknown results against that revision. Up to 20 website checks a day. A found fix does not prove better AI visibility.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"businessId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Business id returned by list_monitored_businesses."},"revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"description":"Integer from get_website_fixes."},"url":{"type":"string","minLength":1,"maxLength":2000,"description":"Page on the owned domain where the fixes are installed."},"authorizationAcknowledged":{"type":"boolean","const":true,"description":"true once the user confirms they own or may check this website."}},"required":["businessId","revision","url","authorizationAcknowledged"],"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"businessId":{"type":"string"},"record":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"nextStep":{"type":"string"},"limitations":{"type":"array","items":{"type":"string"}}},"required":["businessId","record","nextStep","limitations"],"additionalProperties":false},"annotations":{"title":"Verify installed website fixes","readOnlyHint":false,"destructiveHint":false,"openWorldHint":true,"idempotentHint":false},"securitySchemes":[{"type":"oauth2","scopes":["website:write"]}],"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["website:write"]}]}}],"resources":[],"prompts":[]}