Direct answer: USMail.ai MCP lets AI agents prepare real print-to-mail jobs on the same production path as the portal. The agent connects over OAuth at https://app.usmail.ai/mcp, uploads files, sets options and requests a proof. A human sets a postage grant or approves on the app. Then we print, add postage and deliver to USPS.
What is the USMail.ai MCP page for?
Model Context Protocol is how an agent prepares print-to-mail on the same production path as the portal. This page is the lander. The reference lives in the docs: Connect, OAuth and client setup. Do not invent hostnames or paste install commands from a blog. See MCP documentation. The AI proposes setup, such as mail class, paper and color, and a human approves.
How does an agent prepare a mail job?
- Register. A human creates the account. Agents do not self-register.
- Set up payment. In the app, pay per mailing or keep an optional meter balance, managed by a human. Agent (MCP) approvals draw from your meter balance. Agents do not run card deposits.
- Connect. OAuth at https://app.usmail.ai/mcp. Connect / Authorize the existing usmail server. No API key. Never put a password in the prompt.
- Prepare. The agent uploads files, sets options and requests proof. It reads the addresses in your lists and never proposes one.
- Postage grant. A human sets a grant, or does Pay & Approve on the app.
Mixed Name and Company lists are valid. After ingest, read the digested rows. See Getting started and the tools reference.
Why does a human set the postage grant?
Physical mail cannot be unsent once we produce it, and the job spends real postage. An agent can assemble a clean job and still be wrong about the recipient, the class or the date.
A human sets a postage grant, capped or uncapped. With a grant on, the agent's submit approves the job within that grant. With the grant off, you review and Pay & Approve on the app. An approved job can be unapproved until its mail date, and unapproving puts the money back on your meter.
- Agent: prepare. Connects with OAuth, uploads files, sets options, requests proof, submits within the grant you set.
- Human: approve. Registers, manages payment, sets the postage grant, or reviews and does Pay & Approve.
Is this a public MCP endpoint?
No. There is no open server for anonymous tool calls. MCP is OAuth at https://app.usmail.ai/mcp. There are no standalone API keys. Use the USMail.ai Cursor plugin or Connect / Authorize the existing usmail server. See auth and billing.
How is MCP mail billed?
In the app, pay per mailing or keep an optional meter balance. Agent (MCP) approvals draw from your meter balance. Letters starting at $1.15, postage included. For a one-page, single-sided, black-and-white First-Class letter. Postage is always part of the cost. See how pricing works. If the meter balance cannot cover the job, an agent approval is rejected and production does not start. There is no silent overdraft.
Do agent jobs use the same production path?
Yes. Portal jobs and agent jobs share print, insert, postage and delivery to USPS. Cutoffs and tracing are the same. Certified Mail and Certificate of Mailing are available when configured on the job; Certified includes USPS tracking, is not for postcards and is never same-day. See Certified Mail.
MCP FAQ
What is the USMail.ai MCP?
MCP (Model Context Protocol) is how AI agents prepare print-to-mail jobs on the same production path as the portal. A human registers. The agent connects over OAuth at https://app.usmail.ai/mcp. A human sets a postage grant, capped or uncapped.
Is the MCP available now?
Yes. MCP is available now over OAuth at https://app.usmail.ai/mcp. It is not an unauthenticated public endpoint. Do not invent hostnames or add commands.
How do I pay for MCP mail jobs?
In the app, pay per mailing or keep an optional meter balance. Agent (MCP) approvals draw from your meter balance. A human manages payment. Agents do not run card deposits. Letters starting at $1.15, postage included. For a one-page, single-sided, black-and-white First-Class letter.
Do agents use a different mail pipeline than humans?
No. Agents and people use the same production path: print, insert, postage, and delivery to USPS.
Can an agent approve production mail?
Only within a postage grant a human sets, capped or uncapped. With the grant off, you review and Pay & Approve on the app.
Are mixed Name and Company lists valid?
Yes. Some rows have a person and a company. Some have only a name, and the name is the company. After ingest, read the digested rows.
Does the agent choose recipient addresses?
No. The agent works with the addresses in the files and lists you supply. The AI never proposes or adds an address.
When does my letter go to USPS?
By default, letters you approve before 10 p.m. CT are handed to USPS the next business day (Monday to Friday). USPS delivery times vary. USPS handles delivery from there. There are no contracts, subscriptions or setup fees.