Docs

1. Billing

Only successful tools/call requests count toward your quota. Discovery (tools/list, initialize) and SSE keepalive are free. Tool errors are not billed.

2. 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 all tools allowed by your tier.

3. Direct JSON-RPC

For custom agents:

# list tools (free)
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"}'

# call a tool (billed +1 on success)
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.9,"lon":12.5,"n":5,"theme":"healthcare"}}
  }'

# current usage
curl https://mcp.qubitdata.it/v1/usage -H "Authorization: Bearer $KEY"

Response headers: x-mcp-calls-billed, x-mcp-calls-month, x-mcp-quota-month, x-quota-reset.

4. Tools

• list_sources
• describe_table
• relationships_graph
• spatial_search
• property_neighborhood
• points_in_polygon
• density_grid
• nearest_n
• time_window
• theme_overview
• query_sql

Schemas: tools/list returns input schemas for every tool your tier can call.

5. Errors

6. Manage subscription

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