Integration

Addressfinder integration

Addressfinder verifies and autocompletes addresses in Australia and New Zealand (Australia Post PAF and GNAF, NZ Post and LINZ data) and in 14 other countries, and verifies email addresses and phone numbers. An agent can autocomplete a partial address, location or New Zealand point of interest, load the full metadata of the chosen result (postcode, GPS, census areas, delivery point ids), verify a free-text address, reverse geocode NZ coordinates, and check whether an email or phone number is valid and reachable. Verifications draw on the account's plan. Authentication is the project's API key (sent as the key query parameter) and its API secret (sent raw in the Authorization header), both shown under Keys in the Addressfinder Portal; the OAuth 2.0 client credentials option of Business plans is not used.

Connect Addressfinder How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Addressfinder.Built from the 17 Addressfinder tools below, on the connection you add once.

What you can do with Addressfinder

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Nz address, 4 operations

autocomplete_nz_addressAutocomplete nz addressGETSearch New Zealand addresses matching a partial address (q). Returns completions[] with the address (a) and pxid; pass that pxid to get_nz_address_metadata.
get_nz_address_metadataGet nz address metadataGETGet the full record of a New Zealand address by pxid (from autocomplete_nz_address or reverse_geocode_nz_address) or NZ Post dpid: components, postal lines, coordinates, census and council areas.
reverse_geocode_nz_addressReverse geocode nz addressGETFind the New Zealand addresses nearest to a GPS point (x longitude, y latitude, WGS84), ordered by distance. Returns completions[] with a and pxid for get_nz_address_metadata.
verify_nz_addressVerify nz addressGETVerify a free-text New Zealand address (q), tolerating typos. matched tells whether a valid address was found; the other fields are its standardised components and areas.

Au address, 3 operations

autocomplete_au_addressAutocomplete au addressGETSearch Australian addresses matching a partial address (q). Returns completions[] with full_address and id; pass that id to get_au_address_metadata for the full record.
get_au_address_metadataGet au address metadataGETGet the full record of an Australian address: components, postcode, DPID, GNAF id, census areas and, with gps=1, coordinates. Pass the id from autocomplete_au_address, or a gnaf_id or dpid.
verify_au_addressVerify au addressGETVerify a free-text Australian address (q), tolerating typos, against GNAF and/or PAF. matched tells whether a valid address was found; address holds its standardised components.

Au location, 2 operations

autocomplete_au_locationAutocomplete au locationGETSearch Australian streets, suburbs (localities) and states matching q. Returns completions[] with full_location and id; pass that id to get_au_location_metadata.
get_au_location_metadataGet au location metadataGETGet the details of an Australian location (street, suburb or state) by the id from autocomplete_au_location: postcode, state, coordinates and street parts.

International address, 2 operations

autocomplete_international_addressAutocomplete international addressGETSearch addresses in one supported country (au, be, ca, cz, dk, fr, de, ie, nz, nl, pt, sg, es, se, gb, us) matching q. Returns completions[] with full_address and id for get_international_address_metadata.
get_international_address_metadataGet international address metadataGETGet the full record of an address chosen with autocomplete_international_address: pass the same country and the completion id.

Nz location, 2 operations

autocomplete_nz_locationAutocomplete nz locationGETSearch New Zealand streets, suburbs, cities and regions matching q. Returns completions[] with a and pxid; pass that pxid to get_nz_location_metadata.
get_nz_location_metadataGet nz location metadataGETGet the details of a New Zealand location by the pxid from autocomplete_nz_location: name, coordinates (x longitude, y latitude), street, suburb, city and region.

Nz poi, 2 operations

autocomplete_nz_poiAutocomplete nz poiGETSearch New Zealand points of interest by name or address (q). Returns completions[] with name_and_address and id; pass that id to get_nz_poi_metadata.
get_nz_poi_metadataGet nz poi metadataGETGet the details of a New Zealand point of interest by the id from autocomplete_nz_poi: name, coordinates, postal address lines and region.

Email, 1 operation

verify_emailVerify emailGETVerify an email address: syntax, domain and, by default, whether the mailbox exists. Read is_verified, deliverability and not_verified_reason; also flags disposable, role and catch-all addresses.

Phone, 1 operation

verify_phoneVerify phoneGETVerify a phone number: format, range and live connection status. Read is_verified, line_type, line_status and the formatted national and international numbers.

Use Addressfinder from Claude Code, Cursor or Codex

Connect Addressfinder in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Addressfinder operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Addressfinder

Create your workspace
Sign up free. Nothing to install.
Connect Addressfinder once
Add your Addressfinder connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.