Acuris Geo MCP Server

Give any AI agent — Claude, Cursor, ChatGPT, Gemini CLI and every other MCP-capable client — direct, self-describing access to Acuris address validation and geocoding: 240+ countries, honest verified / corrected / partial verdicts, UK addresses against the official Royal Mail PAF (UDPRN + UPRN), and free census & geographic enrichment for street-accurate USA/Canada matches (census tract, block group, FIPS, CBSA/MSA, congressional district, school district — Canadian equivalents included).

The server is a thin layer on top of the Acuris REST API: every tool call is billed, refunded and rate-limited exactly like the API call it wraps, under your own API key. Failed lookups are refunded automatically — you pay for results, not attempts.

Quick start — hosted endpoint (recommended, zero install)

Claude Code

claude mcp add --transport http acuris-geo https://api.acuris-geo.com/mcp \
  --header "Authorization: Bearer YOUR_ACURIS_API_KEY"

Claude Desktop / any JSON-config client

{
  "mcpServers": {
    "acuris-geo": {
      "type": "http",
      "url": "https://api.acuris-geo.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_ACURIS_API_KEY" }
    }
  }
}

Cursor (.cursor/mcp.json)

{ "mcpServers": { "acuris-geo": {
    "url": "https://api.acuris-geo.com/mcp",
    "headers": { "Authorization": "Bearer YOUR_ACURIS_API_KEY" } } } }

No API key yet? Connect without one and call the request_trial_key tool with your email — you get an instant free trial key (100 credits, 7 days, no card, no signup form). Then reconnect with the key.

Tools

No-match and error responses are refunded automatically.

Local (stdio) mode

pip install acuris-mcp        # or: uvx acuris-mcp --stdio
ACURIS_API_KEY=YOUR_KEY acuris-mcp --stdio

Claude Desktop stdio config:

{
  "mcpServers": {
    "acuris-geo": {
      "command": "uvx",
      "args": ["acuris-mcp", "--stdio"],
      "env": { "ACURIS_API_KEY": "YOUR_KEY" }
    }
  }
}

Same tools, same billing. The hosted endpoint is recommended — zero install and always current.

Docs & links

• Full MCP docs: https://api.acuris-geo.com/docs/mcp
• REST API reference: https://api.acuris-geo.com/docs
• Pricing: https://www.acuris-geo.com/acuris-pricing/
• US/Canada enrichment: https://www.acuris-geo.com/us-canada-address-enrichment/
• Excel add-in (same engine, no code): https://www.acuris-geo.com/excel-add-in/

License

MIT (this connector). The Acuris API itself is a commercial service — see the terms.