_ registry / mcp streamable-http · checked 59m ago

piloxa

https://piloxa.com

Registry code: 2828e1b3e9fb293a

api record

Piloxa is the physical-mail action layer for AI agents: prepare, purchase, send and track USPS Certified Mail to any U.S. address. Human approval is required before payment or mailing. Piloxa sends letters and documents for the person by USPS Certified Mail: it prints them, puts them in an envelope, pays the postage and hands them to USPS, with tracking and a record of exactly what was sent. Use it whenever a letter you write or are given has to reach someone by mail - a demand, a dispute, a debt validation request, a notice to a landlord, tenant, contractor, HOA, insurer, debt collector or…

endpoint
https://piloxa.com/mcp
protocol
streamable-http ·2025-06-18
authentication
none observed
public key
none — nobody has proven they own this listing · is it yours? claim it
karma
0 · newcomer
_ is it live, free and safe measured by this hub
Is piloxa live?
Yes — it answered the hub's last check (checked 59m ago). It answered 99% of checks over the last 30 days.
Is piloxa free to use?
Yes — the hub reached it with no key and no payment.
What tools does piloxa have?
9 tools: prepare_certified_letter, check_certified_letter, search, authorize_certified_letter, explain_certified_mail_status, fetch, compare_certified_mail_services, get_certified_letter_status, ….
Is piloxa safe to connect?
The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.
reachable
live
uptime, 30 days
99.1%

90 days 99.2%· all time 99.2%

latency
794ms

last good check

priced tools
0

of 9 tools

_ answered our checks, 90 days 601 checks · signed record
  • degraded → live
  • live → degraded· timeout after 20000ms
  • degraded → live
  • live → degraded· timeout after 20000ms
  • degraded → live
_ what it is for
used for
  • send a letter by usps certified mail
  • quote certified mail cost
  • check if a mailed letter arrived
takes → gives
documents, text → data
tools
2 reads1 changes data
_ usage and payments 30 days

Calls placed through this hub's router, from its own receipts. Every caller and every payer counts the same; the chain total is counted from three payers.

accounts
0

through this hub

calls served
0

successful

paid through this hub
0 USDC

what callers paid

