{"schema_version":"1","schema_doc":"https://piloxa.com/for-ai-agents#capability-manifest","name":"Piloxa","description":"The physical-mail action layer for AI agents: check, quote, prepare, send and track USPS Certified Mail to any U.S. address. A person reviews, pays and authorizes every letter.","canonical_url":"https://piloxa.com","operator":"Decentralized Publishing LLC, Irvine, California","version":"0.30.3","last_updated":"2026-10-07","interfaces":{"mcp":{"url":"https://piloxa.com/mcp","transport":"streamable-http","authentication":"none","server_card":"https://piloxa.com/.well-known/mcp.json"},"openapi":{"url":"https://piloxa.com/openapi.json","authentication":"none"},"public_facts":"https://piloxa.com/api/public/certified-mail","human_docs":"https://piloxa.com/for-ai-agents","llms_txt":"https://piloxa.com/llms.txt"},"policies":{"human_approval_required":true,"human_approval":"Nothing is printed, mailed or charged until a person reviews the exact document, the recipient and the total, and approves and pays on the review page. An assistant can check, quote and prepare; it cannot send.","account_required_to_prepare":false,"account_required_to_pay":true,"autonomous_mailing":false,"autonomous_charge":false,"destinations":"United States addresses","max_pages":10,"not_offered":["Restricted Delivery","paper green-card return receipt","Registered Mail","Priority Mail","international destinations"]},"operations":[{"tool":"check_certified_letter","openapi_operation":"checkCertifiedLetter","http":"POST /api/v1/check","read_only":true,"changes_state":false,"can_mail":false,"can_charge":false,"listed":true,"stage":"check","summary":"Read only. Checks a draft letter or document before mailing: page count, recipient and sender address completeness, missing fields, placeholders, a deadline in the text, the recommended service and its exact price. Stores nothing."},{"tool":"quote_certified_letter","openapi_operation":"quoteCertifiedLetter","http":"GET /api/v1/quote","read_only":true,"changes_state":false,"can_mail":false,"can_charge":false,"listed":true,"stage":"quote","summary":"Read only. The exact all-in total for a number of pages and a service."},{"tool":"prepare_certified_letter","openapi_operation":"prepareCertifiedLetter","http":"POST /api/v1/letters","read_only":false,"changes_state":true,"can_mail":false,"can_charge":false,"listed":true,"stage":"prepare","summary":"Creates an unsent letter and returns the review link where the person reads it, pays and authorizes. Never prints, mails or charges."},{"tool":"get_certified_letter_status","openapi_operation":"getCertifiedLetterStatus","http":"GET /api/v1/letters","read_only":true,"changes_state":false,"can_mail":false,"can_charge":false,"listed":true,"stage":"track","summary":"Read only. What USPS has reported about the letters prepared in the same conversation (or with the same API session)."},{"tool":"search","read_only":true,"changes_state":false,"can_mail":false,"can_charge":false,"listed":true,"stage":"learn","summary":"Read only. Searches Piloxa’s public Certified Mail guides; returns ids, titles, URLs and excerpts."},{"tool":"fetch","read_only":true,"changes_state":false,"can_mail":false,"can_charge":false,"listed":true,"stage":"learn","summary":"Read only. The full text of one guide, with its URL and last-updated date."},{"tool":"compare_certified_mail_services","http":"GET /api/public/certified-mail/rates","read_only":true,"changes_state":false,"can_mail":false,"can_charge":false,"listed":true,"stage":"quote","summary":"Read only. Every service Piloxa offers, what it includes, when to use it and its exact current price for a page count."},{"tool":"explain_certified_mail_status","read_only":true,"changes_state":false,"can_mail":false,"can_charge":false,"listed":true,"stage":"track","summary":"Read only. A USPS tracking status or Piloxa state in plain words, with the next step and the guide that explains it."},{"tool":"prepare_letter_pdf","http":"POST /api/v1/preparations","read_only":false,"changes_state":true,"can_mail":false,"can_charge":false,"listed":false,"enabled_by":"owner switch","stage":"prepare","summary":"Lays out a printable PDF and lists anything that would stop it being mailed. Free; never mails or charges."},{"tool":"authorize_certified_letter","read_only":false,"changes_state":true,"can_mail":false,"can_charge":true,"listed":false,"enabled_by":"owner switch (in-agent payment)","stage":"pay","summary":"Buys a letter prepared in the same conversation, only after the person approved the exact total, with a platform payment token. Off unless switched on."}],"workflow":["search / fetch (questions about Certified Mail)","check_certified_letter","quote_certified_letter or compare_certified_mail_services","prepare_certified_letter","human review, payment and authorization on the review page","get_certified_letter_status","explain_certified_mail_status"],"mcp_resources":["piloxa://services","piloxa://pricing","piloxa://agent-instructions","piloxa://certified-mail","piloxa://guides/{slug}"],"mcp_skills":{"extension":"io.modelcontextprotocol/skills","methods":["skills/list","skills/get"],"index":"https://piloxa.com/skills/index.json"},"services":[{"id":"CERTIFIED","name":"Certified Mail","summary":"USPS Certified Mail with tracking: a mailing receipt and a USPS record of delivery or attempted delivery.","includes":["printing","envelope","USPS postage","USPS Certified Mail fee","USPS tracking","the exact approved document and its SHA-256 fingerprint"],"when_to_use":"Only when the person asks for the cheapest way. There is no record of who signed.","default":false},{"id":"CERTIFIED_ERR","name":"Certified Mail with Electronic Return Receipt","summary":"Certified Mail plus the USPS electronic return receipt: the delivery date, the name and signature of whoever accepted it, and the delivery address.","includes":["everything in Certified Mail","USPS Electronic Return Receipt (who signed, and when)"],"when_to_use":"The default for an ordinary letter that may need proof of receipt.","default":true},{"id":"CERTIFIED_EVIDENCE","name":"Evidence Pack","summary":"Certified Mail with Electronic Return Receipt, plus a certificate naming the document by its SHA-256 fingerprint with the authorization, the article number and every USPS scan, and a longer retention period.","includes":["everything in Certified Mail with Electronic Return Receipt","Certificate of Mailing naming the document by its SHA-256","longer record retention"],"when_to_use":"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.","default":false},{"id":"CERTIFIED_DEADLINE","name":"Deadline Notice","summary":"The Evidence Pack plus a second copy sent the same day by First-Class Mail, and an email to the sender if USPS reports the certified copy unclaimed, refused or undelivered.","includes":["everything in the Evidence Pack","a same-day First-Class copy of the same letter","an email to the sender if the certified copy is reported unclaimed, refused or undelivered"],"when_to_use":"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.","default":false}],"pricing":{"currency":"USD","includes":"Printing, the envelope, USPS postage and the USPS extra-service fees. Nothing is added at checkout.","source":"The exact current price is returned by quote_certified_letter (GET /api/v1/quote). Prices follow the printer’s cost, so a typed figure can go stale.","endpoint":"https://piloxa.com/api/v1/quote","one_page":[{"id":"CERTIFIED","name":"Certified Mail","page_count":1,"total_cents":1297,"total":"$12.97"},{"id":"CERTIFIED_ERR","name":"Certified Mail with Electronic Return Receipt","page_count":1,"total_cents":1597,"total":"$15.97"},{"id":"CERTIFIED_EVIDENCE","name":"Evidence Pack","page_count":1,"total_cents":2421,"total":"$24.21"},{"id":"CERTIFIED_DEADLINE","name":"Deadline Notice","page_count":1,"total_cents":5010,"total":"$50.10"}],"promotion":{"id":"FIRST_LETTER","active":true,"price_cents":995,"price":"$9.95","service":"CERTIFIED","max_pages":2,"first_letter_only":true,"conditions":["Certified Mail without the return receipt, Evidence Pack or Deadline Notice","one or two pages","the first paid letter on an account, one per account"],"applied":"On the review page, once the account is known. The quote tools return the standard price and say when the promotion may apply; the review page shows the total that will be charged.","not_applied_on":["authorize_certified_letter"]}},"attribution":{"parameter":"src","example":"https://piloxa.com/mcp?src=partner:your-name","terms":"https://piloxa.com/for-partners"}}