Create a contact in PostGrid with a mailing address. Contacts can be used as recipients or senders for letters and checks.

Get a PostGrid contact by ID. Returns contact details including name and address.

List or search PostGrid contacts. Supports pagination with skip/limit.

Update an existing PostGrid contact. Only provided fields will be updated.

Delete a PostGrid contact. This action cannot be undone.

Verify a single US/CA address using PostGrid Address Verification. Returns verified, corrected (with before/after diff), or failed status.

Verify multiple addresses at once (up to 2,000). Addresses are chunked into batches of 500. Returns verification status for each address.

Autocomplete a partial street address. Returns matching address suggestions.

Look up city and state from a ZIP/postal code.

Send a physical letter via PostGrid. Supports standard First Class, Certified Mail, and Certified Mail with Return Receipt. Call without confirmed=true to preview the send details; call with confirmed=true to actually send.

Get a letter's details, status, and tracking information by ID.

List letters with optional search and pagination.

Cancel a letter. Only works when the letter status is 'ready' (before it enters printing).

Create a bank account for check printing. WARNING: Bank account details (account/routing numbers) will transit through chat history. For security, consider creating bank accounts via the PostGrid dashboard instead.

Get bank account details by ID. Account and routing numbers are masked for security.

List bank accounts. Account and routing numbers are masked.

Delete a bank account. This cannot be undone. Checks already created using this account are not affected.

Print and mail a MICR-encoded check via PostGrid. Amount is specified in dollars and converted to cents internally. Call without confirmed=true to preview; call with confirmed=true to send.

Get a check's details, status, and tracking information by ID.

List checks with optional search and pagination.

Cancel a check. Only works when the check status is 'ready' (before it enters printing).

Create an HTML template with Handlebars merge variables (e.g., {{name}}, {{address}}). Templates can be reused across multiple letters.

Get a template by ID, including its HTML content.

List templates with optional search and pagination.

Update an existing template's HTML content or description.

Delete a template. This cannot be undone.

Estimate the cost of sending a letter or check without making an API call. Uses PostGrid's published rate table.

Show PostGrid account status: API mode (test/live), connectivity, and the rate table.

Upload a PDF to temporary storage and get a URL that PostGrid can access. Use this before postgrid_create_letter when you have a PDF file to mail. Accepts either a local file path or base64-encoded PDF content. The URL expires after 5 minutes and the file is auto-deleted after 24 hours.

Get a presigned URL to upload a PDF directly to cloud storage. Returns a PUT URL (for uploading) and a GET URL (for use as uploadedPDF in postgrid_create_letter). Workflow: (1) call this tool, (2) upload the PDF to the PUT URL via curl, (3) pass the GET URL to postgrid_create_letter. Use this from Cowork or sandboxed environments where file system access is unavailable.