# Addressfinder — how to use (mcp.ai)

Connect your Addressfinder account and use 17 tools for developer tools straight from your AI agent. Connect with your own API key. A reliably smart, reliably accurate data quality platform for address, email, and phone verification.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_addressfinder?ms=1787291280000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `addressfinder_au_address_autocomplete_api`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/addressfinder`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/addressfinder/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/addressfinder/au/address/autocomplete/api` — Tool to perform interactive search of Australian addresses from the AddressFinder database. Use when you need to search for and autocomplete Australian addresses based on partial input.
  - body: { q?: string, max?: integer, ascii?: string, domain?: string, format?: string, source?: string, post_box?: string, canonical?: string, highlight?: string, state_codes?: string }
- `POST https://api.mcp.ai/api/addressfinder/au/address/metadata` — Tool to retrieve full metadata for an Australian address selected from the Address Autocomplete API. Use when you need complete address details including GPS coordinates and census data.
  - body: { id?: string, gps?: string, dpid?: string, ascii?: string, census?: integer, domain?: string, format?: string, source?: string, gnaf_id?: string }
- `POST https://api.mcp.ai/api/addressfinder/au/address/verification` — Tool to verify Australian addresses against PAF/GNAF databases. Use when you need to validate or standardize an Australian address and retrieve associated metadata like coordinates, statistical identi
  - body: { q: string, gps?: string, paf?: string, gnaf?: string, ascii?: string, census?: integer, domain?: string, format?: string, extended?: string, post_box?: string, state_codes?: string }
- `POST https://api.mcp.ai/api/addressfinder/au/location/autocomplete/api` — Tool to perform interactive autocomplete search for Australian streets, suburbs, and states. Use when you need to find or suggest Australian locations based on partial input.
  - body: { q: string, max?: integer, domain?: string, format?: string, secret?: string, highlight?: integer, state_codes?: string, location_types?: string }
- `POST https://api.mcp.ai/api/addressfinder/au/location/metadata/api` — Tool to retrieve comprehensive metadata for an Australian location (street, suburb, or state) selected from the Location Autocomplete API. Use when you need detailed information about a specific Austr
  - body: { id: string, domain?: string, format?: string }
- `POST https://api.mcp.ai/api/addressfinder/email/verification/api` — Tool to verify email addresses including syntax validation, domain existence, and email account verification. Use when you need to validate an email address before sending messages or storing contact 
  - body: { email: string, domain?: string, format?: string, features?: string }
- `POST https://api.mcp.ai/api/addressfinder/int/address/autocomplete/api` — Tool to search for international addresses using autocomplete functionality. Use when users need to find and select addresses in supported countries (AU, BE, CA, CZ, DK, FR, DE, IE, NZ, NL, PT, SG, ES
  - body: { q: string, max?: integer, domain?: string, format?: string, secret?: string, country: string }
- `POST https://api.mcp.ai/api/addressfinder/int/address/metadata/api` — Tool to retrieve full metadata for an international address selected from the Address Autocomplete API. Use when you need complete address details including street metadata and optional GPS coordinate
  - body: { id: string, gps?: integer, domain?: string, format?: string, country: string }
- `POST https://api.mcp.ai/api/addressfinder/nz/address/autocomplete` — Tool to perform interactive search for New Zealand addresses. Use when you need to find closely matching NZ addresses based on partial address input. The tool searches the Addressfinder database and r
  - body: { q?: string, max?: integer, ascii?: string, rural?: string, domain?: string, format?: string, strict?: string, post_box?: string, delivered?: string, highlight?: string, region_code?: string }
- `POST https://api.mcp.ai/api/addressfinder/nz/address/metadata` — Tool to retrieve full metadata for a NZ address including coordinates, census data, and postal details. Use after selecting an address from the Address Autocomplete API to get complete address informa
  - body: { dpid?: string, pxid?: string, ascii?: string, census?: integer, domain?: string, format?: string }
- `POST https://api.mcp.ai/api/addressfinder/nz/address/reverse/geocode` — Tool to reverse geocode NZ addresses from GPS coordinates. Use when you need to find the nearest addresses to a given longitude and latitude. Returns addresses ordered by distance.
  - body: { x: string, y: string, max?: integer, domain?: string, format?: string }
- `POST https://api.mcp.ai/api/addressfinder/nz/address/verification/api` — Tool to verify New Zealand addresses against the Addressfinder database. Use when you need to validate and enrich NZ addresses, correct spelling mistakes, or retrieve detailed address metadata includi
  - body: { q?: string, ascii?: string, census?: integer, domain?: string, format?: string, secret?: string, post_box?: string, region_code?: string }
- `POST https://api.mcp.ai/api/addressfinder/nz/location/autocomplete` — Tool to perform interactive search for New Zealand streets, suburbs, cities, and regions. Use when you need to find or autocomplete location names in New Zealand. Returns closely matching locations wi
  - body: { q: string, max?: integer, city?: string, domain?: string, format?: string, region?: string, secret?: string, street?: string, strict?: string, suburb?: string, highlight?: integer, region_code?: string }
- `POST https://api.mcp.ai/api/addressfinder/nz/location/metadata` — Tool to retrieve full metadata for a New Zealand location selected from the Location Autocomplete API. Use when you need detailed information including coordinates and LINZ address data for a specific
  - body: { pxid: string, domain?: string, format?: string, secret?: string }
- `POST https://api.mcp.ai/api/addressfinder/nz/poi/autocomplete/api` — Tool to perform interactive search for points of interest in New Zealand. Use when you need to find POIs like hospitals, cafes, or schools based on partial name matching.
  - body: { q: string, max?: integer, domain?: string, format?: string, highlight?: integer }
- `POST https://api.mcp.ai/api/addressfinder/nzpoi/metadata/api` — Tool to retrieve comprehensive metadata for New Zealand points of interest including coordinates and address details. Use when you need full POI information after selecting from autocomplete API.
  - body: { id: string, domain?: string, format?: string, secret?: string }
- `POST https://api.mcp.ai/api/addressfinder/phone/verification/api` — Tool to verify phone numbers through syntax, range checks, and network verification. Use when you need to validate a phone number's format, line type, and connection status. Returns verified number de
  - body: { domain?: string, format?: string, timeout?: number, mobile_only?: boolean, phone_number: string, default_country_code: string, allowed_country_codes?: string }

## Example prompts
- "What can I do in Addressfinder?"
- "Show me a summary of my Addressfinder account"

## More
- Page: https://mcp.ai/addressfinder
- Agent spec (llms.txt): https://mcp.ai/addressfinder/llms.txt
- Postman collection: https://mcp.ai/addressfinder/postman.json