# DocuPost — how to use (mcp.ai)

Connect your DocuPost account and use 3 tools for documents straight from your AI agent. Connect with your own API key. DocuPost is a print and mail service that enables users to send digital files as physical letters and postcards via the U.S. Postal Service.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/docupost/get/balance` — Return the connected DocuPost account's numeric balance. This read does not reveal currency, plan, tier, or sandbox status.
- `POST https://api.mcp.ai/api/docupost/send/letter` — Submit one letter for paid printing and U.S. postal delivery. This is a non-idempotent physical-mail operation: one call can deduct funds and create real mail, so confirm all content and addresses bef
  - body: { color?: boolean, sender: object, pdf_url: string, recipient: object, mail_class?: string, double_sided?: boolean, service_level?: string, internal_description?: string, include_return_envelope?: boolean }
- `POST https://api.mcp.ai/api/docupost/send/postcard` — Submit one postcard for paid printing and U.S. postal delivery. This is a non-idempotent physical-mail operation: one call can deduct funds and create real mail, so confirm both artworks and all addre
  - body: { size?: string, sender: object, recipient: object, back_image_url: string, front_image_url: string, internal_description?: string }

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

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