# PostAgent

Prints and mails documents to US addresses from an AI coding agent. It returns a quote before payment and asks for confirmation before sending.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: interpretai-tech
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/interpretai-tech/agent-tools/tree/HEAD/postagent-print-and-mail
- Updated: 2026-06-25
- HTML: https://affpapa.org/en/nevibecode/mcp/postagent

## What it 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.

## Requirements
- Remote server: `https://api.postagent.sh/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http postagent https://api.postagent.sh/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add postagent-print-and-mail --url https://api.postagent.sh/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "postagent-print-and-mail": {
            "url": "https://api.postagent.sh/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "postagent-print-and-mail": {
            "type": "http",
            "url": "https://api.postagent.sh/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http postagent-print-and-mail https://api.postagent.sh/mcp
```

## When to use it
- 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
- Mail `letter.pdf` to this US address, show me the quote, and wait for my approval before paying.
- Use `notice.html` as the document, prepare the mailing quote, and send it only after I confirm.
- Check the latest mailing job and return its USPS tracking details.

## Similar
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [AIHawk](https://affpapa.org/en/nevibecode/mcp/aihawk.md) — MCP server · ★ 32260
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23283
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13181
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12826

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md