Docs
MCP tools reference
Every tool the Yozigo MCP server gives Claude. All 25 are read-only and use your Yozigo sign-in.
The server address is https://mcp.yozigo.ai/mcp. To connect it, follow the steps on the MCP server page. You never call these tools yourself: you ask Claude a question, and Claude chooses the tool and fills in the arguments.
Start with list_my_brands. It lists every organization and brand your account can read, and every other tool takes one of those brands.
Which tools are there?
- Brands and account (2)
- AI visibility (5)
- Prompts and answers (5)
- Sources and competitors (2)
- Demand and opportunities (4)
- AI crawlers and traffic (1)
- SEO keywords and gaps (6)
Brands and account
Start here. Every other tool takes a brand, and these say which brands you can read and what your plan includes.
| Tool | What it returns | Main arguments |
|---|---|---|
| list_my_brands | Every organization and brand you can read in Yozigo, with brand id, domain, your role and plan. | none |
| get_entitlements | What the plan allows and how much is used: tracked prompt slots, brands, countries, page audits. | brand, window |
AI visibility
How often AI engines mention the brand, where it ranks in those answers, and how that is changing.
| Tool | What it returns | Main arguments |
|---|---|---|
| get_overview | Headline visibility, its change, sentiment, average position, checks run, and the daily trend with peak and low days. | brand, window, topics, region, engines, intent, region_split |
| compare_periods | How visibility moved across the window, day by day, to explain a change. | brand, window, topics, region, engines, intent |
| get_model_breakdown | Per-engine results: ChatGPT, Perplexity, Gemini, Google AI Overviews, AI Mode, Copilot. | brand, window, topics, region, intent |
| get_position | Average position in answers that mention the brand, how often it is first, and the spread. | brand, window, topics, region, engines, intent |
| get_intelligence | What engines say about the brand: repeated claims, whether each is accurate, and missing associations. | brand, window, topics, region, engines, intent |
Prompts and answers
The buyer questions you track, how each one performs, and what the engines searched while answering.
| Tool | What it returns | Main arguments |
|---|---|---|
| list_prompts | The prompts the brand tracks and the topics they fall under, tracked and total counts. | brand, topics, intent |
| get_prompt_performance | One row per tracked prompt: visibility, checks run and topic, best or worst first. | brand, window, topics, region, engines, intent, sort |
| get_prompt_detail | One row per prompt per engine: checks, mentions, average position and when last seen. | brand, window, topics, region, engines, intent |
| get_runs | How many checks ran and when, whether a run is in progress, and when the last one finished. | brand, window |
| get_fanout_queries | The sub-queries AI engines searched while answering the brand’s prompts. | brand, window, topics, region, engines, intent |
Sources and competitors
What AI engines cite and who they recommend instead of you.
| Tool | What it returns | Main arguments |
|---|---|---|
| get_sources | Cited domains or pages ranked by citations, the brand’s own cited pages, or sources gained and lost. | brand, window, topics, region, engines, intent, view (domains, pages, my_pages, movers) |
| get_competitors | Share of voice, mention rate, position and sentiment for the brand and each tracked competitor, or a quadrant matrix. | brand, window, topics, region, engines, intent, matrix |
Demand and opportunities
What to track next and what to work on.
| Tool | What it returns | Main arguments |
|---|---|---|
| list_suggested_prompts | Prompts the brand could track, with the demand behind each and where it was found. | brand, topics, region, intent, funnel, suggestion_source, easy_wins |
| list_suggestion_clusters | Suggested prompts grouped into clusters with their demand, for content planning. | brand, window, topics, region, intent, funnel, suggestion_source, easy_wins |
| get_suggestion_health | Whether real demand data exists and how suggestions split by funnel intent. | brand, topics |
| get_opportunities | Open opportunities ranked by impact, each with its type, urgency and why it was created. | brand, topics, intent, severities, category |
AI crawlers and traffic
Whether AI crawlers reach the site and how many people arrive from AI answers.
| Tool | What it returns | Main arguments |
|---|---|---|
| get_crawl_summary | Which AI bots crawled the site and how often, robots.txt status for each, and human visits from AI surfaces. | brand, window |
SEO keywords and gaps
Google organic data from Yozigo SEO Research, read from stored monthly snapshots. These tools never buy data; load a domain in SEO Research first.
| Tool | What it returns | Main arguments |
|---|---|---|
| get_top_keywords | The brand’s top organic keywords: position, search volume, estimated traffic, difficulty, CPC and ranking URL. | brand, country, sort, include, min_volume, max_difficulty |
| get_competitor_keywords | Top organic keywords of one tracked SEO competitor, or of each one. | brand, competitor, country, sort, include, min_volume, max_difficulty |
| get_keyword_gap | Keywords competitors rank for that the brand does not (missing), ranks lower on (weaker) or leads (stronger). | brand, gap_type, competitors, country, sort, include, min_volume, max_difficulty |
| get_seo_scorecard | Brand and tracked competitors side by side: organic traffic, keywords, backlinks, referring domains, domain rank. | brand, country |
| get_top_pages | Pages driving the most organic traffic for the brand or a tracked competitor. | brand, domain, country, sort |
| get_backlink_gap | Sites that link to tracked competitors but not to the brand. | brand, competitors, sort, include |
Which arguments do the tools share?
Every tool except list_my_brands also takes question, limit and offset. A tool rejects arguments it does not list, so a filter is never silently ignored.
| Argument | Meaning |
|---|---|
| brand | Brand name, domain or id. Optional when you have one brand; with several, the tool lists the candidates. |
| question | Your request in your own words. Yozigo reads topics, engines, regions and dates from it, so Claude passes it along. |
| window | Dates in words (“last 30 days”, “last month”, “September”) or a range. Default: last 5 days. Maximum: 90 days. |
| topics | Limit to tracked topics by name. |
| region | Country as ISO code or name, for example US, IN or United Kingdom. |
| engines | chatgpt, perplexity, gemini, ai overview, ai mode, copilot. |
| intent | informational, commercial, transactional or navigational. |
| country | SEO tools only: a brand target country, or ALL to combine them. Default: the brand’s first country. |
| limit, offset | Rows per answer (1 to 100, default 10) and where to start, for the next page. |
How do I read the answers?
- Every figure has a window. The answer states the dates it covers and says when it used the default of the last 5 days. Ask for a longer window when you need one.
- Filters are echoed back. Visibility, prompt, source and competitor results include an
appliedblock listing the brand, window, topics, engines and region actually used. - SEO data is monthly. SEO tools read stored snapshots and give their “data as of” date. If a domain or country has nothing stored, the answer names the countries that do.
- Third-party text is marked. Keywords and page titles come from outside your account. Text that reads like an instruction is flagged and its links removed.
- Metrics are defined once. Visibility, position, share of voice and the other figures are calculated as described in the methodology.
What are the limits?
- Read-only: no tool can change settings, add prompts, run checks or buy data.
- Up to 20 tool calls a minute and 500 a day per user.
- Windows longer than 90 days are shortened to the last 90 days, and the answer says so.
- Each call has a 25-second limit. Very large answers are trimmed, with a note to ask for the next page.
- SEO tools read monthly snapshots and state their “data as of” date.
Who can see what?
Claude reads with your Yozigo account. It sees the organizations and brands you see in the app, with the same admin or member role, and nothing else. A brand outside your access answers as “not found”. If your Yozigo plan is inactive, tools say so instead of returning data.