get_geofixer_top_actionsThe 5 actions that move the needle most.

When the agent has limited time and budget, it needs the prioritised work-list, not the exhaustive one. get_geofixer_top_actions returns the top 5 highest-leverage GEO actions for a domain, ranked by expected fix-rate uplift, with a difficulty score and a one-line "how-to" each. Two credits. About two seconds.

When to call this tool

Use it whenever the consumer is a human or another agent that wants the smallest possible action set with the highest payoff. Daily prompts ("what should I do today?") and weekly planning prompts both fit. Each action has a deterministic id and a difficulty score, so the agent can filter on "actions a writer can ship today" versus "actions that need engineering".

Input schema

{ "domain": "…", "max_difficulty": "integer  // 0-100, default 100" }

Output schema

{
  "actions": [
    { "id", "title", "how_to", "expected_uplift": 0-100, "difficulty": 0-100 }
  ],
  "credits_used": 2
}

Example invocations

1. Claude Desktop

What are my top 5 GEO actions for example.com today?
Filter to anything our writer can ship without engineering.

2. ChatGPT custom GPT

"What should I do today" → call get_geofixer_top_actions
with max_difficulty 60. Show as numbered checklist.

3. Cursor MCP

Build a daily-actions CLI that pipes top_actions to Linear.

4. n8n

{ "jsonrpc": "2.0", "method": "tools/call",
  "params": { "name": "get_geofixer_top_actions", "arguments": { "domain": "linear.app" } } }

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":"get_geofixer_top_actions","arguments":{"domain":"vercel.com","max_difficulty":70}}}'

Sample output

{
  "actions": [
    { "id": "act_4f2",
      "title": "Add a /vs/competitor-x comparison page",
      "how_to": "Single page, balanced tone, link to docs.",
      "expected_uplift": 14, "difficulty": 42 }
  ],
  "credits_used": 2
}

Credit cost & rate limits

Flat 2 credits. 60 calls per minute per key.

Error codes & recovery