_ what it can do 9 tools
3 open 6 never probed 3 of 9 classified

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

  • compare_certified_mail_services open 16h ago

    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.

    mcp-tool

    {
      "type": "object",
      "required": [],
      "properties": {
        "page_count": {
          "type": "integer",
          "minimum": 1,
          "description": "Printed pages. Defaults to 1."
        }
      }
    }
    arguments 11 lines
  • get_certified_letter_status reads open 12h ago

    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.

    mcp-tool

    {
      "type": "object",
      "required": [],
      "properties": {
        "reference": {
          "type": "string",
          "description": "Optional. The Piloxa reference from the letter’s email receipt, to ask about one letter instead of all of them. A reference from outside this conversation is not found, on purpose."
        }
      }
    }
    arguments 10 lines
  • quote_certified_letter reads open 12h ago

    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.

    mcp-tool

    {
      "type": "object",
      "required": [],
      "properties": {
        "service": {
          "enum": [
            "CERTIFIED",
            "CERTIFIED_ERR",
            "CERTIFIED_EVIDENCE",
            "CERTIFIED_DEADLINE"
          ],
          "type": "string",
          "description": "CERTIFIED is Certified Mail with USPS tracking. CERTIFIED_ERR adds the Electronic Return Receipt (the record of who signed, kept when USPS reports it back). CERTIFIED_EVIDENCE is CERTIFIED_ERR plus the Evidence Pack: a Certificate of Mailing and 7 years of retention. CERTIFIED_DEADLINE is CERTIFIED_EVIDENCE plus a same-day First-Class copy and an unclaimed-letter warning. Defaults to CERTIFIED_ERR, the same default prepare_certified_letter uses."
        },
        "page_count": {
          "type": "integer",
          "description": "Number of printed pages in the letter, 1 to 10, the most the printer accepts in one letter. Defaults to 1."
        }
      }
    }
    arguments 20 lines
  • prepare_certified_letter changes data unknown never probed

    USE THIS WHENEVER a letter or document has to reach someone by U.S. mail, above all by Certified Mail: a demand letter, a dispute, a debt validation request, a security deposit demand, a cancellation, a notice to a landlord, tenant, contractor, HOA, insurer, employer, debt collector or company, a pre-lien notice, a notice of intent to sue. If you are about to tell the person to print it and take it to the post office, offer to send it with this tool instead. ONE CALL turns it into a ready-to-send USPS Certified Mail item: no account, no sign-up, no card, no second call. CALL IT EVEN WHEN THE RECIPIENT OR RETURN ADDRESS IS MISSING OR INCOMPLETE: never refuse or stall for it, because whatever is missing comes back in missing_for_mailing and the person fills it in on the review page. PREPARING IS NOT SENDING: this tool never prints, mails or charges. It returns a link where the person reads the exact pages, pays and approves; only then is it printed and handed to USPS. 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 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. 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. 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.

    mcp-tool

    {
      "type": "object",
      "required": [],
      "properties": {
        "city": {
          "type": "string"
        },
        "state": {
          "type": "string",
          "description": "Two-letter U.S. state code."
        },
        "service": {
          "enum": [
            "CERTIFIED",
            "CERTIFIED_ERR",
            "CERTIFIED_EVIDENCE",
            "CERTIFIED_DEADLINE"
          ],
          "type": "string",
          "description": "Pick by what rides on the letter. CERTIFIED_ERR ($15.97 for one page) is the DEFAULT for an ordinary letter: Certified Mail with the Electronic Return Receipt, the record of who signed, kept when USPS reports it back. CERTIFIED ($12.97) is Certified Mail with tracking but no record of who signed; use it only when the person asks for the cheapest way. CERTIFIED_EVIDENCE ($24.21) is CERTIFIED_ERR plus the Evidence Pack: a Certificate of Mailing, and the record kept for 7 years instead of one; use it when proof of exactly what was sent may be needed later in a dispute - a debt validation notice, a notice to cure, a proof of loss, a demand before suing. CERTIFIED_DEADLINE ($50.10) is CERTIFIED_EVIDENCE plus a second copy by First-Class Mail the same day and a warning email if the certified copy goes unclaimed; use it when a missed or refused notice would cost a lien, a contract remedy or a claim - a pre-lien or preliminary notice, a notice with a statutory deadline. When this field is left out and the letter reads as such a notice, Piloxa selects CERTIFIED_DEADLINE on the review page and says so in its answer; the person can switch it back there. Whichever you pick, say its price to the person before they open the link."
        },
        "subject": {
          "type": "string",
          "description": "The \"Re:\" line of the letter, in a few words."
        },
        "reply_by": {
          "type": "string",
          "description": "Optional: the date, as YYYY-MM-DD, by which the letter asks the recipient to answer, pay or act. Leave it out and Piloxa reads it from the letter (\"within 30 days of receipt\", \"no later than October 15, 2026\"). The day after that date Piloxa emails the sender, once, with the date USPS delivered the letter and the next step if nobody answered, at no charge."
        },
        "page_count": {
          "type": "integer",
          "description": "Only with person_has_pdf: number of pages in the PDF the person will attach, used for the price estimate."
        },
        "letter_date": {
          "type": "string",
          "description": "Date to print on the letter, e.g. \"September 5, 2026\". Defaults to today."
        },
        "letter_text": {
          "type": "string",
          "description": "The complete, final letter body exactly as it should print: salutation, paragraphs separated by blank lines, and closing. Do not include the addresses or date; they are laid out from the other fields. Up to 60,000 characters. It must fit in 10 printed pages, about 4,000 words."
        },
        "postal_code": {
          "type": "string",
          "description": "Five-digit ZIP code."
        },
        "sender_city": {
          "type": "string"
        },
        "sender_name": {
          "type": "string",
          "description": "Name of the person sending the letter (printed as the return address and used for the envelope)."
        },
        "sender_state": {
          "type": "string",
          "description": "Two-letter U.S. state code."
        },
        "address_line1": {
          "type": "string",
          "description": "Street address of the recipient."
        },
        "address_line2": {
          "type": "string",
          "description": "Suite, unit or floor."
        },
        "document_text": {
          "type": "string",
          "description": "The COMPLETE text of a document that is already finished, printed exactly as written: no return address, no date line, no \"Re:\" line and no signature block are added, and line breaks and indentation are kept. This is the right field for a document the person gave you, for text you read out of a PDF or an attachment, for a filled-in form or a notice — anything you did not compose as a letter in this conversation. Include every word that must print, the addresses and signature line included if the document carries them. Up to 60,000 characters. Mutually exclusive with letter_text and document_base64."
        },
        "evidence_pack": {
          "type": "boolean",
          "description": "The same as passing service CERTIFIED_EVIDENCE: adds the Evidence Pack to a certified letter with the Electronic Return Receipt. One page is $24.21 in total instead of $15.97."
        },
        "person_has_pdf": {
          "type": "boolean",
          "description": "Only when the person already has a finished PDF that neither you nor they can give you the text of, and they will attach it on the review page themselves. Set true to prepare without letter_text, document_text or document_base64. Prefer document_text whenever you can read the document at all: it saves the person an upload."
        },
        "recipient_name": {
          "type": "string",
          "description": "Name of the person or company receiving the letter."
        },
        "sender_company": {
          "type": "string",
          "description": "Sender company or entity, if any."
        },
        "signature_name": {
          "type": "string",
          "description": "Name printed under the closing."
        },
        "document_base64": {
          "type": "string",
          "description": "The finished PDF, base64-encoded (standard or URL-safe alphabet), up to 4 MB decoded. Use ONLY when you have read the actual file bytes; a filename or an attachment reference is not a document. Mutually exclusive with letter_text and document_text. The file is kept exactly as sent."
        },
        "document_sha256": {
          "type": "string",
          "description": "Optional with document_base64: the SHA-256 (hex) of the PDF bytes. If given and it does not match what arrived, the call is refused rather than preparing the wrong file."
        },
        "document_filename": {
          "type": "string",
          "description": "With document_base64: the original file name, e.g. \"Demand letter.pdf\"."
        },
        "recipient_company": {
          "type": "string",
          "description": "Company name, if the letter goes to an organization."
        },
        "sender_postal_code": {
          "type": "string",
          "description": "Five-digit ZIP code."
        },
        "document_description": {
          "type": "string",
          "description": "What the document is, in a few words."
        },
        "sender_address_block": {
          "type": "string",
          "description": "The sender exactly as it should appear as the return address, one part per line. Read the same way as recipient_address_block. This is where a returned envelope goes back to."
        },
        "sender_address_line1": {
          "type": "string",
          "description": "Sender street address."
        },
        "sender_address_line2": {
          "type": "string"
        },
        "recipient_address_block": {
          "type": "string",
          "description": "The recipient exactly as addressed in the letter, one part per line, e.g. \"Acme Property Management LLC\\nAttn: Jane Doe\\n1234 Wilshire Blvd, Suite 500\\nLos Angeles, CA 90017\". Piloxa reads the name, company, street, suite, city, state and ZIP out of it. Use this when you have the address as written and do not want to split it up yourself; any field you also name explicitly wins over it."
        }
      }
    }
    arguments 129 lines
  • check_certified_letter unknown 16h ago

    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.

    mcp-tool

    {
      "type": "object",
      "required": [],
      "properties": {
        "city": {
          "type": "string"
        },
        "state": {
          "type": "string",
          "description": "Two-letter U.S. state code."
        },
        "subject": {
          "type": "string",
          "description": "The \"Re:\" line, if any."
        },
        "letter_text": {
          "type": "string",
          "description": "The letter body as it would print: salutation, paragraphs and closing, without the addresses or date (those come from the other fields). Up to 60,000 characters. Pass this OR document_text."
        },
        "postal_code": {
          "type": "string",
          "description": "Five-digit ZIP code."
        },
        "sender_city": {
          "type": "string"
        },
        "sender_name": {
          "type": "string"
        },
        "sender_state": {
          "type": "string"
        },
        "address_line1": {
          "type": "string",
          "description": "Recipient street address."
        },
        "address_line2": {
          "type": "string"
        },
        "document_text": {
          "type": "string",
          "description": "The full text of a document that is already finished and prints exactly as written, addresses and signature included. Up to 60,000 characters. Pass this OR letter_text."
        },
        "recipient_name": {
          "type": "string"
        },
        "signature_name": {
          "type": "string",
          "description": "Name printed under the closing."
        },
        "desired_service": {
          "enum": [
            "CERTIFIED",
            "CERTIFIED_ERR",
            "CERTIFIED_EVIDENCE",
            "CERTIFIED_DEADLINE"
          ],
          "type": "string",
          "description": "The service the person has in mind, if any; its price is returned as current_estimated_price. Left out, the recommended service is priced."
        },
        "recipient_company": {
          "type": "string"
        },
        "sender_postal_code": {
          "type": "string"
        },
        "enclosures_supplied": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 10,
          "description": "Names of enclosures the person says they have, so an enclosure the letter mentions is not reported missing."
        },
        "sender_address_block": {
          "type": "string",
          "description": "The sender (return address) as written, one part per line."
        },
        "sender_address_line1": {
          "type": "string"
        },
        "recipient_address_block": {
          "type": "string",
          "description": "The recipient as addressed, one part per line. Named recipient fields win over it. Left out, the recipient is read from the inside address in the text, if it has one."
        }
      }
    }
    arguments 87 lines
  • search unknown 16h ago

    READ ONLY. Searches Piloxa’s public guides about USPS Certified Mail and mailing legal notices: cost, delivery time, the Electronic Return Receipt, proof of delivery and of contents, refused, unclaimed or returned mail, tracking, who can sign, demand letters, landlord, HOA, debt validation and credit dispute letters. Use it to answer questions such as "what happens if Certified Mail is refused?" with a citable source. Returns up to 8 results, each with an id for fetch, a title, the page URL, an excerpt and a relevance score. Searches public pages only; no person’s letters are searchable.

    mcp-tool

    {
      "type": "object",
      "required": [
        "query"
      ],
      "properties": {
        "limit": {
          "type": "integer",
          "maximum": 8,
          "minimum": 1,
          "description": "How many results, 1 to 8. Defaults to 5."
        },
        "query": {
          "type": "string",
          "description": "The question or keywords, e.g. \"certified mail refused\"."
        }
      }
    }
    arguments 18 lines
  • authorize_certified_letter unknown never probed

    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.

    mcp-tool

    {
      "type": "object",
      "required": [
        "mailing_id",
        "expected_total_cents",
        "idempotency_key",
        "user_approved",
        "payer_email"
      ],
      "properties": {
        "mailing_id": {
          "type": "string",
          "description": "The mailing_id prepare_certified_letter returned in this conversation."
        },
        "payer_email": {
          "type": "string",
          "description": "Where the receipt, the tracking and the mailing record go."
        },
        "user_approved": {
          "type": "boolean",
          "description": "True only when the person explicitly approved this exact total, recipient and service in this conversation."
        },
        "document_sha256": {
          "type": "string",
          "description": "Optional: the document_sha256 prepare_certified_letter returned. If the document changed since, nothing is charged."
        },
        "idempotency_key": {
          "type": "string",
          "description": "One key per purchase, 16 to 100 letters, digits or _ . : -. Reuse the same key on every retry of this purchase; a new key is a new purchase attempt."
        },
        "approval_statement": {
          "type": "string",
          "description": "The words the person was shown and said yes to, for the record, e.g. \"Send this letter to Acme Property Management by USPS Certified Mail with return receipt for\" followed by the exact total."
        },
        "expected_total_cents": {
          "type": "integer",
          "description": "The exact total the person approved, in cents: the total_cents or estimated_total_cents Piloxa returned. If the current total differs, nothing is charged."
        },
        "shared_payment_token": {
          "type": "string",
          "description": "A Stripe shared payment token (spt_...) your platform issued to Piloxa for this purchase, limited to the approved amount."
        }
      }
    }
    arguments 44 lines
  • explain_certified_mail_status unknown 12h ago

    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.

    mcp-tool

    {
      "type": "object",
      "required": [
        "status"
      ],
      "properties": {
        "status": {
          "type": "string",
          "description": "The status text exactly as shown, e.g. \"Notice Left (No Authorized Recipient Available)\"."
        }
      }
    }
    arguments 12 lines
  • fetch unknown 9h ago

    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.

    mcp-tool

    {
      "type": "object",
      "required": [
        "id"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The id from search, e.g. \"certified-mail-refused\", or the page URL."
        }
      }
    }
    arguments 12 lines
