# PostAgent

PostAgent — an MCP server that turns an agent's document into a printed letter or postcard shipped by USPS, with the price locked before anything goes to print.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 528 installs
- Author: interpretai
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/interpretai/postagent
- Updated: 2026-06-17
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/interpretai-postagent

## What it does

PostAgent is a remote MCP server at `https://postagent.run.tools`. Your agent hands it a finished document (PDF, HTML, Markdown, plain text, DOCX or an image), gets a quote, pays, and the file goes to print and into the USPS stream. There is no signup and no API key to issue: the agent pays per call in USDC on Base through x402, or by card.

The tools split the work. `create_letter` normalizes a final document into PDF. `create_template` takes a reusable file with `{{field}}` placeholders when each recipient needs different text. `create_mail_quote` checks both addresses and holds the price for 15 minutes. Postcards are built from two artwork uploads via `create_postcard_art` in 4x6, 6x9 or 6x11, always in color. Address verification can be called on its own for about 2¢.

Campaigns are the part to watch: bulk sends up to 500 recipients are KYC-gated and paid with x402 only. A single letter or card can go through Stripe Checkout instead, but then a human has to open the `checkoutUrl` and enter the card. Quotes cost nothing, and nothing ships before one is locked.

## Requirements
- Remote server: `https://postagent.run.tools`

## Install

### Claude Code (native platform)

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

### Codex

**Platform CLI: remote server**
```bash
codex mcp add interpretai-postagent --url https://postagent.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "interpretai-postagent": {
            "url": "https://postagent.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "interpretai-postagent": {
            "type": "http",
            "url": "https://postagent.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http interpretai-postagent https://postagent.run.tools
```

## When to use it
- mail a signed contract to a client's postal address
- check an address is deliverable before paying postage
- personalize one letter across a list of recipients
- send the same PDF to several addresses
- follow tracking events for a mailed letter

## Example prompts
- Quote a letter from `contract.pdf` to the address in `client.json` and show me the price first.
- Check whether the addresses in `recipients.csv` are deliverable.
- Build a template with `{{name}}` and `{{amount}}` fields and quote a campaign for the whole list.

## Similar
- [sendpaper](https://affpapa.org/en/nevibecode/plugins/sendpaper.md) — plugin · ★ 1596 repo stars
- [agentcash](https://affpapa.org/en/nevibecode/skills/agentcash.md) — skill · 2100 installs
- [TrustBench](https://affpapa.org/en/nevibecode/mcp/trustbench.md) — MCP server · 1029 installs
- [2s.io](https://affpapa.org/en/nevibecode/mcp/2sio.md) — MCP server · 928 installs
- [okx-agent-payments-protocol](https://affpapa.org/en/nevibecode/skills/okx-agent-payments-protocol.md) — skill · 16200 installs
- [x402 Gateway — ScriptMasterLabs](https://affpapa.org/en/nevibecode/mcp/x402-gateway-scriptmasterlabs.md) — MCP server · 223 installs

## Other versions with the same name
- [PostAgent · interpretai-tech](https://affpapa.org/en/nevibecode/mcp/postagent.md) — ★ 1 repo stars

---
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
