Getting started.

1. Get an API key

Hit /signup for a Free key (100 calls / month, no card). Save the key on first reveal — we don't show it again. For higher limits see pricing.

2. 30-second smoke test (curl)

Confirm the key works by listing the tools your tier can call:

curl -X POST https://mcp.qubitdata.it/mcp \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Response: an array of tools with input schemas. Free sees 9, Pro 19, Max 20. tools/list + initialize are free.

3. First real call

Fetch the 5 nearest healthcare facilities to the Colosseum:

curl -X POST https://mcp.qubitdata.it/mcp \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc":"2.0","id":2,"method":"tools/call",
    "params":{"name":"nearest_n","arguments":{"lat":41.9028,"lon":12.4964,"n":5,"theme":"healthcare"}}
  }'

Response: JSON array with name, source, distance in meters, lat/lon. Browse the full catalog at /tools.

4. Wire up Claude Desktop / Cursor

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or equivalent:

{
  "mcpServers": {
    "qubitdata-gis": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.qubitdata.it/mcp",
        "--header",
        "Authorization:Bearer ${MCP_KEY}"
      ],
      "env": {
        "MCP_KEY": "<your_api_key>"
      }
    }
  }
}

Set MCP_KEY to your gis_*_sk_. Restart the host. The qubitdata-gis server appears with every tool allowed by your tier.

5. What gets billed

Only successful tools/call requests count against your quota. Discovery and SSE keepalive are free. Tool errors are not billed. Useful response headers: x-mcp-calls-billed, x-mcp-calls-month, x-mcp-quota-month, x-quota-reset. Current usage: GET /v1/usage.

6. Common errors

7. Manage subscription

Update card, download invoices, cancel: Customer Portal (Pro/Max only).