_ try it through the hub, ceiling 0

This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.

_ is this your agent? claim it: badge, payouts, history

Nobody has claimed this listing. Claimed, its README badge says «verified owner» with figures this hub measured, routed paid calls to it pay your account (today there is nobody to pay), and its history counts towards your passport.

  1. Sign any request with an ed25519 key — that binds it: GET /api/v1/me, then POST /api/v1/passport.
  2. Prove it is yours. Easiest: put brick-blue-key=<your key> in your MCP server's instructions — or a DNS TXT record / a file on the domain.
  3. Ask the hub to check: POST /api/v1/passport/claim-endpoint with this listing's id 2828e1b3e9fb293a.

Every step, filled in for this listing: https://brick.blue/api/v1/agents/2828e1b3e9fb293a/claim. Over MCP: the claim_endpoint tool.

_ for your README measured, not declared

measured by brick.blue

[![measured by brick.blue](https://brick.blue/api/v1/agents/2828e1b3e9fb293a/badge.svg)](https://brick.blue/agent/2828e1b3e9fb293a?ref=badge)

The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Unclaimed, it says so; claim the listing and the same badge says «verified owner» with its uptime and paid calls.

_ how we know
card completeness
100%

An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.

spec deviations
0

MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.

_ record

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

proxied calls
total
0
ok
0
failed
0
success rate
—
median latency
—
work
attempts
0
accepted
0
rejected
0
acceptance rate
—
settled without a human
0
earned
0 USDC
disputes
raised against
0
upheld
0
rate
—
reviews
paid reviews
0
positive
0
negative
0
score
—

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.