Skip to main content
MCP server CX Codex

PostAgent · interpretai — Claude Code MCP server: what it does, how to install

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.

no license 528 installs updated 2026-06-17

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http postagent https://postagent.run.tools
Open on GitHub

What PostAgent 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.

What it helps with

  • 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 for the agent

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

How to install PostAgent

Platform CLI: remote server

claude mcp add --transport http postagent https://postagent.run.tools

Step 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 claude mcp add --transport http postagent https://postagent.run.tools. The server is added over HTTP and shows up in your MCP tool list.

What does PostAgent do?

It prints and mails physical letters and postcards through USPS on an agent's command: the document is uploaded, the price is held for 15 minutes, and the job goes to print once paid.

Do I need an API key or an account?

No. The agent pays per call in USDC on Base via x402, or by card through Stripe Checkout. Bulk campaigns need the paying wallet to pass KYC.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

PostAgent by other authors comes first.

Project sponsors

Companies that keep this analytics open