GeoMaestros for Claude Desktop, Cursor & ChatGPT Desktop

What you can ask

• "What is my share of voice this week?"
• "List my tracked hotels."
• "Which competitors should I worry about?"
• "Show me the most recent AI search evidence for my brand."
• "What are last week's biggest visibility gaps?"

Install in 60 seconds

1. 1. Sign in at app.geomaestros.com.
2. 2. Open Settings → MCP tokens and click Mint new token. Copy the token immediately — it is shown only once.
3. 3. Open Claude Desktop's config file (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json) and paste:

   {
     "mcpServers": {
       "geomaestros": {
         "transport": {
           "type": "streamable-http",
           "url": "https://api.geomaestros.com/v1/mcp",
           "headers": { "Authorization": "Bearer YOUR_TOKEN" }
         }
       }
     }
   }

4. 4. Restart Claude Desktop. Type list my GeoMaestros properties. You should see the live answer.

7 read-only tools (write tools opt-in)

All tools are scoped to the workspace your token was minted for. Add mcp:write at mint time only if you need write actions.

• list_propertiesTracked hotels, destinations, brands.
• list_keywordsActive queries, intent, last visibility.
• get_sovOverall + AI Overview + Local Pack SOV.
• get_share_of_voice_trendWeekly trend, last N weeks.
• get_evidenceRecent AI search evidence rows.
• get_competitorsTracked competitors with prospect score.
• get_visibility_gapsRecent why-they-won analyses.

Security

• MCP tokens carry an audience claim. They cannot be replayed against any non-MCP endpoint.
• Rate-limited per workspace and per user. Write tools have a tighter bucket so a leaked write token cannot burn your tracking quota in one burst.
• 90-day default expiry. Revocation propagates within 30 seconds.
• Every tool call is audited. Workspace members can read the invocation log for transparency.

FAQ