# DocuPost — MCP server on 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.

By: mcp.ai · official
Page: https://mcp.ai/docupost

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_docupost?ms=1787293620000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/docupost/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/docupost/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/docupost/skill.md
Postman collection (v2.1): https://mcp.ai/docupost/postman.json

## Tools
- docupost_get_balance() — Return the connected DocuPost account's numeric balance. This read does not reveal currency, plan, tier, or sandbox status.
- docupost_send_letter(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) — 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
- docupost_send_postcard(size?: string, sender: object, recipient: object, back_image_url: string, front_image_url: string, internal_description?: string) — 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

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

## Links
Docs: https://mcp.ai/docs/mcps/docupost
Website: https://mcp.ai/mcps/docupost