Address validation & geocoding for AI agents: 240+ countries, UK PAF, free US/CA enrichment
| Endpoint | https://api.acuris-geo.com/mcp (streamable-http) |
|---|---|
| Registry version | 1.0.0 |
| Now | 9 tools · grade C (78) · pin ts_3e81cc921d46ee327373b5af281daa3c · protocol 2025-06-18 |
| First / last listed | 2026-10-24 19:00 UTC / 2026-10-24 19:00 UTC |
| Grade over time | 2026-10-24: C (78), 9 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: validate_address validate_addresses_batch enrich_us_ca_address geocode_address reverse_geocode expand_uk_postcode autocomplete_address check_balance request_trial_key
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 params: country*, address_line, street, house_number, city, state, postcode |
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 e params: addresses*, country |
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; Stat params: country*, address_line, street, house_number, city, state, postcode |
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 valu params: country*, street, house_number, city, state, postcode, q |
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. params: lat*, lng*, country, radius_m, limit |
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. params: postcode* |
autocomplete_address | 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 params: country*, q*, limit, state |
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. params: none |
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.
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 Evaluatio params: email*, accept_terms |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.