# Addresszen — how to use (mcp.ai)

Connect your Addresszen account and use 2 tools for developer tools straight from your AI agent. Connect with your own API key. AddressZen provides address autocomplete and verification services, offering real-time address suggestions and validation to ensure accurate and deliverable addresses.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_addresszen?ms=1787293500000`
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. `addresszen_key_availability`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/addresszen`
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/addresszen/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/addresszen/key/availability` — Tool to get public information on an API key, including whether it is currently usable. Use when you need to verify that a key is valid and available before making further API requests.
  - body: { key: string }
- `POST https://api.mcp.ai/api/addresszen/resolve/address/usa` — Tool to resolve an address autocompletion by its address ID and return the full address in US format. Use after obtaining an address suggestion ID from the autocomplete endpoint.
  - body: { address: string }

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

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