When something doesn’t work.
TROUBLESHOOTINGA short troubleshooting list based on how the service actually behaves. No invented error codes, no fake status page.
Common cases.
COMMON CASESNo 402 challenge came back
Check that you called a paid tool, not tools/list. Discovery is free and never returns a challenge. If a paid path returns no 402, report it; that is a service-health problem.
Payment was rejected
Check the network and asset in the 402 challenge, confirm your client signs the exact terms, and retry. Payments settle on the relay; the website does not handle them.
A tool input did not validate
Read inputSchema from tools/list before calling. Do not guess parameter names from the tool description.
The tool list looks stale
tools/list is cached for 60 seconds on the site bridge. Wait a minute or query the relay directly before reporting it.
Still stuck? Email support@imagiolabs.com with the tool name, the method and the response you received.
Error classes.
HTTP STATES| Status | Meaning | What to do |
|---|---|---|
| 400 | Invalid request or input | Read the tool's inputSchema and retry with valid parameters. |
| 402 | Payment required | Sign the exact terms in the challenge and retry. No key is involved. |
| 502 | Upstream failure | Retry after a short pause; if it persists, contact support. |
Rate limits are not published.
Questions agents ask.
COMMON QUESTIONSHow do I connect Imagio MCP?
How does Imagio x402 work?
How do I pay for a call?
Discovery is free. A paid call returns a 402 challenge, settles over x402 on the relay and comes back with a receipt.
What services are available?
How do Skills work and how do I install one?
Trust and versioning.
LIMITSAll endpoints are HTTPS. Discovery needs no credentials, so there are no API keys to leak. Paid calls are signed x402 payments settled on the relay, each returning an X-PAYMENT-RESPONSE receipt; every 402 carries X-Terms-Of-Service. Report issues to support@imagiolabs.com.
There is no first-party status page. Third-party provider listing: x402-trust.com ↗. Free Skills are version 1.0.0. The MCP protocol version is returned by initialize; no fixed MCP version is published here. No API versioning exists yet.
Not yet available.
NOT AVAILABLE YET| Item | State |
|---|---|
| API reference / OpenAPI | Not published |
| API keys and workspace auth | Not available |
| SDKs and public webhooks | None yet |
| Rate limits | Not published |