Acuris Mcp Server

io.github.Acuris-GmbHPublished by GitHub account Acuris-GmbHv0.1.1Updated Oct 24, 2026

Address validation, UK postcode lookup (PAF), geocoding & reverse-geocoding in 240+ countries.

The publisher's own server: Acuris Mcp

VerifiedSTDIODesktop onlyLocation & LifestyleData & Analytics

Overview

AI-generated overview

Local MCP server that gives an assistant Acuris address validation, UK postcode (PAF) lookup, geocoding and reverse geocoding in 240+ countries.

What you can do
  • Validate postal addresses in 240+ countries, returning a standardised address, rooftop coordinates, a confidence grade and UK UDPRN/UPRN identifiers
  • Look up every Royal Mail PAF delivery point at a given UK postcode
  • Convert an address into latitude and longitude
  • Convert coordinates into the nearest known address
When to use it
Useful when an agent needs to check or clean postal addresses, resolve UK postcodes to delivery points, or turn addresses into coordinates and back, for example in data entry, delivery or location-aware workflows.
Requirements
Runs locally over stdio, typically launched with npx from the npm package, so Node.js is needed. Requires an Acuris API key supplied in the ACURIS_API_KEY environment variable; a free trial key is available. Network access to the Acuris API is required. Desktop MCP clients only.
Before you install
The API key is a secret passed in plain text in the client configuration; keep it out of shared files. Each validation and geocode call consumes the account's quota, so heavy use can incur usage costs after the free allowance. Addresses and coordinates you submit are sent to Acuris's servers, including a UK PAF satellite for UK requests.

Installation

In SourceWeft

  1. Open Acuris Mcp Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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:

ToolWhat it does
validate_addressValidate any postal address in 240+ countries. Returns standardised address, rooftop coordinates, confidence score (A-F), UDPRN + UPRN for UK.
postcode_lookupGiven a UK postcode, return every Royal Mail PAF delivery point at it.
geocodeConvert an address into latitude + longitude.
reverse_geocodeConvert 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:

jsonc
{  "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

bash
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:

bash
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

bash
npm installnpm run buildACURIS_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.

Source: README.md at commit 436a2e6

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Acuris-Geo integrations