PostAgent logo PostAgent
Model Context Protocol · Streamable HTTP

Give your agent a post office.

PostAgent is an agent-payable MCP server that turns a PDF, HTML, Markdown, text, DOCX or image into physical mail (US → US). Jobs are paid per call with the x402 protocol — USDC on Base — using a quote-then-pay flow.

Connect the MCP See how it works
MCP endpoint https://postagent-api.interpretai.tech/mcp

From prompt to mailbox

Six tools, one quote-then-pay flow. Nothing is charged until the payment settles.

01

Create

Upload a finished letter or a {{field}} template. Auto-normalized to PDF with the recipient address zone left clear.

02

Quote

Verify sender + recipient addresses and lock a USDC price for 15 minutes. Get a preview of the final piece.

03

Pay & send

Your wallet signs the x402 challenge. The letter is created, then the payment settles. A delivery failure never charges you.

Install & connect

PostAgent is a remote MCP server — no install, no API key to start. Just point your client at the endpoint.

  1. Open ~/.cursor/mcp.json (create it if it doesn't exist).
  2. Add the PostAgent server below, then reload Cursor.
  3. Go to Settings → MCP and confirm PostAgent is connected.
~/.cursor/mcp.json
{
  "mcpServers": {
    "PostAgent": {
      "url": "https://postagent-api.interpretai.tech/mcp"
    }
  }
}
  1. Open Settings → Developer → Edit Config to find claude_desktop_config.json.
  2. Add the PostAgent server, save, and fully restart Claude Desktop.
  3. The PostAgent tools appear in the tools menu of any chat.
claude_desktop_config.json
{
  "mcpServers": {
    "PostAgent": {
      "url": "https://postagent-api.interpretai.tech/mcp"
    }
  }
}
  1. Most CLIs and runtimes accept a remote Streamable-HTTP MCP by URL.
  2. Add the entry to your client's mcp.json equivalent.
add via CLI
claude mcp add --transport http PostAgent \
  https://postagent-api.interpretai.tech/mcp
  1. PostAgent speaks MCP over Streamable HTTP in stateless mode.
  2. Any compliant MCP client can connect with just the remote URL — no auth handshake to list tools.
transport: streamable-http
URL       https://postagent-api.interpretai.tech/mcp
Transport streamable-http (stateless)
Auth      none to connect · x402 to send mail

Tool surface

Only one tool ever charges you. Everything else is free to call.

create_letterfree

Upload a finished document — identical content for every recipient. {{...}} is printed literally.

create_templatefree

Upload an HTML / Markdown / text template with {{fields}} filled per recipient (mail merge).

create_mail_quotefree

Verify addresses and lock a 15-minute USDC price for a document.

prepare_mail_paymentfree

Return the x402 PAYMENT-REQUIRED challenge for a quote.

submit_paid_mail_jobcharges

Settle the x402 payment and create the letter. Requires a signed payment and userConfirmed: true. Irreversible.

get_mail_job_statusfree

Look up normalized status and tracking for a job.

Read-only resources postagent://terms postagent://privacy postagent://formats postagent://pricing

Non-custodial by design

PostAgent never holds or signs with a wallet on your agent's behalf. Your runtime signs the x402 challenge with its own wallet and passes the resulting PAYMENT-SIGNATURE to submit_paid_mail_job.

  • Verify-first, settle-last: a print failure never captures a charge.
  • Per-call pricing returned in USD and atomic USDC (6 decimals).
  • Two-key safety: a signed payment and explicit user confirmation.
Protocolx402
NetworkBase · eip155:8453
AssetUSDC
CoverageUS → US documents
DeliveryPrint & mail

Any compliant x402 wallet can pay a quote in one shot:

pay a quote
npx awal@latest x402 pay \
  https://postagent-api.interpretai.tech/v1/quotes/qt_XYZ/pay \
  --max-amount 200000
Copied to clipboard