The MCP tools never take a URL. A subscription created from chat always delivers to the inbox, and the tools neither list nor delete HTTP subscriptions. To have frames POSTed to a URL you own, create the subscription in the developer portal or over REST.
Subscribe
inbox_subscribe takes the same three things a REST create does — a type, its args and optional filters — and always sends "deliveryMode": "inbox". Ask Claude to “watch 0x28f0…9bad’s BTC fills of 1.5 or more” and it calls:
- Types are the ones on Subscription types: the six event types
tradesByUser,twapSliceFillsByUser,twapStatusesByUser,liquidations,liquidationsByUserandpriceCross, and the four cohort bias typescohortBias,cohortBiasFlip,cohortBiasOppositionandcohortBiasMove. The four liquidation risk typesliquidationRiskCross,liquidationRisk,liquidationExposureandliquidationMapare created the same way. args.useron the four by-user types is one address or an array of 1 to 1,000 — one subscription for all of them.liquidationstakes no args.priceCrosstakescoinand a positive decimal-stringthreshold, with optionalsource(markortrade) anddirection(above,beloworboth). The cohort bias types takecoinand, per type,cohort,otherCohort,direction, a decimal-stringpointsand optionaltierType. The two wallet liquidation risk types take exactly oneuserwithliquidationDistancePctorpoints; the two market ones takecoinwithpriceMovePctandminNotional, orpriceChangePct— every number a string,bucketsandrangeincluded (arguments).filtersare AND-combined: exact strings (coin,side) orgt/gte/lt/ltebounds on decimal strings. Numbers are always strings, never JSON numbers.priceCross,cohortBiasOpposition,liquidationRiskCross,liquidationExposureandliquidationMapaccept no extra filters.
data holds the cohort’s row after the flip, with the row before it under previous (cohortBiasFlip).
The service validates the type, the field names and your plan, exactly as it does for REST: a type above your plan is refused with 403, as is any subscription on Free, and a full allowance with 429 (Plan limits). Inbox and HTTP subscriptions share the same slots. The tool returns a compact receipt — subscribed, subscriptionId, deliveryMode, disabled — and has no signing secret to show, because an inbox subscription has none.
A subscription is immutable: to change it, unsubscribe and subscribe again, which resets a price crossing’s baseline and a cohort bias or liquidation risk subscription’s state. Creation is never retried automatically, so after an ambiguous failure the agent should call inbox_subscriptions before trying again rather than risk a duplicate. There is no snapshot and no replay: a subscription collects from the moment it exists. cohortBias is the exception — it delivers the current state once when it is created — and liquidationRiskCross, liquidationRisk and liquidationExposure can deliver on their first check if the condition is already met.
List and unsubscribe
inbox_subscriptions lists your inbox subscriptions — id, type, normalized args, filters and whether each is disabled — sorted by id, limit at a time (default 20, at most 100) with offset, hasMore and nextOffset to continue. HTTP subscriptions are left out, so their URLs never reach a chat transcript.
inbox_unsubscribe deletes one inbox subscription by its subscriptionId. It checks the id is an inbox subscription of yours first and refuses anything else; there is no bulk delete. Unsubscribing stops collection but keeps the messages already stored — they stay pending until drained or expired.
Read the inbox
inbox_state reports the inbox without touching it: pendingMessages, pendingBytes, your plan’s maxMessages and maxStoredBytes, and the two cumulative loss counters, overflowDroppedTotal and expiredTotal.
inbox_drain reads and consumes. It fetches the oldest pending messages (count, default 10, up to 1,000), keeps as many complete messages as fit the response budget, and acknowledges exactly those — a message it had to leave out stays pending for the next call, and a message’s data is never split. Each message is the delivery envelope — channel, seq, subscriptionId, data — plus its inboxId and receivedAt (the message).
The result carries messages, count, hasMore, acknowledged, ackStatus and the inbox state as it was before the acknowledgement (stateAt: "drain"); call inbox_state for the current counts. Three things follow from the tool acknowledging for you:
- A drain from chat deletes. Unlike the REST drain, which is safe to repeat until you ack, the tool acks as part of the same call. There is no peek: use
inbox_stateto look without consuming. ackStatus: "unconfirmed"means the acknowledgement did not come back. The messages are still returned, but they may reappear on the next drain — deduplicate byinboxId.- Two drains at once can return the same message. If several agents share an account, give one of them the job.
The tools
inbox_subscribe, inbox_unsubscribe and inbox_drain are the tools that change anything, and what they change is your Coinversa inbox subscriptions and inbox. The connector still never touches an exchange account, never signs and never trades.
Hosted connections
The tools work the same however you connected. A connection made with “Continue with Coinversa” in Claude, ChatGPT or another client is authenticated for you and resolves the same account, plan and allowance as your API key; a connection made by pasting a key, and the npx package, use that key directly.What arrives
Whatever created the subscription and wherever it delivers, the frame is the same: the raw source frame plussubscriptionId — stored with an inboxId and receivedAt in the inbox, signed with Standard Webhooks headers when POSTed to a URL. An agent reading it should treat data as the WebSocket fill objects they are — sizes and prices as decimal strings, side as A (sell) or B (buy), closedPnl from the node — and say what happened, not what to do about it. On a cohort bias type data holds cohort rows instead: report the cohort’s net bias and the snapshot’s time, which is when the snapshot was stored, not when the positioning changed. On a liquidation risk type data holds a wallet’s positions or a market’s exposure (delivered fields): report it as potential exposure from positions as last stored, checked about once a minute — not as a liquidation that happened, and not as a forecast of one. Market data is not advice.

