Addressfinder MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.0.0Updated Nov 8, 2026

Autocomplete and verify NZ and AU addresses, and search NZ and AU locations in Addressfinder.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableLocation & LifestyleBusiness & Commerce

Overview

AI-generated overview

Hosted Addressfinder server that lets an assistant autocomplete, verify and geocode New Zealand and Australian addresses and search locations.

What you can do
  • Search and verify NZ addresses: autocomplete from a partial address, load full metadata by pxid, verify a full address with typos, and reverse geocode from GPS coordinates
  • Search and verify AU addresses: autocomplete, metadata by id, and verification against Australia Post PAF and Geoscape GNAF data
  • Search NZ and AU locations (streets, suburbs, cities, regions, states) and load their canonical names and coordinates
  • Check monthly usage, request a missing feature, and upgrade or cancel the subscription plan
When to use it
Useful when you need reliable NZ or AU address entry, validation or geocoding inside an assistant session, for example checking whether an address is valid and getting its postcode, or finding addresses near a coordinate pair.
Requirements
Remote MCP endpoint reached over streamable HTTP; no local install. Sign-in uses OAuth, and the login page asks for your Addressfinder API key and API secret, which the server stores per user. The Addressfinder plan must include direct API access. Free tier allows 50 tool calls per month.
Before you install
You hand over your Addressfinder API key and API secret to a third-party host, which stores them per user. Calls are metered: each verified result counts as a billed Lookup, and the free tier is capped at 50 calls per month. Upgrade tools return Stripe Checkout links and can start paid subscriptions, and plan changes charge the price difference immediately with no refund for the current period.

Installation

In SourceWeft

  1. Open Addressfinder MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Faddressfinder/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "addressfinder-by-usefulapi": {
      "type": "http",
      "url": "https://addressfinder.usefulapi.io/mcp"
    }
  }
}

README

Addressfinder MCP by usefulapi

Use your Addressfinder account from Claude, Cursor, or any MCP client. Look up, verify and geocode New Zealand and Australian addresses, and search their streets and suburbs. Hosted, no local install: connect with your own credentials.

Live endpoint: https://addressfinder.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://addressfinder.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http addressfinder https://addressfinder.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "addressfinder": {      "url": "https://addressfinder.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Addressfinder credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/addressfinder/

On first connect you provide your Addressfinder API key and API secret (Addressfinder Portal, under credentials; the plan must include direct API access). The server validates them and stores them per user. No keys go in config files.

Tools

ToolTypeWhat it does
addressfinder_nz_address_autocompletereadNZ address autocomplete
addressfinder_nz_address_metadatareadNZ address metadata
addressfinder_nz_address_verifyreadVerify NZ address
addressfinder_nz_reverse_geocodereadNZ reverse geocode
addressfinder_nz_location_autocompletereadNZ location autocomplete
addressfinder_nz_location_metadatareadNZ location metadata
addressfinder_au_address_autocompletereadAU address autocomplete
addressfinder_au_address_metadatareadAU address metadata
addressfinder_au_address_verifyreadVerify AU address
addressfinder_au_location_autocompletereadAU location autocomplete
addressfinder_au_location_metadatareadAU location metadata
addressfinder_usage_statusmetaUsage status (free-tier meter)
addressfinder_request_featuremetaRequest a missing feature
addressfinder_upgrademetaUpgrade to Pro or Pro+
addressfinder_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)10,000 tool calls / month
Pro+ (per user)$39/mo or $390/yr (2 months free)100,000 tool calls / month

Each paid plan covers this server only. Ask your AI to run addressfinder_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with addressfinder_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with addressfinder_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/addressfinder/README.md at commit 0be0869

Tools

11

addressfinder_nz_address_autocomplete

NZ address autocomplete

Search NZ addresses from a partial address. Returns candidates with `a` (the address) and `pxid`. Pair each call with addressfinder_nz_address_metadata: call it with the chosen pxid to load the full address.

Parametersqrequiredmaxpost_box

addressfinder_nz_address_metadata

NZ address metadata

Load the full metadata for one NZ address, given the pxid from addressfinder_nz_address_autocomplete or addressfinder_nz_reverse_geocode. Returns the parsed address parts, postcode, dpid and coordinates.

Parameterspxidrequired

addressfinder_nz_address_verify

Verify NZ address

Verify one full NZ address, which may contain typos, against the Addressfinder database. Returns the matched address and its metadata when a match exists. Each verified result is one billed Lookup.

Parametersqrequiredpost_box

addressfinder_nz_reverse_geocode

NZ reverse geocode

Find the nearest NZ addresses to a GPS point, ordered by distance. Returns `a` and `pxid` for each. Pair with addressfinder_nz_address_metadata for the chosen pxid.

Parametersxrequiredyrequiredmax

addressfinder_nz_location_autocomplete

NZ location autocomplete

Search NZ streets, suburbs, cities and regions (locations). Returns candidates with `a` and `pxid`. Pair each call with addressfinder_nz_location_metadata for the chosen pxid. To return several location types, set the others to 0.

Parametersqrequiredmaxcityregionstreetsuburb

addressfinder_nz_location_metadata

NZ location metadata

Load the metadata for one NZ location (street, suburb, city or region), given the pxid from addressfinder_nz_location_autocomplete. Returns the canonical name and coordinates.

Parameterspxidrequired

addressfinder_au_address_autocomplete

AU address autocomplete

Search AU addresses from a partial address. Returns candidates with `full_address` and `id`. Pair each call with addressfinder_au_address_metadata: call it with the chosen id to load the full address.

Parametersqrequiredmaxpost_boxstate_codes

addressfinder_au_address_metadata

AU address metadata

Load the full metadata for one AU address, given the id from addressfinder_au_address_autocomplete. Returns the parsed address parts, postcode, coordinates and GNAF identifiers.

Parametersidrequired

addressfinder_au_address_verify

Verify AU address

Verify one full AU address, which may contain typos, against Australia Post PAF and Geoscape GNAF data. Returns whether it matched and the matched address. Each verified result is one billed Lookup.

Parametersqrequired

addressfinder_au_location_autocomplete

AU location autocomplete

Search AU streets, localities (suburbs) and states (locations). Returns candidates with `full_location` and `id`. Pair each call with addressfinder_au_location_metadata for the chosen id.

Parametersqrequiredmaxstate_codeslocation_types

addressfinder_au_location_metadata

AU location metadata

Load the metadata for one AU location (street, locality or state), given the id from addressfinder_au_location_autocomplete. Returns the full location, type, coordinates and state.

Parametersidrequired

Version history

1
  1. v1.0.0LatestNov 8, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations