All updates

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_email and validate_phone, each mirroring an existing API endpoint
  • Verify first: An agent usually holds the whole address already. verify_address returns the one official address behind it, checked against USPS CASS in the US
  • Find when unsure: For a partial or doubtful address, find_address proposes several candidates the model narrows with filters and biases. retrieve_address returns 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 its mcp_2026_07_28 feature flag. Cursor and VS Code use an older protocol version and cannot connect yet
  • Agent skill: npx skills add addresszen/skills teaches 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.