English Français العربية

com.acuris-geo/acuris-mcp

Official registry AI and agents

Address validation & geocoding for AI agents: 240+ countries, UK PAF, free US/CA enrichment

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http acuris-mcp 'https://api.acuris-geo.com/mcp' --header 'Authorization: <Bearer <your Acuris API key> — get a free trial key via the request_trial_key tool or https://www.acuris-geo.com/acuris-pricing/>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "acuris-mcp": {
            "type": "http",
            "url": "https://api.acuris-geo.com/mcp",
            "headers": {
                "Authorization": "<Bearer <your Acuris API key> — get a free trial key via the request_trial_key tool or https://www.acuris-geo.com/acuris-pricing/>"
            }
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Acuris Geo MCP Server
  2. Quick start — hosted endpoint (recommended, zero install)
  3. Tools
  4. Local (stdio) mode
  5. Docs & links
  6. License

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.

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

ToolWhat it doesCost
validate_addressValidate & standardize one address (240+ countries; UK via Royal Mail PAF with UDPRN + UPRN). Street-accurate USA/Canada matches include the free census enrichment block.1 credit
validate_addresses_batchUp to 50 addresses per call, mixed countries. Results in input order.1 credit / row
enrich_us_ca_addressAddress → census tract, block group, county/state FIPS, CBSA/MSA, congressional district, school district (USA) / dissemination area, census division, CMA/CA, federal electoral district (Canada).1 credit (enrichment free)
geocode_addressForward geocoding with an explicit accuracy_type on every result.1 credit
reverse_geocodeCoordinates → nearest addresses with distances.1 credit
expand_uk_postcodeUK postcode → every Royal Mail delivery point (organisation, UDPRN, UPRN, rooftop coordinates).1 credit / postcode
check_balanceRemaining credit balances for the connected key.free
request_trial_keyInstant free trial key by email (idempotent for 24h).free

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.

License

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

Frequently asked questions

What is com.acuris-geo/acuris-mcp?

Address validation & geocoding for AI agents: 240+ countries, UK PAF, free US/CA enrichment

How do I install com.acuris-geo/acuris-mcp?

It runs as a remote server. In Claude Code: claude mcp add --transport http acuris-mcp 'https://api.acuris-geo.com/mcp' --header 'Authorization: <Bearer <your Acuris API key> — get a free trial key via the request_trial_key tool or https://www.acuris-geo.com/acuris-pricing/>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does com.acuris-geo/acuris-mcp need an API key?

Yes. It expects Authorization, which you set in its configuration.

Is com.acuris-geo/acuris-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains com.acuris-geo/acuris-mcp?

It is published by Acuris-GmbH. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.