Acuris Mcp Server

authSTDIOregistry active

Summary

Connects Claude to the Acuris Address Validation API with four tools: validate_address for standardizing postal addresses across 240+ countries with rooftop coordinates and confidence scores, postcode_lookup for querying Royal Mail PAF delivery points at UK postcodes, geocode for lat/lng conversion, and reverse_geocode for coordinate to address lookups. Returns structured JSON with UDPRN and UPRN identifiers for UK addresses. Reach for this when you need production grade address validation in agentic workflows, especially if you're working with UK or European addresses and want Royal Mail PAF coverage. Free tier gives you 100 validations and 100 geocodes for testing. Runs via npx with just an API key.

CodeRabbit

AI writes the code. CodeRabbit catches the slop.

Try For Free →

Make your agent a DeFi expert

Agent, run crypto. Access onchain data & trade routes via 1inch.

Install now →

AppSignal

Monitor with ease. Code with confidence.

Start Free Trial →

Make money from your Skills

On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.

Start earning →

Put your SEO on autopilot

An agent that runs the SEO playbooks that move rankings and ships PRs you control.

Get founding access →

Vibe Prospecting MCP

Connect Claude to +800M contacts, +150M companies. Find & Enrich leads in chat.

Try For Free →

CodeRabbit

AI writes the code. CodeRabbit catches the slop.

Try For Free →

Make your agent a DeFi expert

Agent, run crypto. Access onchain data & trade routes via 1inch.

Install now →

AppSignal

Monitor with ease. Code with confidence.

Start Free Trial →

Make money from your Skills

On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.

Start earning →

Put your SEO on autopilot

An agent that runs the SEO playbooks that move rankings and ships PRs you control.

Get founding access →

Vibe Prospecting MCP

Connect Claude to +800M contacts, +150M companies. Find & Enrich leads in chat.

Try For Free →

Featured

CodeRabbit

AI writes the code. CodeRabbit catches the slop.

Try For Free →

Make your agent a DeFi expert

Agent, run crypto. Access onchain data & trade routes via 1inch.

Install now →

AppSignal

Monitor with ease. Code with confidence.

Start Free Trial →

Make money from your Skills

On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.

Start earning →

Put your SEO on autopilot

An agent that runs the SEO playbooks that move rankings and ships PRs you control.

Get founding access →

Vibe Prospecting MCP

Connect Claude to +800M contacts, +150M companies. Find & Enrich leads in chat.

Try For Free →

Configuration

ACURIS_API_KEY*secret

Acuris API key. Get a free key (100 validations + 100 geocodes, 7 days, no card) at https://api.acuris-geo.com/register

Registryactive

Package@acuris-geo/mcp-server

TransportSTDIO

AuthRequired

UpdatedJun 9, 2026

View on GitHub

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/validate
POST https://api.acuris-geo.com/postcode-lookup (GBR — proxied to paf.acuris-geo.com internally)
GET https://api.acuris-geo.com/geocode
GET 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.