How to integrate Addressfinder MCP with Codex

Connect Codex to Addressfinder MCP. Verify if 221b baker st is a real address, enrich contact with validated phone number, and more using natural language, with authentication handled for you.

Addressfinder logoAddressfinder
Api Key

Addressfinder is a data quality platform for verifying addresses, emails, and phone numbers. It helps you ensure accurate customer and contact data every time.

17 Tools

Introduction

Codex is one of the most popular coding harnesses out there. And MCP makes the experience even better. With the Addressfinder MCP integration, Codex can autocomplete and verify AU and NZ addresses, search international addresses, verify emails and phone numbers, and reverse geocode NZ locations, all without leaving the terminal or the app, whichever you prefer.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Addressfinder with

Why use Composio?

Apart from a managed and hosted MCP server, you will get:

  • CodeAct: A dedicated workbench that allows GPT to write its code to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
  • Large tool responses: Handle them to minimise context rot.
  • Dynamic just-in-time access to 20,000 tools across 1700+ other Apps for cross-app workflows. It loads the tools you need, so GPTs aren't overwhelmed by tools you don't need.

How to install Addressfinder MCP in Codex

Run the setup command

Run this command in your terminal to add the Composio MCP server to Codex.

Terminal

It will initiate the authentication in a browser window, authorize Codex to access your Composio account.

Composio authentication page

(Optional) Authenticate with OAuth

To authenticate manually, run the login command to open a browser window and authorize Codex to access your Composio account.

bash
codex mcp login composio

Verify the connection

Run codex mcp list to confirm Composio appears as a registered MCP server.

bash
codex mcp list

Codex App

Codex App follows the same approach as VS Code.

  1. Click ⚙️ on the bottom left → MCP Servers → + Add servers → Streamable HTTP:
  2. Fill the header and Key fields with { "x-consumer-api-key" = "ck_*******" }.
  3. The Key is the Composio API key, that you can find on dashboard.composio.dev
  4. Click on Authenticate and authorize Codex to your Composio account and you're all set.
Codex App MCP setup
  1. Restart and verify if it's there in .codex/config.toml
bash
[mcp_servers.composio]
url = "https://connect.composio.dev/mcp"
http_headers = { "x-consumer-api-key" = "ck_*******" }

Try it

Ask Codex for a Addressfinder task. The first time, Composio asks you to connect your Addressfinder account.

For example, ask it to:

  • "Verify if 221B Baker St is a real address"
  • "Enrich contact with validated phone number"
  • "Check if john@example.com is deliverable"

What is the Addressfinder MCP server, and what's possible with it?

The Addressfinder MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Addressfinder account. It provides structured and secure access to address, location, email, and phone data quality tools, so your agent can search for addresses, verify contact details, retrieve location metadata, and find points of interest on your behalf.

  • Australian address search and verification: Have your agent autocomplete Australian addresses, verify them against trusted address databases, and retrieve full address metadata.
  • New Zealand address and location lookup: Let the agent find and verify New Zealand addresses, search streets, suburbs, cities, and regions, and retrieve postal, census, and coordinate details.
  • International address autocomplete: Direct your agent to suggest matching international addresses as users enter their address details.
  • Email and phone verification: Instruct your agent to check email syntax, domains, and accounts, or validate phone numbers through syntax, range, and network checks.
  • Location and point of interest discovery: Have your agent search Australian locations or find points of interest across New Zealand using autocomplete.

Conclusion

You've successfully integrated Addressfinder with Codex using Composio's MCP server. Now you can interact with Addressfinder directly from your terminal, VS Code, or the Codex App using natural language commands.

Key benefits of this setup:

  • Seamless integration across CLI, VS Code, and standalone app
  • Natural language commands for Addressfinder operations
  • Managed authentication through Composio
  • Access to 20,000+ tools across 1700+ apps for cross-app workflows
  • CodeAct workbench for complex tool chaining

Next steps:

  • Try asking Codex to perform various Addressfinder operations
  • Explore cross-app workflows by connecting more toolkits
  • Build automation scripts that leverage Codex's AI capabilities
TOOLS

Supported Tools

Every Addressfinder action and event your agent gets out of the box.

AU Address Autocomplete

Tool to perform interactive search of Australian addresses from the AddressFinder database.

Get AU Address Metadata

Tool to retrieve full metadata for an Australian address selected from the Address Autocomplete API.

AU Address Verification

Tool to verify Australian addresses against PAF/GNAF databases.

AU Location Autocomplete

Tool to perform interactive autocomplete search for Australian streets, suburbs, and states.

Get AU Location Metadata

Tool to retrieve comprehensive metadata for an Australian location (street, suburb, or state) selected from the Location Autocomplete API.

Email Verification API

Tool to verify email addresses including syntax validation, domain existence, and email account verification.

International Address Autocomplete

Tool to search for international addresses using autocomplete functionality.

Get International Address Metadata

Tool to retrieve full metadata for an international address selected from the Address Autocomplete API.

NZ Address Autocomplete

Tool to perform interactive search for New Zealand addresses.

Get NZ Address Metadata

Tool to retrieve full metadata for a NZ address including coordinates, census data, and postal details.

NZ Address Reverse Geocode

Tool to reverse geocode NZ addresses from GPS coordinates.

NZ Address Verification

Tool to verify New Zealand addresses against the Addressfinder database.

NZ Location Autocomplete

Tool to perform interactive search for New Zealand streets, suburbs, cities, and regions.

Get NZ Location Metadata

Tool to retrieve full metadata for a New Zealand location selected from the Location Autocomplete API.

NZ POI Autocomplete

Tool to perform interactive search for points of interest in New Zealand.

Get NZ POI Metadata

Tool to retrieve comprehensive metadata for New Zealand points of interest including coordinates and address details.

Phone Verification API

Tool to verify phone numbers through syntax, range checks, and network verification.

FAQ

Frequently asked questions

Start with Addressfinder.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Addressfinder tool your agent needs.Free to start.

Start building