Connect over MCP.
CONNECTMCP is the interface: one endpoint for an agent to discover capabilities, read their schemas and learn their payment terms. The canonical setup lives here; the live endpoint page is at /mcp.
Flagship tools; when to call.
LIVE CATALOGUE IS AUTHORITATIVE| Capability | When to call it | Returns |
|---|---|---|
| Token verdict | You need a fast, honest grade on a crypto token before a bot allocates or avoids it. | Grade, roast and live price, market cap and 24h change. |
| Claim verdict | You need a structured true / false / misleading / unverifiable verdict on a claim, with confidence and reasons. | Verdict, confidence and reasons. |
| Quantum signal | You want an on-demand allocation signal over the live market regime; a research signal, not advice. | Signal and conviction. |
| Wallet intelligence | You want a wallet’s risk and label profile from live on-chain data before trusting or paying it. | Labels, balances and activity-based risk. |
| Search pack | Your agent needs web, news and GitHub results as clean JSON it can parse, with no API key. | Title, URL and snippet per result. |
| Price snapshot | You need a fast multi-token USD price and 24h change snapshot without maintaining exchange keys. | Prices and 24h change. |
| Funding rates | You need perpetual funding rates across major venues in one normalized call. | Per-venue rate, APR and interval. |
| Market regime | You want the current market regime classified from Fear & Greed, VIX and SPY in one number. | Regime label, inputs and confidence. |
Full input schemas, current prices and limits come from tools/list and the live manifest ↗. Do not guess parameter names from a description.
Four steps to first discovery.
NO WALLET NEEDEDConfigure your client
Use the relay URL as the primary mcpServers config. No account and no API key are needed; calls are keyless.
Call initialize
The handshake returns serverInfo.name = imagio-relay, capabilities and the protocol version. It is free.
Call tools/list
Returns 139 tools with descriptions and input schemas. It is free and cached for 60 seconds on the site bridge.
Execute on the relay
Paid tools/call executes at relay.imagiolabs.com/mcp. An unpaid call returns a 402 challenge; a signed retry settles and returns a receipt.
PRIMARY · DISCOVERY + PAID CALLS (x402)
{ "mcpServers": { "imagio": { "url": "https://relay.imagiolabs.com/mcp" } } }OPTIONAL · FREE DISCOVERY ONLY (initialize + tools/list; paid calls refused)
{ "mcpServers": { "imagio-discovery": { "url": "https://www.imagiolabs.com/mcp" } } }SAMPLE DISCOVERY CALL (cURL, NO SDK)
curl -s https://www.imagiolabs.com/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"my-agent","version":"1.0.0"}}}'What each call costs.
TWO TIERS| Method | Cost | Note |
|---|---|---|
| initialize | Free | Handshake; returns server info and protocol version. |
| tools/list | Free | 139 tools with schemas; cached 60s on the site bridge. |
| tools/call | Per call | 402 challenge on the relay; signed x402 retry returns a receipt. |
Most paid calls are $0.002 to $0.05 USDC; quantum and GPU circuits run $0.07 to $0.30. Every paid call returns an X-PAYMENT-RESPONSE receipt. How payment works →
Common questions.
CONNECT / DISCOVER / CALLWhich URL do I put in my client?
Use https://relay.imagiolabs.com/mcp as the primary config: it supports discovery and paid execution. The site bridge at https://www.imagiolabs.com/mcp is an optional free discovery-only mirror; it refuses paid calls. Standardize on the www host for the bridge, not the apex, because the apex redirects POST requests.
Does MCP support resources, prompts, pagination or ping?
No. This server exposes tools only. resources/list, prompts/list and ping return an unknown-method error. A cursor parameter is accepted by tools/list but ignored; the full list is returned in one response.
Why did a tools/call return an error instead of a 402?
If you are pointing at the site bridge, paid calls are refused there by design. Switch to the relay URL. A genuine paid call on the relay with no payment attached returns an HTTP 402 challenge.
Do I need a wallet to discover tools?
No. initialize and tools/list are keyless and free. A wallet is only needed to sign a paid tools/call over x402.