# PostGrid Verify — how to use (mcp.ai)

Connect your PostGrid Verify account and use 12 tools for developer tools straight from your AI agent. Connect with your own API key. PostGrid Verify is an API that allows you to autocomplete, verify, and standardize addresses in real-time, supporting both individual and batch address verification.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/postgrid_verify/autocomplete/address` — Tool to autocomplete a partially specified US or Canada address. Retrieves complete verified address including full postal code. Uses 1 lookup per request.
  - body: { index?: string, pcFilter?: string, cityFilter?: string, stateFilter?: string, countryFilter?: string, partialStreet: string }
- `POST https://api.mcp.ai/api/postgrid_verify/autocomplete/intl/address` — 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: { id: string }
- `POST https://api.mcp.ai/api/postgrid_verify/get/autocomplete/previews` — 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: { countryFilter?: string, partialStreet?: string, provInsteadOfPC?: boolean }
- `POST https://api.mcp.ai/api/postgrid_verify/get/intl/autocomplete/previews` — 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: { limit?: integer, language?: string, cityFilter?: string, streetFilter?: string, partialStreet?: string, countriesFilter?: string, disableIPBiasing?: boolean, postalOrZipFilter?: string }
- `POST https://api.mcp.ai/api/postgrid_verify/get/lookup/info` — 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.
- `POST https://api.mcp.ai/api/postgrid_verify/lookup/city/state/from/postal` — 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: { postalOrZip: string }
- `POST https://api.mcp.ai/api/postgrid_verify/parse/address` — 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: { address: string }
- `POST https://api.mcp.ai/api/postgrid_verify/suggest/addresses` — 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: { address: object, includeDetails?: string }
- `POST https://api.mcp.ai/api/postgrid_verify/verify/address` — 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: { city?: string, line1?: string, line2?: string, address?: string, country?: string, geocode?: boolean, postalOrZip?: string, includeDetails?: boolean, provinceOrState?: string }
- `POST https://api.mcp.ai/api/postgrid_verify/verify/batch/addresses` — 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: { geocode?: boolean, addresses: string|object[], properCase?: boolean, includeDetails?: boolean }
- `POST https://api.mcp.ai/api/postgrid_verify/verify/international/address` — 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: { address: string, geoData?: boolean, includeDetails?: boolean }
- `POST https://api.mcp.ai/api/postgrid_verify/verify/intl/addresses/batch` — 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: { geoData?: boolean, addresses: string|object[], includeDetails?: boolean }

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

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