PostalDataPI MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| POSTALDATAPI_KEY | Yes | Your API key for PostalDataPI, obtained by signing up at postaldatapi.com/register |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| lookup_postal_codeA | Look up a postal code and get city, state, and region information. Works for ZIP codes (US), postcodes (UK), PLZ (Germany), and postal codes in 70+ countries. Use this when someone asks about a postal code, wants to know what city a ZIP code belongs to, or needs address information. Args: postal_code: The postal code to look up (e.g., "90210", "SW1A", "10115", "100-0001") country: ISO 3166-1 alpha-2 country code (e.g., "US", "GB", "DE", "JP"). Defaults to "US". Returns: City, state/region, and abbreviation for the postal code. |
| validate_postal_codeA | Check whether a postal code exists in a given country. Use this when someone wants to verify if a postal code is valid before processing an order, form, or address. Args: postal_code: The postal code to validate country: ISO 3166-1 alpha-2 country code. Defaults to "US". Returns: Whether the postal code is valid or invalid. |
| search_by_cityA | Find all postal codes for a given city. Use this when someone has a city name and needs the postal codes that serve it. For US cities, provide the state name or 2-letter abbreviation. Args: city: City name (e.g., "Beverly Hills", "Berlin", "Tokyo") state: State or region name/abbreviation. Required for US cities (e.g., "CA" or "California"). country: ISO 3166-1 alpha-2 country code. Defaults to "US". Returns: List of postal codes for the city. |
| get_postal_code_metadataA | Get full metadata for a postal code including coordinates. Returns latitude, longitude, county/municipality, and all available country-specific fields. Use this when someone needs geographic coordinates, timezone, or detailed location data for a postal code. Args: postal_code: The postal code to look up country: ISO 3166-1 alpha-2 country code. Defaults to "US". Returns: Full metadata including coordinates, region, and country-specific fields. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 4 tools
The tools have distinct primary purposes: get_postal_code_metadata for detailed geographic data, lookup_postal_code for basic address information, search_by_city for reverse lookup, and validate_postal_code for validation. However, get_postal_code_metadata and lookup_postal_code could be confused as both retrieve postal code information, though their descriptions clarify different use cases.
All tool names follow a consistent snake_case pattern with clear verb_noun structure: get_postal_code_metadata, lookup_postal_code, search_by_city, validate_postal_code. The naming is predictable and readable throughout the set.
With 4 tools, this is well-scoped for a postal code data server. Each tool serves a distinct function in the domain, and the count is appropriate for covering core operations without being overwhelming or insufficient.
The toolset covers key postal code operations: lookup, validation, reverse search, and metadata retrieval. A minor gap exists in lacking explicit update or delete operations, but these are not typically needed for a read-only data service, and agents can work effectively with the provided tools.