list_geo_gapsThe prompts where your brand is missing.
Once you know your GEO score, you want the actionable list — exactly which category prompts return your competitors instead of you, ranked by how fixable each gap is. list_geo_gaps returns that list. Five credits. About six seconds. The bridge between audit and action.
When to call this tool
Use it when you want to translate the citation matrix from run_geo_audit into a work-list a human or an agent can act on. Each gap returned includes the prompt itself, the engine, the brands that did get cited, and a fixability score derived from the difficulty of intervening on that exact gap (e.g. "needs a top-10 listicle citation" is easier than "needs an authoritative whitepaper").
Many teams run this once a week against a refreshed audit, hand the top 10 gaps to a writer, and re-audit a fortnight later. It is also the natural input to run_geofixer_audit, which automates the fix steps.
Input schema
{ "domain": "…", "depth": "enum: 'top10' | 'top50' | 'all'", "category": "string" }
Output schema
{ "gaps": [ { "prompt", "engine", "competitors_cited", "fixability": 0-100, "suggested_fix" } ], "credits_used": 5 }
Example invocations
1. Claude Desktop
List my top-10 GEO gaps for example.com. Sort by fixability.
2. ChatGPT custom GPT
For "where am I missing in AI search" prompts, call list_geo_gaps and translate suggested_fix into a checklist.
3. Cursor MCP
Use list_geo_gaps for resend.com and write a markdown brief assigning each gap to a content owner.
4. n8n
{ "jsonrpc": "2.0", "method": "tools/call", "params": { "name": "list_geo_gaps", "arguments": { "domain": "vercel.com", "depth": "top10" } } }
5. Raw curl
curl -X POST https://www.mentionfox.com/mcp \ -H "Authorization: Bearer $FOXAPIS_KEY" \ -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"list_geo_gaps","arguments":{"domain":"linear.app","depth":"top10"}}}'
Sample output
{ "gaps": [ { "prompt": "best issue tracker for solo founders", "engine": "perplexity", "competitors_cited": ["GitHub Issues", "Trello"], "fixability": 82, "suggested_fix": "Pitch a top-10 listicle inclusion via founder community." } ], "credits_used": 5 }
Credit cost & rate limits
Flat 5 credits. 30 calls per minute per key.
Error codes & recovery
404 NO_AUDITDomain has no audit yet. Call run_geo_audit first.422 STALEAudit data older than 30 days. Re-run the audit.