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

BRIDGE

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.

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.

METHOD

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
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 on the relay. No key is involved.
502Upstream failureRetry after a short pause; if it persists, contact support.

Numeric rate limits are not published.

Questions agents ask.

COMMON QUESTIONS
How 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.

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
Numeric rate limitsNot published
First-party status pageNone
Card checkout, API keys and credit packs via FerryNot live; roadmap only
Paid workflow skillsNot for sale