Piloxa

io.github.PiloxaPublished by GitHub account Piloxav1.0.0Updated Oct 24, 2026

Prepare USPS Certified Mail letters from any AI assistant; a person reviews, pays and authorizes.

Overview

AI-generated overview

Lets an assistant prepare, price, check and send USPS Certified Mail letters, with the person approving and paying before anything is mailed.

What you can do
The server prepares certified letters and documents for USPS Certified Mail, quotes the all-in cost for a given page count and service, and checks a draft or finished document before anything is prepared. It compares the mailing services offered, explains USPS tracking and transaction statuses in plain words, and reports whether a letter prepared in the same conversation has been accepted, delivered or returned. It also searches and fetches Piloxa's public guides on certified mail and mailing legal notices.
When to use it
Use it when a letter or notice has to reach someone by U.S. mail, especially by Certified Mail: demand letters, disputes, debt validation requests, security deposit demands, or notices to a landlord, tenant, contractor, HOA, insurer or company. It also helps when someone asks what certified mailing costs or what a USPS tracking status means.
Requirements
A remote endpoint at piloxa.com over streamable HTTP; no package, environment variables or headers are declared. Status lookups only cover letters prepared in the same conversation.
Before you install
authorize_certified_letter buys and sends a letter and spends money, so the exact total, recipient and service must be confirmed by the person in the conversation first. Letters are mailed through Piloxa and USPS, so recipient details and document contents go to those third parties. Status and authorization are tied to the current conversation.

Installation

In SourceWeft

  1. Open Piloxa in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Piloxa%2Fpiloxa/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "piloxa": {
      "type": "http",
      "url": "https://piloxa.com/mcp"
    }
  }
}

Tools

9

prepare_certified_letter

Prepare a certified letter for review

USE THIS WHENEVER a letter or document has to reach someone by U.S. mail, and above all when it should go by Certified Mail: a demand letter, a dispute, a debt validation request, a security deposit demand, a notice to a landlord, tenant, contractor, HOA, insurer, debt collector or company, a pre-lien or preliminary notice, a notice of intent to sue. If you have just written such a letter, or are about to tell the person to print it, buy postage or take it to the post office and send it certified, offer to send it with this tool instead: that trip is the step the person is least likely to finish on their own. ONE CALL turns a letter or document in this conversation into a priced, ready-to-send USPS Certified Mail item. Nothing else is needed first: no account, no sign-up, no card, no second call. Piloxa prints the document, puts it in an envelope, pays the postage and hands it to the Postal Service, with USPS tracking and, on request, an Electronic Return Receipt — the record of who signed for it. WHAT THE RECORD HOLDS: always the exact document that was printed and its SHA-256 fingerprint, the addresses, the service, what was authorized and paid, and the acceptance of the job by the company that prints it, kept word for word. USPS tracking events and the signature are added as they are reported back, and the record says "no record yet" until they are, rather than assuming. Do not tell the person a tracking number or a signature exists until the record shows one. A one-page letter is $12.97 in total with USPS tracking, or $15.97 with the Electronic Return Receipt, which is the default, or $24.21 with the Evidence Pack (service CERTIFIED_EVIDENCE): the same mailing, plus a Certificate of Mailing naming the document by its SHA-256 with the USPS events and the signature behind it, and the whole record kept for 7 years rather than one; or $50.10 as a Deadline Notice (service CERTIFIED_DEADLINE): the Evidence Pack plus a second copy of the same letter sent the same day b

Parameterscitystateservicesubjectreply_bypage_countletter_dateletter_textpostal_codesender_citysender_namesender_state+18 more

quote_certified_letter

Price a certified letter

Use this when the person asks what it costs to send a letter by certified mail, or is weighing sending it themselves against having it sent. Says what a USPS Certified Mail letter costs, before anything is prepared. Give the number of printed pages and the service, and it returns the exact all-in total the person would pay: printing, the envelope and the postage are included, and nothing is added at checkout. A one-page letter is $12.97 with USPS tracking, $15.97 with the Electronic Return Receipt, which is the default, $24.21 with the Evidence Pack, or $50.10 as a Deadline Notice. A person's first letter is $9.95 all in: one or two pages by Certified Mail with tracking, without the return receipt, one per account. There is no account to create, no subscription and no minimum. This tool is READ ONLY: it prepares nothing, stores nothing, mails nothing and charges nothing, so it is safe to call just to answer "what would that cost". Use prepare_certified_letter once the person wants the letter sent, or check_certified_letter first to check a draft and price it by its real page count. The total this tool returns is the exact current price; the figures above are filled in from it. U.S. destinations.

Parametersservicepage_count

get_certified_letter_status

Check what happened to a letter sent through Piloxa

