# postalform

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add ggaabe/postalform

# Browse available tools
npx -y @smithery/cli@latest tool list ggaabe/postalform

# Get full schema for a tool
npx -y @smithery/cli@latest tool get ggaabe/postalform postalform.list_forms

# Call a tool
npx -y @smithery/cli@latest tool call ggaabe/postalform postalform.list_forms '{}'
```

## Direct MCP Connection

Endpoint: `https://postalform--ggaabe.run.tools`

## Tools (10)

- `postalform.list_forms` — Use this when you need the published PostalForm form catalog that is available to agents (llms=true).
- `postalform.get_form_schema` — Use this when you need a machine-usable schema for one published PostalForm workflow (fields, groups, attachments, and …
- `postalform.search_addresses` — Use this to search for a US mailing address and return Loqate suggestions with IDs. If a suggestion has type "Container…
- `postalform.create_pdf_upload` — Use this when the host cannot provide a PDF file param directly. It creates a short-lived PDF upload URL and upload tok…
- `postalform.create_order_draft` — Use this when you need to mail an existing PDF. It creates a PostalForm order draft (Loqate Address IDs preferred, manu…
- `postalform.create_letter_order_draft` — Use this when you have letter text instead of a PDF. The server renders the letter into a PDF, creates an order draft, …
- `postalform.create_form_order_draft` — Use this when you have structured form data for a supported workflow. It fills the workflow PDF, creates an order draft…
- `complete_checkout` — Use this when ChatGPT Instant Checkout returns a payment token and you need to finalize payment for a prepared checkout…
- `postalform.get_order_status` — Use this when you need the latest status for a PostalForm mailing order.
- `postalform.ping` — Use this when you want a quick health check that the PostalForm MCP server is reachable.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get ggaabe/postalform <tool-name>
```

## Resources

- `ui://widget/postalform.html`