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 evaluation key (1,000 lookups plus 50 UK lookups, valid 30 days, no card, no signup form). Before the key is issued the user must agree to the Terms of Service and the UK PAF Evaluation Terms; the tool asks for that confirmation first. 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.