Connect Addressfinder to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.
Ask your agent in plain language. Each of these maps to a real tool on the server.
Use the verify address tool in Addressfinder
Use the address metadata tool in Addressfinder
Use the location metadata tool in Addressfinder
Use the location search tool in Addressfinder
Use the verify phone tool in Addressfinder
Use the reverse geocode tool in Addressfinder
Supported Tools
verify_address
Verify Address
Verify a full address against the Addressfinder database. Accepts an address that may contain errors or typos and returns the matched, standardized address along with metadata. Available for Australian and New Zealand addresses.
address_metadata
Address Metadata
Retrieve full metadata for an address selected from autocomplete results. Returns structured address components, geocoordinates, census data, and postal identifiers. Works with AU, NZ, and international addresses.
location_metadata
Location Metadata
Retrieve full metadata for a location selected from location search results. Returns detailed location information including geocoordinates, street details, suburb, city, region, and state.
location_search
Location Search
Search for locations such as streets, suburbs, cities, and states in Australia and New Zealand. Returns matching locations with identifiers that can be used to retrieve full location metadata including geocoordinates.
verify_phone
Verify Phone
Verify a phone number through syntax validation, range checks, and network-level connection status. Returns the verified number in national and international formats, line type (mobile/landline), and connection status.
reverse_geocode
Reverse Geocode
Convert GPS coordinates (longitude/latitude) to the nearest addresses. Returns nearby addresses ordered by distance from the provided coordinates. **Available for New Zealand only.**
address_autocomplete
Address Autocomplete
Search for addresses using type-ahead autocomplete. Supports Australian (AU), New Zealand (NZ), and international addresses. Returns a list of closely matching addresses as the user types. Use the returned address identifier with the **Address Metadata** tool to get full details.
verify_email
Verify Email
Verify an email address by checking syntax, domain existence and availability, and email account existence. Returns verification status along with metadata about the email address such as whether it is disposable, a role-based address, or uses a public email provider.
Enable Addressfinder in Metorial. In your Metorial portal, enable the Addressfinder MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
Sign in. Select Add and sign in to load Addressfinder tools.
Enable Addressfinder in Metorial. In your Metorial portal, enable the Addressfinder MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom MCP server. On ChatGPT web, open Plugins, select +, then Add custom MCP server.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>), choose OAuth and accept the risk notice.
Create and install the plugin. Select Create as a plugin, install it and sign in to load Addressfinder tools.
Enable Addressfinder in Metorial. In your Metorial portal, enable the Addressfinder MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add Metorial to your MCP config. Use ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
Sign in. Open Customize in the sidebar, find Metorial and sign in to load Addressfinder tools.
{
"mcpServers":{
"metorial":{
"url":"<your-magic-mcp-url>"
}
}
}
Enable Addressfinder in Metorial. In your Metorial portal, enable the Addressfinder MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server over HTTP. Add --scope user to use it in every project.
Sign in. Run /mcp, select Metorial and sign in to load Addressfinder tools.
claude mcp add --transport http metorial <your-magic-mcp-url>
Enable Addressfinder in Metorial. In your Metorial portal, enable the Addressfinder MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server and sign in. The Codex CLI, IDE extension and ChatGPT desktop app share this config.
Check the connection. Type /mcp in Codex to see Metorial and its Addressfinder tools.
codex mcp add metorial --url <your-magic-mcp-url>
codex mcp login metorial
Run Addressfinder through the Metorial gateway
One governed layer for every app your agents reach, not a separate connector per tool.
Give Addressfinder and every other app to your whole team through one MCP gateway, behind your SSO.
Scope which teams and agents can use Addressfinder tools with role-based access control, and trace every call.
Prefer to run it yourself? Metorial is open source and self-hostable.
Verify and autocomplete addresses for Australia, New Zealand, and international locations. Search addresses with type-ahead autocomplete, retrieve full address metadata and structured components, verify addresses against standardized records, perform reverse geocoding from GPS coordinates, and search points of interest. Also verify email addresses and phone numbers for validity and connection status. Supports bulk address verification for cleaning existing datasets.
Frequently asked questions
Common questions about connecting Addressfinder to AI agents with Metorial.
How many tools does the Addressfinder MCP server have?
The Addressfinder MCP server exposes 8 tools, including Verify Address, Address Metadata, Location Metadata. Each one is governed and traced through Metorial.
Does the Addressfinder MCP server support triggers?
Addressfinder exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
Which AI clients can use the Addressfinder MCP server?
Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Addressfinder MCP server through the same Metorial URL.
How do I give only some teams access to Addressfinder?
Use role-based access control to decide which teams, users, and agents can use Addressfinder and which of its tools they can call.
Can I self-host the Addressfinder MCP server?
Yes. Metorial is open source, so you can run the Addressfinder MCP server yourself or use the hosted gateway.
Connect Addressfinder to production AI agents
See how Metorial gives your team governed access to Addressfinder, with tracing and security controls built in.