PostAgent — Claude Code MCP server: what it does, how to install
Prints and mails documents to US addresses from an AI coding agent. It returns a quote before payment and asks for confirmation before sending.
claude mcp add --transport http postagent https://api.postagent.sh/mcpWhat PostAgent does
PostAgent handles PDF, HTML, Markdown, plain text, DOCX, and image files, then sends them to a US postal address. The agent uploads the document, validates the sender and recipient details, and requests a quote. After you confirm, an x402-capable wallet pays in USDC on Base, and PostAgent prints and mails the item. Job status and USPS tracking can be checked afterward.
The service can be used through its REST API over plain HTTP, or through the MCP endpoint at https://api.postagent.sh/mcp. You need a US sender address, a US recipient address, and a wallet with USDC on Base mainnet. A mailing charge uses real funds and cannot be reversed after payment is confirmed, so the quote appears before the transaction.
What it helps with
- mail a PDF to a US postal address
- send a DOCX or image as physical mail
- review the delivery price before paying
- check a mailing job and its USPS tracking
Example prompts for the agent
- Mail
letter.pdfto this US address, show me the quote, and wait for my approval before paying. - Use
notice.htmlas the document, prepare the mailing quote, and send it only after I confirm. - Check the latest mailing job and return its USPS tracking details.
How to install PostAgent
Platform CLI: remote server
claude mcp add --transport http postagent https://api.postagent.sh/mcpPlatform CLI: remote server
codex mcp add postagent-print-and-mail --url https://api.postagent.sh/mcpConfig file
{
"mcpServers": {
"postagent-print-and-mail": {
"url": "https://api.postagent.sh/mcp"
}
}
}Config file
{
"servers": {
"postagent-print-and-mail": {
"type": "http",
"url": "https://api.postagent.sh/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http postagent-print-and-mail https://api.postagent.sh/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about PostAgent
How do I install PostAgent in Claude Code?
Run these commands in order: claude mcp add --transport http postagent https://api.postagent.sh/mcp, then claude mcp add --transport http postagent-print-and-mail https://api.postagent.sh/mcp. Restart Claude Code afterward so it loads the new MCP server.
What does PostAgent do?
It accepts PDF, HTML, Markdown, text, DOCX, and image files, obtains a mailing quote, and prints and mails the document to a US address after you approve payment. It can also report the job state and USPS tracking.
What do I need before sending mail with PostAgent?
Provide US sender and recipient addresses plus an x402-compatible wallet funded with USDC on Base mainnet. Each mailing is paid separately.
