Home · Tools · list_geo_gaps

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.

Slug
list_geo_gaps
Cost
5 credits
Latency
~6s
Rate limit
30/min

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.