{
  "markdown": "# Acuris MCP Server\n\n[Model Context Protocol](https://modelcontextprotocol.io) 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:\n\n| Tool | What it does |\n|---|---|\n| `validate_address` | Validate any postal address in 240+ countries. Returns standardised address, rooftop coordinates, confidence score (A-F), UDPRN + UPRN for UK. |\n| `postcode_lookup` | Given a UK postcode, return every Royal Mail PAF delivery point at it. |\n| `geocode` | Convert an address into latitude + longitude. |\n| `reverse_geocode` | Convert a lat/lng into the nearest known address. |\n\n## Quick start\n\nGet a free API key (100 free validations, 100 free geocodes, 7 days, no credit card) at [api.acuris-geo.com/register](https://api.acuris-geo.com/register).\n\n### Claude Desktop\n\nAdd this to `claude_desktop_config.json`:\n\n```jsonc\n{\n  \"mcpServers\": {\n    \"acuris\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@acuris-geo/mcp-server\"],\n      \"env\": { \"ACURIS_API_KEY\": \"acu_…\" }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. The four tools appear under the \"Acuris\" server.\n\n### Claude Code\n\n```bash\nclaude mcp add acuris -e ACURIS_API_KEY=acu_… -- npx -y @acuris-geo/mcp-server\n```\n\n### Cursor / Codex / any MCP client\n\nThe server speaks plain stdio MCP. Point your client at:\n\n```bash\nACURIS_API_KEY=acu_… npx -y @acuris-geo/mcp-server\n```\n\n## Example prompts\n\nAfter installing, try:\n\n> *Validate this address: 10 Downing Street, London, SW1A 2AA*\n>\n> *Look up every address at the UK postcode M1 1AD*\n>\n> *What's the rooftop coordinate for the Reichstag, Berlin?*\n>\n> *What address is at 51.5036, -0.1277?*\n\nThe agent picks the right tool, calls it, and reads the JSON back to you.\n\n## Why an MCP server?\n\nNo 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.\n\n## API surface\n\nThe server talks to:\n- `POST https://api.acuris-geo.com/validate`\n- `POST https://api.acuris-geo.com/postcode-lookup` *(GBR — proxied to `paf.acuris-geo.com` internally)*\n- `GET  https://api.acuris-geo.com/geocode`\n- `GET  https://api.acuris-geo.com/reverse`\n\nUK 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.\n\n## Development\n\n```bash\nnpm install\nnpm run build\nACURIS_API_KEY=test node dist/index.js   # smoke-test with the public test key\n```\n\n## License\n\nMIT. Source: <https://github.com/Acuris-GmbH/acuris-mcp-server>.\n",
  "bytes": 2713,
  "sha": "3a239bfa40c903db0b6b773b004755dac308e8f20a03b64fbf968082ca9f7016",
  "repo_slug": "acuris-gmbh/acuris-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_acuris_gmbh_acuris_mcp_server_d3c07e73/readme"
}