protogrid

Search / com.acuris-geo/acuris-mcp

acuris-mcp

R0· no sign-in

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

v1.0.0 · active · repository · website · descriptor JSON · versions

An agent can connect right now, no human step.Remote endpoint, no authentication, reachable on the last probe.
Quality76good
Trust93of 100
Uptime, 30 days100%
Latency p50975 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "acuris-mcp": {
      "type": "http",
      "url": "https://api.acuris-geo.com/mcp",
      "headers": {
        "Authorization": "Bearer ${ACURIS_MCP_TOKEN}"
      }
    }
  }
}
claude mcp add --transport http acuris-mcp https://api.acuris-geo.com/mcp --header "Authorization: Bearer ${ACURIS_MCP_TOKEN}"
[mcp_servers.acuris-mcp]
url = "https://api.acuris-geo.com/mcp"
bearer_token_env_var = "ACURIS_MCP_TOKEN"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "acuris-mcp": {
      "type": "remote",
      "url": "https://api.acuris-geo.com/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:ACURIS_MCP_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "acuris-mcp": {
      "type": "http",
      "url": "https://api.acuris-geo.com/mcp",
      "headers": {
        "Authorization": "Bearer ${ACURIS_MCP_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=acuris-mcp&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYXBpLmFjdXJpcy1nZW8uY29tL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciAke0FDVVJJU19NQ1BfVE9LRU59In19"
}
{
  "servers": {
    "acuris-mcp": {
      "type": "http",
      "url": "https://api.acuris-geo.com/mcp",
      "headers": {
        "Authorization": "Bearer ${ACURIS_MCP_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "acuris-mcp": {
      "httpUrl": "https://api.acuris-geo.com/mcp",
      "headers": {
        "Authorization": "Bearer ${ACURIS_MCP_TOKEN}"
      }
    }
  }
}
extensions:
  "acuris-mcp":
    enabled: true
    name: "acuris-mcp"
    type: streamable_http
    uri: "https://api.acuris-geo.com/mcp"
    headers:
      "Authorization": "Bearer ${ACURIS_MCP_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${ACURIS_MCP_TOKEN}. The registry never accepts secret values.

Quality 76 / 100good

protocol75 · weight 25
  • warn
    protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
  • n/a
    protocol.statelessonly applies to 2026-07-28 servers
  • pass
    protocol.transportstreamable HTTP
  • n/a
    protocol.list_ttlonly applies to 2026-07-28 servers
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene64 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • warn
    tools.description_length1 tools have descriptions over 1,024 characters, which crowds the context
  • pass
    tools.schemasevery tool has an object input schema
  • fail
    tools.annotationsno tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
  • fail
    tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: validate_address (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); reverse_geocode (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); validate_addresses_batch (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
  • pass
    tools.token_costabout 2,225 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability100 · weight 15
  • pass
    stability.changes2 tool changes in 30 days
  • pass
    stability.rug_pullno tool changed its meaning under the same name
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

9 tools, about 2,225 tokens to load them all · tool set f57a2155340c · tools last changed 2026-10-12 · checked 2026-10-20 23:27 UTC

Tool changes

  • autocomplete_addressadded

    Address autocomplete (type-ahead): ranked, standardized address suggestions for a partial input `q` (typed so far), with lat/lng whenever the reference row carries a coordinate. Use it to help a person pick an address, then pass the chosen one to validate_address. `country` is ISO-3 lowercase. `limit` 1-50 (default 10). `state` narrows USA/Canada. For UK (gbr) the query may be, or start with, a postcode: a full or partial postcode returns every delivery point there (labelled with building/organisation names). UK requests are served from the Royal Mail PAF service; suggestions do not carry UDPRN/UPRN, so validate the chosen address to get them. Cost: billed exactly like the /suggest endpoint it wraps; see https://www.acuris-geo.com/acuris-pricing/

  • request_trial_keychangeddescription, input schema
    before

    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/

    after · 53% of words in common

    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. BEFORE calling with accept_terms=true you MUST show the user both links and get their explicit confirmation that they agree: Terms of Service: https://api.acuris-geo.com/legal/terms UK PAF Evaluation Terms: https://api.acuris-geo.com/legal/uk-evaluation-terms Never set accept_terms=true on the user's behalf without that confirmation. Without it the tool mints nothing and returns these links. After receiving the key, reconfigure this MCP server connection with the header "Authorization: Bearer <key>" (or set ACURIS_API_KEY for stdio). UK (Royal Mail PAF) lookups are capped at 5 per UTC day and the free UK evaluation runs 90 days from acceptance. Paid plans: https://www.acuris-geo.com/acuris-pricing/

Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 93 / 100

provenance85
liveness100
freshness85
hygiene100

+repository +dns-namespace +website +reachable +uptime-100% ~updated-87d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://api.acuris-geo.com/mcp streamable-httpnoneyes100%975 ms2025-11-252026-10-20

Tools (9)

autocomplete_addressAddress autocomplete (type-ahead): ranked, standardized address suggestions for a partial input `q` (typed so far), with lat/lng whenever the reference row carries a coordinate. Use it to help a person pick an address, then pass the chosen one to validate_address. `country` is ISO-3 lowercase. `limit` 1-50 (default 10). `state` narrows USA/Canada. For UK (gbr) the query may be, or start with, a postcode: a full or partial postcode returns every delivery point there (labelled with building/organisation names). UK requests are served from the Royal Mail PAF service; suggestions do not carry UDPRN/UPRN, so validate the chosen address to get them. Cost: billed exactly like the /suggest endpoint it wraps; see https://www.acuris-geo.com/acuris-pricing/
check_balanceShow 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.
enrich_us_ca_addressAddress → 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.
expand_uk_postcodeExpand 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.
geocode_addressForward-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.
request_trial_keyGet 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. BEFORE calling with accept_terms=true you MUST show the user both links and get their explicit confirmation that they agree: Terms of Service: https://api.acuris-geo.com/legal/terms UK PAF Evaluation Terms: https://api.acuris-geo.com/legal/uk-evaluation-terms Never set accept_terms=true on the user's behalf without that confirmation. Without it the tool mints nothing and returns these links. After receiving the key, reconfigure this MCP server connection with the header "Authorization: Bearer <key>" (or set ACURIS_API_KEY for stdio). UK (Royal Mail PAF) lookups are capped at 5 per UTC day and the free UK evaluation runs 90 days from acceptance. Paid plans: https://www.acuris-geo.com/acuris-pricing/
reverse_geocodeCoordinates → 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.
validate_addressValidate 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).
validate_addresses_batchValidate 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.

Schemas: list_tools.

Similar MCP servers

Official server.json
{
  "name": "com.acuris-geo/acuris-mcp",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://api.acuris-geo.com/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "description": "Bearer <your Acuris API key> — get a free trial key via the request_trial_key tool or https://www.acuris-geo.com/acuris-pricing/"
        }
      ]
    }
  ],
  "version": "1.0.0",
  "repository": {
    "url": "https://github.com/Acuris-GmbH/acuris-mcp",
    "source": "github"
  },
  "websiteUrl": "https://api.acuris-geo.com/docs/mcp",
  "description": "Address validation & geocoding for AI agents: 240+ countries, UK PAF, free US/CA enrichment"
}