Overview · MCP · REST · Claude · ChatGPT and OpenAI
Developers · REST
Piloxa over REST
The same operations as the MCP tools, described by https://piloxa.com/openapi.json. No key. Each request below is sent to Piloxa by our test suite on every change.
Every service and its price
Free, no key. The same numbers the checkout charges.
curl -sS 'https://piloxa.com/api/public/certified-mail/rates?page_count=2'
The answer always includes: services.0.id, services.0.total, services.0.total_cents.
One price
curl -sS 'https://piloxa.com/api/v1/quote?page_count=1&service=CERTIFIED_ERR'
The answer always includes: total, total_cents.
Check a letter
Read only. Nothing is stored.
curl -sS -X POST https://piloxa.com/api/v1/check \
-H 'Content-Type: application/json' \
-d '{
"letter_text": "Dear Northwind Appliance Repair,\n\nI paid $480 on August 14 for a repair that was never done. Please refund it within 14 days of receiving this letter.\n\nSincerely,\nJordan Example",
"recipient_address_block": "Northwind Appliance Repair\n4821 Example Avenue, Suite 210\nSpringfield, IL 62704",
"sender_address_block": "Jordan Example\n12 Oak Street\nPeoria, IL 61602"
}'
The answer always includes: ready_to_prepare, estimated_page_count, recommended_service, current_estimated_price.total.
Prepare for approval
Send the person to approval_url. Keep session to ask for status.
curl -sS -X POST https://piloxa.com/api/v1/letters \
-H 'Content-Type: application/json' \
-d '{
"letter_text": "Dear Northwind Appliance Repair,\n\nI paid $480 on August 14 for a repair that was never done. Please refund it within 14 days of receiving this letter.\n\nSincerely,\nJordan Example",
"recipient_address_block": "Northwind Appliance Repair\n4821 Example Avenue, Suite 210\nSpringfield, IL 62704",
"sender_address_block": "Jordan Example\n12 Oak Street\nPeoria, IL 61602"
}'
The answer always includes: approval_url, session.
The capability manifest
curl -sS 'https://piloxa.com/agent-capabilities.json'
The answer always includes: services.0.id, operations.0.tool, policies.human_approval_required.
What no integration can do
- Mail or charge anything. 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.
- Read a person’s past letters anonymously. Status answers only for letters prepared in the same session.
- Decide a legal deadline. A deadline is the person’s to state; Piloxa only notices that a letter mentions one.