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. 100 credits. 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": 100 }
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": 100 }
Data sources
MentionFox surfaces mentions across 50+ public platforms — forums, communities, news, podcasts, video transcripts, niche subreddits, and more. We don't crawl private channels like Slack or Discord (those stay private by design). Every claim in your reports is citation-linked back to its source.
Credit cost & rate limits
Flat 100 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.