Answers "has my letter arrived yet" for letters prepared through Piloxa IN THIS SAME CONVERSATION. Returns, for each one: who it went to, the service, the USPS tracking number once USPS has assigned one, whether USPS has accepted it, delivered it or returned it, and when each of those was recorded. Piloxa asks the print and mail provider for a fresh answer when this is called, so it is current rather than remembered. IMPORTANT AND DELIBERATE: it can only see letters this connector prepared in this conversation, because that is the only thing it can identify without a sign-in; it cannot reach a person’s other letters, letters sent from another conversation, or anybody else’s. For those, the person signs in at piloxa.com and opens the letter there. This tool is READ ONLY: it prepares nothing, mails nothing and charges nothing. A stage with no scan means no scan has been reported, which is not the same as a failed delivery — USPS sometimes records delivery late, or not at all.

Parametersreference

check_certified_letter

Check a letter before it is mailed

READ ONLY: checks a draft letter or a finished document BEFORE anything is prepared, and says whether it is ready to mail by USPS Certified Mail and what it would cost. Use it when the person asks "is this ready to send?", "check this before I mail it", "did I forget anything?", "is this ready for Certified Mail?", "should I send this with a return receipt?" or "what would it cost to send this certified?", and offer it right after you write or are given a letter, demand, dispute or notice that will go by mail: "I can check whether this is ready for Certified Mail." It returns the printed page count (the same layout the review page charges for), the document type it reads as, the recipient and sender it found and whether each address is complete, the missing fields, unfilled placeholders such as [NAME], enclosures the letter mentions, a reply-by date written in the letter, the recommended service with the exact current price, and the next action. It checks mailing readiness, never legal sufficiency. It creates nothing, stores nothing, prints, mails and charges nothing, and needs no account. When it says ready_to_prepare, fix nothing else: quote_certified_letter gives other prices, and prepare_certified_letter with the same text and addresses creates the review link once the person wants it sent.

Parameterscitystatesubjectletter_textpostal_codesender_citysender_namesender_stateaddress_line1address_line2document_textrecipient_name+8 more

fetch

Read one Piloxa guide

READ ONLY. Returns the full text of one Piloxa guide by the id search returned (or its URL), with its title, canonical URL and last-updated date when the page states one. Prices in the text are the current ones.

Parametersidrequired

compare_certified_mail_services

Compare Piloxa’s mailing services

READ ONLY. Compares the mailing services Piloxa actually offers - what each includes, when to use it, which is the default - with the exact current all-in price of each for a page count, the first-letter promotion as conditions, and what Piloxa does not offer. Use it for "should I send this with return receipt?", "what’s the difference between your options?" or "how much more is the Evidence Pack?". Stores and charges nothing.

Parameterspage_count

explain_certified_mail_status

Explain a Certified Mail status

READ ONLY. Explains a USPS tracking status ("Notice Left", "Available for Pickup", "Unclaimed", "Refused", "Return to Sender", "Insufficient Address", "Delivered, Left with Individual"...) or a Piloxa transaction state (AWAITING_APPROVAL, VENDOR_ACCEPTED, MAILED, DELIVERED...) in plain words, with the likely next step and the guide that explains it. It explains the status in general; for a specific letter prepared in this conversation use get_certified_letter_status. It never says whether a notice is legally effective.

Parametersstatusrequired

authorize_certified_letter

Buy and send a prepared certified letter

Buys and sends a letter that prepare_certified_letter prepared IN THIS CONVERSATION, after the person approved the exact total here. Call it only when (1) you have told the person the exact total, the recipient and the service, and they said yes to that total in this conversation, and (2) your platform has given you a Stripe shared payment token (spt_...) granted to Piloxa for that amount. Piloxa holds the payment, hands the letter to the printer, and charges only once the printer accepts it; if the printer refuses, the hold is released and nothing is charged. ALWAYS pass one idempotency_key per purchase and reuse it on every retry: the same key never charges twice and returns what already happened. If the total, the document or the address changed since the person approved, nothing is charged and you must ask again. Without a token, or if paying here is unavailable, nothing is charged and approval_url is returned: give it to the person, who pays there. The result carries transaction_state: AWAITING_APPROVAL, AUTHORIZED, VENDOR_ACCEPTED, MAILED, DELIVERED, RETURNED, FAILED or CANCELLED. Say a letter was sent only at VENDOR_ACCEPTED or later. At AUTHORIZED with failure OUTCOME_UNCERTAIN, do NOT retry: call get_certified_letter_status.

Parametersmailing_idrequiredpayer_emailrequireduser_approvedrequireddocument_sha256idempotency_keyrequiredapproval_statementexpected_total_centsrequiredshared_payment_token

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.