# acuris-mcp MCP server

Address validation & geocoding for AI agents: 240+ countries, UK PAF, free US/CA enrichment

## Links
- Registry page: https://www.getdrio.com/mcp/com-acuris-geo-acuris-mcp
- Repository: https://github.com/Acuris-GmbH/acuris-mcp
- Website: https://api.acuris-geo.com/docs/mcp

## Install
- Endpoint: https://api.acuris-geo.com/mcp
- Auth: Auth required by registry metadata

## Setup notes
- Remote header: Authorization (secret)
- The upstream registry signals required auth or secrets.
- Remote endpoint: https://api.acuris-geo.com/mcp
- Header: Authorization

## Tools
- validate_address - Validate and standardize one postal address (240+ countries; UK via the
    official Royal Mail PAF with UDPRN + UPRN).

    Give `country` as ISO-3 lowercase (e.g. usa, can, deu, gbr) plus EITHER a
    free-text `address_line` OR fielded parts (street, house_number, city,
    state, postcode). Returns an honest verdict — status "verified" (exact) or
    "corrected" (fixed), or partial_match with reasons — plus the standardized
    form, confidence, coordinates with an explicit accuracy_type, and, for
    street-accurate USA/Canada matches, a FREE `enrichment` block (census
    tract, block group, FIPS, CBSA/MSA, congressional district, school
    district / Canadian equivalents).

    Cost: 1 validation credit per successful lookup; no-match and errors are
    refunded automatically (you pay for results, not attempts). Endpoint: https://api.acuris-geo.com/mcp
- validate_addresses_batch - Validate up to 50 addresses in one call (mixed countries allowed).

    `addresses` is a list where each entry is either a free-text string, or an
    object {"input": <string or fielded object>, "country": "iso3"}. Entries
    without their own country use the `country` parameter. UK (gbr) rows are
    routed individually to the Royal Mail PAF service; everything else goes
    through the batch endpoint. Results come back in the same order, each with
    the same shape as validate_address.

    Cost: 1 validation credit per successfully validated row; failed rows are
    refunded. For files bigger than 50 rows, call this tool repeatedly. Endpoint: https://api.acuris-geo.com/mcp
- enrich_us_ca_address - Address → census & geographic codes (USA + Canada), FREE with validation.

    USA: state & county FIPS, census tract (11-digit GEOID), block group,
    CBSA/MSA, congressional district (119th Congress), school district.
    Canada: province, census division, dissemination area, census subdivision,
    census tract, CMA/CA, federal electoral district. Sources: US Census
    Bureau TIGER/Line; Statistics Canada (open data).

    The enrichment is attached when the address resolves to a house-number- or
    street-accurate match; centroid-only matches return no enrichment (the
    point could fall in the wrong area). `country` must be "usa" or "can".

    Cost: 1 validation credit (the enrichment itself is free); failed lookups
    are refunded. Endpoint: https://api.acuris-geo.com/mcp
- geocode_address - Forward-geocode an address to coordinates (lat/lng) with an explicit
    accuracy_type — you always know what you got.

    accuracy_type is an OPEN set; new tiers are added as reference data
    improves. Do NOT write code that treats an unrecognised value as a failure.
    Branch on the boolean `point_coordinate` instead, which is true when the
    coordinate identifies one address. Current values: rooftop and
    arrival_point (both point coordinates — a point on the building, or the
    property's entrance / access point), then street_interpolated,
    street_centroid, postcode_centroid, locality_centroid, admin_centroid.

    House-number-level matches may ALSO carry `arrival_point: {lat, lng}` —
    the premise's entrance/access coordinate beside the served pin (equal to
    lat/lng when accuracy_type is arrival_point). Use it for delivery and
    navigation; omitted when not on file.

    `country` is ISO-3 lowercase. Give fielded parts or a single line in `q`.
    For UK (gbr) addresses use validate_address instead — it returns point
    coordinates from Royal Mail PAF.

    Cost: 1 credit per successful geocode; failures are refunded. Endpoint: https://api.acuris-geo.com/mcp
- reverse_geocode - Coordinates → nearest address(es). Returns the closest reference
    addresses to (lat, lng), nearest first, with distances.

    Optional: `country` (ISO-3) to constrain the search, `radius_m`, `limit`.

    Cost: 1 credit per successful lookup; an empty radius (no addresses found)
    is refunded. Endpoint: https://api.acuris-geo.com/mcp
- expand_uk_postcode - Expand a UK postcode into every Royal Mail delivery point at that
    postcode — organisation, building, street, town, county, plus UDPRN, UPRN
    and rooftop coordinates for each address.

    Cost: 1 credit per postcode, regardless of how many addresses come back;
    an unknown/invalid postcode is refunded automatically. Endpoint: https://api.acuris-geo.com/mcp
- check_balance - Show the connected API key's remaining credit balances (validation,
    geocode, email, phone pools; trial expiry; the UK free-trial PAF counter
    for trial keys). Free — never consumes credits. Endpoint: https://api.acuris-geo.com/mcp
- request_trial_key - Get an instant FREE Acuris trial API key — 100 credits, valid 7 days,
    no card, no signup form. Idempotent: asking again with the same email
    within 24h returns the SAME key.

    After receiving the key, reconfigure this MCP server connection with the
    header "Authorization: Bearer <key>" (or set ACURIS_API_KEY for stdio).
    Trial limits: shared per-IP daily caps and a lifetime cap of 40 UK (Royal
    Mail PAF) lookups. Paid plans: https://www.acuris-geo.com/acuris-pricing/ Endpoint: https://api.acuris-geo.com/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: com.acuris-geo
- Version: 1.0.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 26, 2026
- Source: https://registry.modelcontextprotocol.io