# Postal Data API — MCP server on mcp.ai
> Connect your Postal Data API account and use 6 tools for developer tools straight from your AI agent. Connect with your own API key. Postal Data API validates and looks up postal codes, locations, coordinates, and regional metadata across more than 240 countries and territories.

By: mcp.ai · official
Page: https://mcp.ai/postal_data_api

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_postal_data_api?ms=1787291280000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/postal_data_api/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/postal_data_api/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/postal_data_api/skill.md
Postman collection (v2.1): https://mcp.ai/postal_data_api/postman.json

## Tools
- postal_data_api_get_api_information() — Return Postal Data API version, coverage, usage guidance, current balance, and configured rate-limit status when returned, for connectivity or service discovery. The provider does not document this en
- postal_data_api_get_postal_code_metadata(postal_code: string, country_code?: string) — Return all available country-specific metadata for a postal code, such as coordinates, timezone, county, elevation, and administrative levels. The metadata fields vary by country and availability. Eac
- postal_data_api_lookup_postal_code(postal_code: string, country_code?: string) — Look up the city, region, and coordinates for a postal code. Use this for a concise location result; use Get Postal Code Metadata for country-specific administrative details. Each successful call cons
- postal_data_api_search_postal_codes_by_city(city: string, state?: string, state_code?: string, country_code?: string) — Return all postal codes matching a city and optional region, including fuzzy-match details. For US searches, provide a state name or state code. Each successful call consumes one Postal Data API query
- postal_data_api_validate_postal_code(postal_code: string, country_code?: string) — Check whether one postal code exists without treating a nonexistent code as an execution error. Inspect valid in the response. Each successful call consumes one Postal Data API query.
- postal_data_api_validate_postal_codes_bulk(records: object[]) — Validate 1 to 1,000 postal codes synchronously, including mixed-country batches. Results preserve input order and report per-record failures. A batch of N records consumes N queries and is rejected at

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

## Links
Docs: https://mcp.ai/docs/mcps/postal_data_api
Website: https://mcp.ai/mcps/postal_data_api