Connect your agent to ShowMeOnMap

1 · Get a key

Buy a credit pack (from $5 for 100 credits), then open the account menu → API keys → Create key. Copy the smo_live_… key — it is shown exactly once. Revoke any key from the same menu.

Every map your agents build spends your credits at web-app rates: 1 credit per standard map or mutation, 3 per agent-grade map; reads and exports are free. Failed requests are refunded automatically.

2 · Connect — hosted endpoint (recommended)

No install. Point any remote-MCP client at the endpoint with your key — Claude custom connectors, Cursor, Windsurf, Copilot Studio, Bedrock, and Google Gemini all accept this shape (and any newer client that speaks remote MCP):

{
  "mcpServers": {
    "showmeonmap": {
      "url": "https://showmeonmap.com/api/mcp",
      "headers": { "Authorization": "Bearer smo_live_YOUR_KEY" }
    }
  }
}

From the OpenAI Responses API / Agents SDK:

// OpenAI Responses API — remote MCP tool
{
  "model": "gpt-5",
  "tools": [{
    "type": "mcp",
    "server_label": "showmeonmap",
    "server_url": "https://showmeonmap.com/api/mcp",
    "headers": { "Authorization": "Bearer smo_live_YOUR_KEY" }
  }],
  "input": "Map earthquakes above magnitude 5 near Japan this month"
}

Or raw JSON-RPC over HTTP:

curl https://showmeonmap.com/api/mcp \
  -H 'Authorization: Bearer smo_live_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

3 · Or run it locally (stdio)

For clients that spawn local MCP servers (Claude Desktop, Zed), use the npm package — same tools, same key:

{
  "mcpServers": {
    "showmeonmap": {
      "command": "npx",
      "args": ["-y", "@showmeonmap/mcp"],
      "env": {
        "SHOWMEONMAP_BASE_URL": "https://showmeonmap.com",
        "SHOWMEONMAP_API_KEY": "smo_live_YOUR_KEY"
      }
    }
  }
}

What your agent can do

build_map bootstraps a workspace from a natural-language query; mutate_map and 14 typed operations refine it (filter, restyle, camera, annotations, time windows); add_fusion_layer and correlate_layers run bivariate analysis; exports deliver CSV / GeoJSON / image links. Every response carries a shareable_url — a live map page your agent can hand straight to a human.

Limits & notes

• 30 requests/min per key (429 with Retry-After past that; throttled requests never spend credits).
• Up to 10 active keys per account — mint one per agent so a misbehaving one can be revoked alone.
• The hosted endpoint is stateless streamable HTTP; send JSON-RPC via POST (no SSE stream).
• Some MCP hosts cap tool-result sizes (~150k chars on claude.ai) — very large layers may truncate; the shareable_url always carries the full map.
• Keys never expire; revocation is permanent and immediate.

Questions

See how ShowMeOnMap works and pricing. The MCP client package is open source (Apache-2.0): @showmeonmap/mcp.