MCP Server
The AddressZen API is now an MCP server at https://api.addresszen.com/mcp. Connect an AI agent to it and the model can verify and find addresses and validate emails and phone numbers itself, with no integration code.
Details
- Five tools:
verify_address,find_address,retrieve_address,validate_emailandvalidate_phone, each mirroring an existing API endpoint - Verify first: An agent usually holds the whole address already.
verify_addressreturns the one official address behind it, checked against USPS CASS in the US - Find when unsure: For a partial or doubtful address,
find_addressproposes several candidates the model narrows with filters and biases.retrieve_addressreturns the full address for the one chosen - Same billing as the API: Each tool costs what its endpoint costs. Finds are free and a retrieve is one lookup
- Your API key: Send it as
Authorization: Bearer <key>. Use a backend key with no Allowed URLs; keys restricted to URLs are refused - Errors the model can read: A refusal such as no balance or a limit reached comes back as a tool result with the API's error code, so the agent can tell the user what to do
- Protocol
2026-07-28: Claude Code connects out of the box and Codex CLI behind itsmcp_2026_07_28feature flag. Cursor and VS Code use an older protocol version and cannot connect yet - Agent skill:
npx skills add addresszen/skillsteaches coding agents the endpoint, the tools and when to use MCP rather than the HTTP API
Setup for each client is in the MCP server guide.