CREATEcreate_payment_requestCreate a request with an exact decimal-string amount, chosen asset/network and stable request ID. ON_SITE is the default; HPP returns the same saved order's hosted link.{"request_id":"report-sale-001", "amount":"10.00", "currency":"USD", "payment_method":"USDT_TRC20", "checkout_mode":"ON_SITE"}
QUERYget_payment_statusQuery a request created by your local installation. payment_verified requires the bound order to be PAID with the exact received amount. Your application controls delivery.{"request_id":"report-sale-001"}These tools request and track payment. They do not sign wallet transactions or spend funds.
1. Install dependenciesExtract the mochipay-mcp folder. Run from that folder:python3 -m venv .venv .venv/bin/python -m pip install -r requirements.txtWindows PowerShell:py -3 -m venv .venv .\.venv\Scripts\python.exe -m pip install -r requirements.txt
2. Configure your MCP hostUse the included mcp-config.example.json. Set absolute interpreter/server/state paths and merchant credentials privately. Your client's documented configuration location may differ.Creation is disabled unless MOCHIPAY_ALLOW_CREATE=true. Keep the private SQLite state file so retries reuse the original order. The configured maximum is a nominal per-order amount in the requested currency.Restart or reconnect the host and check that both tools appear. This local server is a separate download from the integration Skill.
3. Ask your connected agentUse MochiPay to create a 10 USD payment request for report access. Use USDT TRC20, HPP, and request_id report-sale-001. Then query report-sale-001 and tell me whether payment is verified.Reuse the same request ID and details after a timeout. A new ID creates a separate order. ON_SITE returns fields for your application's checkout; it does not embed a payment dialog in an arbitrary chat client.
Two checkout modes, one orderON_SITE: payment amount, network, address QR and status appear in a dialog on your PHP page.HPP: continue to the validated MochiPay hosted payment page and return to your application.Changing modes and recovering a lost create response reuse the saved payment. Do not round the exact chain amount.
Delivery stays on your serverThe sample checks ownership, the saved order, original price, currency, asset/network, receiving address and exact paid amount. Browser return parameters and callback payloads cannot unlock it by themselves.The included report is clearly marked sample content, not generated by a live AI model. Connect your own AI provider and persistent job queue for production generation.