Skip to main content
Glama

Server Details

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

Ownership verified
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-06-18
URL
ChatGPT
–
Claude
–

TDQS

A4.1/5.0

Scored across 13 tools

Disambiguation4/5

Most tools target clearly distinct actions (prepare, authorize, connect, list, follow-up), and the descriptions explicitly cross-reference each other to draw boundaries, e.g. check vs quote vs compare, and explain vs get_certified_letter_status vs get_my_letter. The remaining overlaps are fine-grained but real: three pricing-oriented read-only tools and three status-oriented tools, where an agent must read long descriptions carefully to pick correctly.

Naming Consistency4/5

Nearly all names follow a predictable verb_noun snake_case pattern (prepare_certified_letter, get_my_letter, list_my_letters, create_followup_draft). The exceptions are the bare verbs 'search' and 'fetch', which break the pattern and are less self-describing than the rest of the set.

Tool Count5/5

13 tools is well within a healthy range for a mailing service that spans pricing, preparation, payment, tracking, and knowledge lookup. Each tool corresponds to a distinct step in the certified-mail workflow rather than redundant variants.

Completeness4/5

The surface covers the full lifecycle: check/quote/compare, prepare, authorize/pay, track (three tracking tools), follow-up, history, plus guide search and fetch. Minor gaps exist — no cancel/refund operation and no in-connector edit of a prepared draft, both of which are punted to the piloxa.com review page rather than handled by a tool.

Available Tools

13 tools
authorize_certified_letterBuy and send a prepared certified letterA
DestructiveIdempotent
Inspect

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.

Inputs: mailing_id (required), payer_email (required), user_approved (required), idempotency_key (required), +5 more. Returns: mailed, charged, failure, receipt, +17 more

check_certified_letterCheck a letter before it is mailedA
Read-onlyIdempotent
Inspect

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?", or offer it once the person has said a letter, demand, dispute or notice 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.

Inputs: city, state, subject, letter_text, +16 more. Returns: scope, mailed, stored, charged, +22 more

compare_certified_mail_servicesCompare Piloxa’s mailing servicesA
Read-onlyIdempotent
Inspect

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.

Inputs: page_count. Returns: mailed, charged, services, promotion, +3 more

connect_my_lettersConnect this chat to the person’s Piloxa lettersAInspect

Use when the person wants to see, track or follow up on letters they sent with Piloxa in ANOTHER conversation, or wants their saved return address used. Returns a link and a 4-character code. Give the person both: they open the link, sign in with their email on piloxa.com, check the code matches, and press Allow. Only then can list_my_letters, get_my_letter and create_followup_draft see their letters, and only in this chat. It reads nothing, mails nothing and charges nothing. The person can disconnect at any time on that page.

Inputs: no named parameters. Returns: connected, expires_at, match_code, connect_url

create_followup_draftPrepare a follow-up to an earlier letterAInspect

Prepares a NEW letter to the same recipient as one of the person’s earlier letters (by reference), from the account’s saved return address, with the follow-up text you wrote with the person. It works exactly like prepare_certified_letter and returns a new review link: nothing from the earlier purchase carries over, and nothing is mailed or charged until the person reviews and pays for this new letter. Write the follow-up only after the person says no reply arrived or asks for one.

Inputs: reference (required), letter_text (required), service.

explain_certified_mail_statusExplain a Certified Mail statusA
Read-onlyIdempotent
Inspect

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.

Inputs: status (required). Returns: id, kind, next, scope, +3 more

fetchRead one Piloxa guideA
Read-onlyIdempotent
Inspect

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.

Inputs: id (required). Returns: id, url, text, title, +1 more

get_certified_letter_statusCheck what happened to a letter sent through PiloxaA
Read-onlyIdempotent
Inspect

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.

Inputs: reference. Returns: found, scope, mailed, charged, +1 more

get_my_letterOne of the person’s lettersA
Read-onlyIdempotent
Inspect

READ ONLY. The current status of one of the person’s own letters by its Piloxa reference, once this chat is connected: printer acceptance, USPS acceptance, delivery or return, the return receipt, each with its source and when it was last checked, the reply-by date if the letter set one, and where to download the mailing record (signed in on piloxa.com). A missing USPS scan means unknown, not failed; delivered does not mean read; a passed reply-by date does not mean nobody answered. Ask the person whether a reply arrived before suggesting a follow-up.

Inputs: reference (required). Returns: letter, connected

list_my_lettersList the person’s lettersA
Read-onlyIdempotent
Inspect

READ ONLY. The person’s own recent Piloxa letters, from any conversation, once this chat is connected with connect_my_letters. Optional query matches the recipient’s name or company, or the start of a Piloxa reference. Returns reference, recipient name, service, status, dates and where the status came from; never the letter text or full addresses. Without a connection it returns how to connect and nothing else.

Inputs: limit, query. Returns: found, letters, connected

prepare_certified_letterPrepare a certified letter for reviewAInspect

Use when the person wants a letter or an existing document physically mailed by USPS Certified Mail to a U.S. address: a demand, a dispute, a debt validation request, a deposit demand, a cancellation, a notice to a landlord, tenant, contractor, HOA, insurer, employer or company. Creates an UNSENT mailing draft and returns a review link and the current price. ONE CALL is enough: no account, no sign-up, no card, no second call. PREPARING IS NOT SENDING: this tool never prints, mails or charges. On that page the person reads the exact pages, recipient, service and total, then separately pays and approves; only then is it printed and mailed. A missing or incomplete recipient or return address does not stop the draft: it comes back in missing_for_mailing and the person completes it on the review page, but nothing can be mailed until it is complete. Do not call it merely because the person is drafting, revising, translating, saving or emailing a letter, or when they asked for ordinary mail, email or another channel; ask first if it is unclear that they want it mailed. Send only the document to be mailed and its addresses, never unrelated conversation content. Lead with the first-letter price: $9.95 all in (1-2 pages, Certified Mail with tracking, no return receipt, one per account). After that: A one-page letter is $12.97 in total with USPS tracking, $15.97 with the Electronic Return Receipt (the default: the record of who signed), $24.21 with the Evidence Pack or $50.10 as a Deadline Notice (see the service field); printing, envelope and postage included. A higher-priced service is used only when the person chooses it. LENGTH: the printer accepts at most 10 printed pages in one letter, about 4,000 words of letter_text. Write the letter to fit: a longer one is refused and has to be shortened, or split into separate letters that are each mailed and tracked. U.S. destinations only. If the letter sets a reply date, Piloxa emails the sender the day after that date with the USPS delivery date, free. THE DOCUMENT, one of: letter_text for a letter you wrote now (body only); document_text for a finished document you were given, printed exactly as written; document_base64 for PDF bytes you can read; person_has_pdf: true when they will attach it on the page. ADDRESSES: pass them as written in recipient_address_block and sender_address_block, one part per line.

Inputs: city, state, service, subject, +26 more. Returns: mailed, charged, service, identity, +23 more

quote_certified_letterPrice a certified letterA
Read-onlyIdempotent
Inspect

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. Lead with the first-letter price: $9.95 all in (1-2 pages, Certified Mail with tracking, no return receipt, one per account). After that: 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. 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.

Inputs: service, page_count. Returns: total, mailed, charged, service, +13 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to start unpaid postcard drafts from photos, notes, and recipient details, then hand off a link for review, payment, and mailing.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables agents to create and pay for physical postcards and letters, returning print previews and Stripe checkout links, with human review before USPS First-Class mailing to US addresses.
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.

    Resources