acuris-mcp-server

Name: acuris-mcp-server
Author: Acuris-GmbH

Local

acuris-geo.comMaps & Travel0Updated 20w ago

Repository Visit website

About acuris-mcp-server

acuris-mcp-server connects the Acuris Address Validation & Geocoding API to MCP clients, for agents handling international addresses and UK postcodes. Results include standardized addresses, confidence scores, and coordinates, with UK Royal Mail PAF delivery-point lookup.

Key features

01Validate and standardize addresses in 240+ countries
02Look up UK postcode PAF delivery points
03Convert addresses to latitude and longitude
04Find nearby addresses from coordinates

Use cases

01Validate and standardize submitted addresses
02Find delivery addresses for a UK postcode
03Add geographic coordinates to address records
04Identify nearby addresses from coordinates

MCP support

The MCP server exposes four tools for address validation, UK postcode lookup, geocoding, and reverse geocoding. It processes requests through the Acuris Address Validation & Geocoding API.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

{
  "mcpServers": {
    "acuris-gmbh-acuris": {
      "command": "npx",
      "args": [
        "-y",
        "@acuris-geo/mcp-server"
      ],
      "env": {
        "ACURIS_API_KEY": "<ACURIS_API_KEY>"
      }
    }
  }
}

Run commandnpx -y @acuris-geo/mcp-server

Environment variables to set

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

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

npm@acuris-geo/mcp-server0.1.1stdio

Tools

Saved tool list · updated 2w ago

Parameter	Type	Required	Description
city	string	No	City / locality.
input	string	No	Single-line address — paste the whole address as one string, e.g. `10 Downing Street, London, SW1A 2AA`. Provide this OR the fielded inputs below.
state	string	No	State / region — required for USA, CAN, AUS, BRA, MEX.
street	string	No	Street name (fielded input).
country	string	Yes	ISO 3-letter country code (preferred, e.g. `gbr`, `usa`, `deu`, `fra`). ISO-2 also accepted.
postcode	string	No	Postcode / ZIP.
house_number	string	No	House / building number.

Details

From the project README

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.