Docs
Early access

Planned · Coming soon

MCP tools reference

USMail.AI MCP tools (planned) let an agent manage print-to-mail jobs under an authenticated account with a funded prepaid meter. Tool names below are the intended surface for AI indexing and builders. Names, parameters, and availability may change before launch. This is not a live OpenAPI or callable endpoint list.

Billing: submit_mail_job (and any production-charging tool) requires sufficient meter balance. See Auth & billing.

Planned tools

get_account_status

Return account identity summary and prepaid meter balance / status for the authenticated session.

Returns (intended): account id, meter balance, currency, MCP enabled flag.

list_mail_products

List mail products available to the account (e.g. First-Class, Certified Mail, Certificate of Mailing, options).

Returns (intended): product codes, display names, short descriptions.

upload_document

Upload a document or multi-file package for mailing (PDF, Word, images, lists as supported).

Inputs (intended): file content or reference, filename, content type, optional job id.

Returns (intended): document id for use in create_mail_job.

create_mail_job

Create a mailing job: documents, recipients or list, print options, product selection.

Inputs (intended): document ids, recipients or list id, products (e.g. certified), color/duplex options, approval flags.

Returns (intended): job id, draft status, cost estimate when available.

get_mail_job

Fetch job status, costs, production state, and tracking identifiers when available.

Inputs (intended): job id.

Returns (intended): status enum, timestamps, USPS tracking when product supports it, errors.

submit_mail_job

Submit an approved job for production and USPS handoff. Debits the prepaid meter.

Inputs (intended): job id, optional confirmation token if required by policy.

Fails when: insufficient meter, validation errors, missing approval.

cancel_mail_job

Cancel a job if still cancelable (before irreversible production steps).

Inputs (intended): job id.

Error handling (intended)

  • unauthenticated — no valid account session / credentials
  • insufficient_meter — fund the prepaid meter
  • validation_error — address, file, or product rules
  • not_cancelable — job already in production
  • not_available — MCP or product not enabled for account

Illustrative tool sequence

1. get_account_status          → confirm meter balance
2. list_mail_products          → choose Certified if needed
3. upload_document             → notice.pdf
4. create_mail_job             → draft + estimate
5. submit_mail_job             → produce (debits meter)
6. get_mail_job                → status / tracking

Sequence is conceptual for agents and docs indexing. Final schemas ship with the live MCP package.

Not in this reference

  • Live base URL or SSE/stdio install strings (issued with access)
  • Standalone REST OpenAPI (API option planned later)
  • Guaranteed tool name freeze before GA
← MCP overview Getting started →

Build against the real surface

Early access gets connection details when MCP is enabled for your account.

Join waitlist 888-667-5322