Deprecated. Deprecated by the publisher: Superseded by com.acuris-geo/acuris-mcp (hosted at https://api.acuris-geo.com/mcp) — more tools, current verified/corrected vocabulary, free US/CA census enrichment.
Acuris
Address validation, UK postcode lookup (PAF), geocoding & reverse-geocoding in 240+ countries.
Runs on your machine from its package; the steps are below.
What it does
- Reads
- Writes
- High impact
At most: only reads or looks up information.
What it costs
FreeOdel charges nothing per call. The publisher may charge for its own service.
Runs locally over stdio
This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).
Run
npx -y @acuris-geo/mcp-server
MCP client config
{
"mcpServers": {
"acuris": {
"command": "npx",
"args": [
"-y",
"@acuris-geo/mcp-server"
]
}
}
}Acuris MCP Server
Model Context Protocol server for the Acuris Address Validation & Geocoding API. Plug Acuris into Claude Desktop, Claude Code, Cursor, or any MCP-aware client and your agent gains four address tools:
| Tool | What it does |
|---|---|
validate_address | Validate any postal address in 240+ countries. Returns standardised address, rooftop coordinates, confidence score (A-F), UDPRN + UPRN for UK. |
postcode_lookup | Given a UK postcode, return every Royal Mail PAF delivery point at it. |
geocode | Convert an address into latitude + longitude. |
reverse_geocode | Convert a lat/lng into the nearest known address. |
Quick start
Get a free API key (100 free validations, 100 free geocodes, 7 days, no credit card) at api.acuris-geo.com/register.
Claude Desktop
Add this to claude_desktop_config.json:
{
"mcpServers": {
"acuris": {
"command": "npx",
"args": ["-y", "@acuris-geo/mcp-server"],
"env": { "ACURIS_API_KEY": "acu_…" }
}
}
}
Restart Claude Desktop. The four tools appear under the "Acuris" server.
Claude Code
claude mcp add acuris -e ACURIS_API_KEY=acu_… -- npx -y @acuris-geo/mcp-server
Cursor / Codex / any MCP client
The server speaks plain stdio MCP. Point your client at:
ACURIS_API_KEY=acu_… npx -y @acuris-geo/mcp-server
Example prompts
After installing, try:
Validate this address: 10 Downing Street, London, SW1A 2AA
Look up every address at the UK postcode M1 1AD
What's the rooftop coordinate for the Reichstag, Berlin?
What address is at 51.5036, -0.1277?
The agent picks the right tool, calls it, and reads the JSON back to you.
Why an MCP server?
No other UK / EU address-validation provider (Ideal Postcodes, Loqate, Smarty, postcoder, getaddress.io) ships an MCP server today. If your team builds with agentic IDEs, Acuris is the only AV provider that hands you a first-class integration.
API surface
The server talks to:
POST https://api.acuris-geo.com/validatePOST https://api.acuris-geo.com/postcode-lookup(GBR — proxied topaf.acuris-geo.cominternally)GET https://api.acuris-geo.com/geocodeGET https://api.acuris-geo.com/reverse
UK requests are automatically routed to our PAF satellite (paf.acuris-geo.com) where the licensed Royal Mail PAF dataset lives. The caller doesn't need to know this.
Development
npm install
npm run build
ACURIS_API_KEY=test node dist/index.js # smoke-test with the public test key
License
MIT. Source: https://github.com/Acuris-GmbH/acuris-mcp-server.
