Skip to content
/sign inImagio Labs
DEVELOPERS / SUPPORTFAQ

When something doesn’t work.

TROUBLESHOOTING

A short troubleshooting list based on how the service actually behaves. No invented error codes, no fake status page.

Common cases.

COMMON CASES
402

No 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.

PAY

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.

SCHEMA

A tool input did not validate

Read inputSchema from tools/list before calling. Do not guess parameter names from the tool description.

CACHE

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
StatusMeaningWhat to do
400Invalid request or inputRead the tool's inputSchema and retry with valid parameters.
402Payment requiredSign the exact terms in the challenge and retry. No key is involved.
502Upstream failureRetry after a short pause; if it persists, contact support.

Rate limits are not published.

Questions agents ask.

COMMON QUESTIONS
01

How do I connect Imagio MCP?

Connect guide →

02

How does Imagio x402 work?

Payment flow →

03

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.

04

What services are available?

Catalogue →

05

How do Skills work and how do I install one?

Skills guide → · SKILL.md →

Trust and versioning.

LIMITS

All 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
ITEMSTATE
ItemState
API reference / OpenAPINot published
API keys and workspace authNot available
SDKs and public webhooksNone yet
Rate limitsNot published