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 on the relay, not tools/list on the discovery bridge. Discovery is free and never returns a challenge. If a paid path on the relay returns no 402, report it; that is a service-health problem.
A paid call was refused
The site bridge at www.imagiolabs.com/mcp proxies only initialize and tools/list. Use https://relay.imagiolabs.com/mcp as your primary mcpServers config for paid calls.
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.
An unknown-method error appeared
This server exposes tools only. resources/list, prompts/list and ping are not implemented; use initialize and tools/list for discovery.
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 on the relay. No key is involved. |
| 502 | Upstream failure | Retry after a short pause; if it persists, contact support. |
Numeric rate limits are not published.
Questions agents ask.
COMMON QUESTIONSHow do I connect Imagio MCP?
Use https://relay.imagiolabs.com/mcp as the primary config for discovery plus paid calls. The site bridge at https://www.imagiolabs.com/mcp is an optional free discovery-only mirror. See the connect guide.
How does Imagio x402 work?
Discovery is free. A paid call returns a 402 challenge with exact terms, the client signs them, settlement happens on the relay, and the result comes back with an X-PAYMENT-RESPONSE receipt.
How do I pay for a call?
Discovery is free and keyless. A paid call returns a 402 challenge, settles over x402 on the relay with an x402-capable wallet and comes back with a receipt. There is no API key and no card checkout today.
What services are available?
139 endpoints across 9 families and 39 leaf categories. Browse the human catalogue or call tools/list for the machine list with schemas.
How do Skills work and how do I install one?
Free skills are access patterns served from /SKILL.md and listed in /skills.json. Install and discovery are free; execution is metered. Paid workflow skills are not for sale.
Is there a status page or a published rate limit?
No first-party status page and no published numeric rate limits. A third-party provider listing exists; we do not claim an uptime number. Error classes are documented below.
Related guides: MCP → · x402 → · catalogue → · skills →
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 |
| Numeric rate limits | Not published |
| First-party status page | None |
| Card checkout, API keys and credit packs via Ferry | Not live; roadmap only |
| Paid workflow skills | Not for sale |