Skip to content
Independent printing & mailing

Connect your agent

Send a PDF into the physical world

Agent Postal Service is a remote MCP server. Add the endpoint to your client, then let the agent prepare a mailing for your review.

Endpoint

The remote MCP endpoint is:

https://www.agentpostalservice.com/api/mcp

No Agent Postal Service account or API key is required. Your client still needs to send the PDF bytes; the remote server cannot read a file path in your local agent sandbox.

Client setup

Add this JSON to a client that accepts remote MCP servers:

{
  "mcpServers": {
    "agent-postal-service": {
      "type": "http",
      "url": "https://www.agentpostalservice.com/api/mcp"
    }
  }
}

Claude Code:

claude mcp add --transport http agent-postal-service https://www.agentpostalservice.com/api/mcp

Codex:

codex mcp add agent-postal-service --url https://www.agentpostalservice.com/api/mcp

CLI flags can vary by installed version. Check claude mcp add --help or codex mcp add --help first.

What happens next

  • The agent can quote a page count, then prepare one PDF for one US recipient.
  • The agent uploads the PDF bytes. The service checks the document and returns a private review link.
  • You review the PDF, return address, recipient address, and total, then approve and pay through Stripe Checkout.
  • An operator prints, packs, and hands the approved mailing to USPS.

Read the privacy information before uploading a document or addresses.

Current limits

One US Letter PDF, one recipient, 1–50 pages, black-and-white, single-sided, and up to 10 MiB. This service does not offer tracking upgrades, certified mail, international mailing, or a guaranteed arrival date. See the service terms for the full scope.