{
  "info": {
    "name": "PostGrid Verify — mcp.ai",
    "description": "REST API for the PostGrid Verify 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/postgrid_verify",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "postgrid_verify_autocomplete_address",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/autocomplete/address",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "autocomplete",
            "address"
          ]
        },
        "description": "Tool to autocomplete a partially specified US or Canada address. Retrieves complete verified address including full postal code. Uses 1 lookup per request.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"index\": \"\",\n  \"pcFilter\": \"\",\n  \"cityFilter\": \"\",\n  \"stateFilter\": \"\",\n  \"countryFilter\": \"\",\n  \"partialStreet\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "postgrid_verify_autocomplete_intl_address",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/autocomplete/intl/address",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "autocomplete",
            "intl",
            "address"
          ]
        },
        "description": "Tool to retrieve complete verified international address data using an ID from the preview endpoint. Use when you have an address ID from the preview step and need the full address details.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "postgrid_verify_get_autocomplete_previews",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/autocomplete/previews",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "autocomplete",
            "previews"
          ]
        },
        "description": "Tool to get previews of autocompleted US and Canadian addresses. Returns partial address data (line1, city, first 3 digits of postal code) without using any lookups. Use when you need quick autocomple",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"countryFilter\": \"\",\n  \"partialStreet\": \"\",\n  \"provInsteadOfPC\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "postgrid_verify_get_intl_autocomplete_previews",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/intl/autocomplete/previews",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "intl",
            "autocomplete",
            "previews"
          ]
        },
        "description": "Tool to get previews of autocompleted international addresses. Results are biased based on your current IP address unless disabled. Returns both 'Address' and 'BuildingNumber' types - if type is 'Addr",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"language\": \"\",\n  \"cityFilter\": \"\",\n  \"streetFilter\": \"\",\n  \"partialStreet\": \"\",\n  \"countriesFilter\": \"\",\n  \"disableIPBiasing\": false,\n  \"postalOrZipFilter\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "postgrid_verify_get_lookup_info",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/lookup/info",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "lookup",
            "info"
          ]
        },
        "description": "Tool to retrieve lookup usage information for your PostGrid account. Use when you need to check how many lookups you have used and your free lookup limit.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "postgrid_verify_lookup_city_state_from_postal",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/lookup/city/state/from/postal",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "lookup",
            "city",
            "state",
            "from",
            "postal"
          ]
        },
        "description": "Tool to lookup city and state for a given postal or ZIP code. Use when you need valid city/state combinations for a postal code.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"postalOrZip\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "postgrid_verify_parse_address",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/parse/address",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "parse",
            "address"
          ]
        },
        "description": "Tool to break an address apart into its components. Use when you need to extract individual address parts like street number, road, city, state, and postal code from a single-line address string.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"address\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "postgrid_verify_suggest_addresses",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/suggest/addresses",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "suggest",
            "addresses"
          ]
        },
        "description": "Tool to find addresses similar to the given address. If the address can be verified or corrected, the first element will contain the verified address. Returns unit number ranges in line1 of suggested ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"address\": {},\n  \"includeDetails\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "postgrid_verify_verify_address",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/verify/address",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "verify",
            "address"
          ]
        },
        "description": "Tool to verify and standardize a US or Canadian address. Supports both freeform addresses (single-line) and structured addresses (with separate line1, city, etc.). Use includeDetails=true for addition",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"city\": \"\",\n  \"line1\": \"\",\n  \"line2\": \"\",\n  \"address\": \"\",\n  \"country\": \"\",\n  \"geocode\": false,\n  \"postalOrZip\": \"\",\n  \"includeDetails\": false,\n  \"provinceOrState\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "postgrid_verify_verify_batch_addresses",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/verify/batch/addresses",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "verify",
            "batch",
            "addresses"
          ]
        },
        "description": "Tool to verify up to 2000 US and Canada addresses in a single API call. Accepts both freeform address strings and structured address objects. Each address uses 1 lookup credit.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"geocode\": false,\n  \"addresses\": \"\",\n  \"properCase\": false,\n  \"includeDetails\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "postgrid_verify_verify_international_address",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/verify/international/address",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "verify",
            "international",
            "address"
          ]
        },
        "description": "Tool to verify and standardize international addresses from 245+ countries. Supports both structured and freeform address inputs. Use includeDetails=true for match levels and geoData=true for coordina",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"address\": \"\",\n  \"geoData\": false,\n  \"includeDetails\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "postgrid_verify_verify_intl_addresses_batch",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/verify/intl/addresses/batch",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "verify",
            "intl",
            "addresses",
            "batch"
          ]
        },
        "description": "Tool to verify up to 2000 international addresses in a single API call. Accepts both freeform address strings and structured address objects. Uses 1 lookup per address.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"geoData\": false,\n  \"addresses\": \"\",\n  \"includeDetails\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}