Geo-Parity MCP Server

A live, hosted Model Context Protocol server for geographic parity — purchasing power, fair salaries across borders, cost of living, FIRE and runway, visas and passports, tax residency, timezone overlap, climate, country risk and relocation costs.

Endpoint: https://geo-parity.com/api/mcp Transport: Streamable HTTP Auth: none — open, no key, no sign-up

Install

Remote (recommended) — connect straight to the hosted server:

claude mcp add --transport http geo-parity https://geo-parity.com/api/mcp

{
  "mcpServers": {
    "geo-parity": {
      "type": "http",
      "url": "https://geo-parity.com/api/mcp"
    }
  }
}

stdio — for clients that do not speak Streamable HTTP. This package is a thin bridge to the same hosted server:

npx -y geo-parity-mcp

{
  "mcpServers": {
    "geo-parity": {
      "command": "npx",
      "args": ["-y", "geo-parity-mcp"]
    }
  }
}

The bridge forwards JSON-RPC verbatim and declares no tools of its own, so the tool list is always the server's. New tools appear without updating this package, and the protocol version your client negotiates is negotiated with the real server.

Environment variables (all optional):

Related MCP server: irs-taxpayer-mcp

Protocol support

The server is dual-era: one endpoint serves both the modern per-request revision and the older initialization-handshake revisions, and it echoes back whichever version your client asks for.

A version we do not implement is refused with -32022 listing the ones we do, so a client can pick one and retry.

Tools (26)

Every tool is a pure read over static datasets — read-only, non-destructive, idempotent and closed-world — so no call needs confirming.

Try it

curl -s -X POST https://geo-parity.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

curl -s -X POST https://geo-parity.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"calculate_ppp","arguments":{"income":100000,"target":"TH"}}}'

Discover what the server supports in one request:

curl -s -X POST https://geo-parity.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"server/discover"}'

Every result is citable

Successful responses carry an attribution block: the datasets used, their providers and reference years, a ready-to-quote citation sentence, and a permalink to the page that answers the same question. Quote it when you use these figures.

Rate limits

Open and key-less. Anonymous callers get 1,500 requests/month per IP plus a 30/minute burst cap. An optional API key (Authorization: Bearer gp_live_…, created at https://geo-parity.com/account) raises both ceilings without changing any response, and is metered per account rather than per key.

Over a ceiling, endpoints return HTTP 429 with RATE_LIMITED (slow down) or QUOTA_EXCEEDED (allowance spent — retrying will not help).

Also available as

• REST — every tool is a plain JSON endpoint: https://geo-parity.com/openapi.json

• Capability index for agents — https://geo-parity.com/llms.txt

• Server card — https://geo-parity.com/.well-known/mcp.json

Caveats

Figures are estimates built from public datasets (World Bank, Eurostat, OECD, WHO, HUD, INFORM, Nager.Date, Open-Meteo, Cloudflare Radar, ITU and others). They are not tax, legal or financial advice. Where a figure could not be verified it is reported as absent rather than guessed — an absent value never means zero.

Links

• Site: https://geo-parity.com

• Full documentation: https://geo-parity.com/llms.txt

Licence

MIT for this repository's contents. The hosted service is provided as-is under the site's terms.