{
  "info": {
    "name": "Postal Data API — mcp.ai",
    "description": "REST API for the Postal Data API MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/postal_data_api",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "postal_data_api_get_api_information",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/api/information",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "api",
            "information"
          ]
        },
        "description": "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",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "postal_data_api_get_postal_code_metadata",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/postal/code/metadata",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "postal",
            "code",
            "metadata"
          ]
        },
        "description": "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",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"postal_code\": \"\",\n  \"country_code\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "postal_data_api_lookup_postal_code",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/lookup/postal/code",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "lookup",
            "postal",
            "code"
          ]
        },
        "description": "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",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"postal_code\": \"\",\n  \"country_code\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "postal_data_api_search_postal_codes_by_city",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/search/postal/codes/by/city",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "search",
            "postal",
            "codes",
            "by",
            "city"
          ]
        },
        "description": "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",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"city\": \"\",\n  \"state\": \"\",\n  \"state_code\": \"\",\n  \"country_code\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "postal_data_api_validate_postal_code",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/validate/postal/code",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "validate",
            "postal",
            "code"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"postal_code\": \"\",\n  \"country_code\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "postal_data_api_validate_postal_codes_bulk",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/validate/postal/codes/bulk",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "validate",
            "postal",
            "codes",
            "bulk"
          ]
        },
        "description": "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",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"records\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}