{"serverId":"mcp-registry/io.github.tmcodingarc/bull-otc","tools":[{"name":"bull_agreement_create","fixed":{"name":"bull_agreement_create","description":"Use when your agent must pay an agent it does not trust, and the payment should depend on conditions: a programmable escrow (\"do A when B does C\"), built from Bull blocks. The payer locks USDC (Base), USDG/ETH/any ERC-20 (Robinhood Chain); the payee is paid when ALL conditions are true: a time passed, a named agent or arbiter attested (confirmed delivery), an objection or veto window ended without an objection, k of n agents voted yes (quorum), another Bull deal settled, or an onchain value (tok","inputSchema":{"type":"object","required":["payer","payee","amount","conditions"],"properties":{"asset":{"type":"string","description":"\"eth\" (default, native ETH on both chains), the chain's stablecoin (\"usdg\" on Robinhood Chain, \"usdc\" on Base) or an ERC-20 address. Whole units."},"chain":{"type":"string","description":"robinhood (default) or base."},"payee":{"type":"string","description":"Wallet that is paid when every condition is true."},"payer":{"type":"string","description":"Wallet that locks the funds. It sends the approve and createAgreement transactions."},"terms":{"type":"string","description":"The agreement in plain words (optional). Its hash is stored onchain."},"amount":{"type":"string","description":"Amount to lock in WHOLE units, e.g. \"500\"."},"conditions":{"type":"array","items":{"type":"object"},"description":"1 to 8 conditions, all must be true. Each: {type:\"time_after\", afterHours|at} | {type:\"attest\", by:\"0xWallet\"} | {type:\"token_balance_gte\", token, holder, min} | {type:\"call_gte\"|\"call_lte\", target, data, value} | {type:\"deal_settled\", dealId} | {type:\"unless\", by, afterHours} (pays unless this wallet objects) | {type:\"veto\", by, afterHours, attestIndex} (objection window that starts when the attest at attestIndex happens) | {type:\"quorum\", by:[wallets], k}. A time_after or unless must end before expiryHours."},"expiryHours":{"type":"number","description":"Hours until anyone can refund the payer if the conditions are not met. Default 72."}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":575,"tokensAfter":575},{"name":"bull_agreement_status","fixed":{"name":"bull_agreement_status","description":"Use to check where an agreement stands before you serve, pay or wait: status, every condition with met true/false and who it is waiting on, and the next transactions (attest by the named wallet, release when all conditions are true, refund after expiry). Read from the chain. Public, no signature.","inputSchema":{"type":"object","required":["agreementId"],"properties":{"chain":{"type":"string","description":"robinhood (default) or base."},"agreementId":{"type":"string","description":"Agreement id from the AgreementCreated event."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":163,"tokensAfter":163},{"name":"bull_bridge_status","fixed":{"name":"bull_bridge_status","description":"Use after sending the bridge transactions from bull_bridge_quote: returns pending, confirmed, failed or refunded and the transaction hashes. Open the Bull agreement on the settlement chain only when it says confirmed. Public, no signature.","inputSchema":{"type":"object","required":["id"],"properties":{"id":{"type":"string","description":"The id returned by bull_bridge_quote (0x…, 66 characters)."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":125,"tokensAfter":125},{"name":"bull_counter_quote","fixed":{"name":"bull_counter_quote","description":"Use as a BUYER to negotiate: propose a different total price (and optionally a different token amount) on a pending quote. Returns the stored counter. The seller can answer with bull_revise_quote. Works only while the quote is pending. Signed: the first call returns a message to sign; call again with the same arguments plus timestamp and signature.","inputSchema":{"type":"object","required":["quoteId","price","address"],"properties":{"price":{"type":"string","description":"Your proposed total price in ETH."},"tokens":{"type":"string","description":"Your proposed token amount (optional)."},"address":{"type":"string","description":"Your wallet address (the buyer or seller). Required."},"quoteId":{"type":"string","description":"Quote id."},"signature":{"type":"string","description":"EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call."},"timestamp":{"type":"string","description":"From the previous bull_* response. Leave empty on the first call."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":291,"tokensAfter":291},{"name":"bull_create_rfq","fixed":{"name":"bull_create_rfq","description":"Use when you want to BUY a token in size (a block trade) without moving the market price: posts a private request for quotes on Bull, the modular, non-custodial settlement layer for OTC and agent-to-agent deals. Returns an rfqId; sellers answer with sealed quotes only you can read. Optional maxPrice limit and webhook; set dryRun to only validate, idempotencyKey to make retries safe. Not for small market swaps (use a DEX) or paying for API calls (use x402). Signed: the first call returns a messag","inputSchema":{"type":"object","required":["token","sizeUsd","address"],"properties":{"ref":{"type":"string","description":"Partner code of the project that sends you (optional). Claim one at https://www.bull.family/partners."},"note":{"type":"string","description":"Short note to sellers (optional)."},"chain":{"type":"string","description":"Chain name. Default: Robinhood Chain."},"token":{"type":"string","description":"Token contract address you want to buy."},"dryRun":{"type":"boolean","description":"true = only check the request, nothing is created. Optional."},"symbol":{"type":"string","description":"Token symbol (optional)."},"address":{"type":"string","description":"Your wallet address (the buyer or seller). Required."},"sizeUsd":{"type":"number","description":"Size in USD (minimum 5)."},"webhook":{"type":"string","description":"https URL that receives events: quote.received, quote.revised, deal.settled (optional)."},"maxPrice":{"type":"string","description":"Your limit: the most you will pay in total, in ETH (optional). Quotes above it are refused."},"signature":{"type":"string","description":"EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call."},"timestamp":{"type":"string","description":"From the previous bull_* response. Leave empty on the first call."},"windowMin":{"type":"number","description":"How long the request stays open, in minutes: 15, 30, 60, 360 or 1440. Default 60."},"idempotencyKey":{"type":"string","description":"Unique key (8-64 characters) so a retry never creates a duplicate. Optional."}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":591,"tokensAfter":591},{"name":"bull_get_deal","fixed":{"name":"bull_get_deal","description":"Use to verify any escrow deal onchain: open, settled or cancelled, and whether buyer and seller have funded. Public, no signature needed. Returns the deal state read from the contract.","inputSchema":{"type":"object","required":["dealId"],"properties":{"chain":{"type":"string","description":"robinhood (default) or base. Deal ids are per chain: pass the chain the deal was opened on."},"dealId":{"type":"string","description":"Deal number from the DealCreated event."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":142,"tokensAfter":142},{"name":"bull_get_quotes","fixed":{"name":"bull_get_quotes","description":"Use as a BUYER to read the sealed quotes on your own RFQ: seller, token amount, total price, counter state, deal status. Returns a list of quotes with quoteIds. Only the RFQ's buyer can read it. Signed: the first call returns a message to sign; call again with the same arguments plus timestamp and signature.","inputSchema":{"type":"object","required":["rfqId","address"],"properties":{"rfqId":{"type":"string","description":"RFQ id."},"address":{"type":"string","description":"Your wallet address (the buyer or seller). Required."},"signature":{"type":"string","description":"EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call."},"timestamp":{"type":"string","description":"From the previous bull_* response. Leave empty on the first call."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":231,"tokensAfter":231},{"name":"bull_get_receipt","fixed":{"name":"bull_get_receipt","description":"Use to get proof of a completed trade: a signed receipt for a settled deal (buyer, seller, token, amounts, fee) that anyone can re-check onchain. Public. Fails with not_settled for deals that are still open.","inputSchema":{"type":"object","required":["dealId"],"properties":{"chain":{"type":"string","description":"robinhood (default) or base. Pass the chain the deal was settled on."},"dealId":{"type":"string","description":"Deal number."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":136,"tokensAfter":136},{"name":"bull_info","fixed":{"name":"bull_info","description":"Use first to see what Bull is: the modular, non-custodial settlement layer for AGENT-TO-AGENT deals. Agents choose the terms (Bull blocks: arbiter, milestones, veto window, quorum, triggers, streams), Bull settles them. Returns supported chains (Robinhood Chain, Base with USDC), contracts, fee tiers, minimum size and auth rules. Public.","inputSchema":{"type":"object","required":[],"properties":{}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":122,"tokensAfter":122},{"name":"bull_list_rfqs","fixed":{"name":"bull_list_rfqs","description":"Use when you SELL or hold a token and want to find buyers: lists open requests for quotes on Bull (token, size in USD, window, buyer's price limit). Returns rfqIds to answer with bull_send_quote. Public, no signature needed. Not for finding market prices.","inputSchema":{"type":"object","required":[],"properties":{"chain":{"type":"string","description":"Chain name. Default: Robinhood Chain."},"token":{"type":"string","description":"Token contract address to filter by (optional)."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":147,"tokensAfter":147},{"name":"bull_payout_prefs_get","fixed":{"name":"bull_payout_prefs_get","description":"Use before you pay an agent, or to see how it wants to be paid: returns the wallet's signed payout preferences (chains in priority order, assets eth and/or stable, with the signature so you can verify it yourself; the answer also carries a server-side `verification` and a warning when the signature does not check out) or the default (no preference: the payer's chain is used). Public, read-only. Registering preferences is a signed PUT by the agent itself (PUT /api/v1/agents/{wallet}/payout-prefs,","inputSchema":{"type":"object","required":["wallet"],"properties":{"wallet":{"type":"string","description":"The agent's wallet (0x…). Returns its signed payout preferences, or the default (none)."}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":209,"tokensAfter":209},{"name":"bull_quote_status","fixed":{"name":"bull_quote_status","description":"Use as BUYER or SELLER to check a quote and its onchain deal: status (pending, confirmed, funded, released), dealId, counter, who has funded. Poll this or use webhooks. Only the two parties can read it. Signed: the first call returns a message to sign; call again with the same arguments plus timestamp and signature.","inputSchema":{"type":"object","required":["quoteId","address"],"properties":{"address":{"type":"string","description":"Your wallet address (the buyer or seller). Required."},"quoteId":{"type":"string","description":"Quote id."},"signature":{"type":"string","description":"EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call."},"timestamp":{"type":"string","description":"From the previous bull_* response. Leave empty on the first call."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":235,"tokensAfter":235},{"name":"bull_send_quote","fixed":{"name":"bull_send_quote","description":"Use when you want to SELL tokens to a buyer who posted an RFQ: sends a sealed quote (token amount and total ETH price) that only the buyer sees. Returns a quoteId. The swap settles atomically in one escrow transaction, so you never deliver before you are paid. Not for listing prices publicly. Signed: the first call returns a message to sign; call again with the same arguments plus timestamp and signature.","inputSchema":{"type":"object","required":["rfqId","tokens","price","address"],"properties":{"price":{"type":"string","description":"Total price in ETH, e.g. \"0.25\"."},"rfqId":{"type":"string","description":"RFQ id."},"dryRun":{"type":"boolean","description":"true = only check the request, nothing is created. Optional."},"payout":{"type":"string","description":"Wallet that receives the payment (optional)."},"tokens":{"type":"string","description":"Token amount, e.g. \"1000\"."},"address":{"type":"string","description":"Your wallet address (the buyer or seller). Required."},"webhook":{"type":"string","description":"https URL that receives events: quote.countered, quote.accepted, quote.rejected, deal.buyer_funded, deal.settled (optional)."},"signature":{"type":"string","description":"EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call."},"timestamp":{"type":"string","description":"From the previous bull_* response. Leave empty on the first call."},"idempotencyKey":{"type":"string","description":"Unique key (8-64 characters) so a retry never creates a duplicate. Optional."}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":440,"tokensAfter":440},{"name":"bull_settle","fixed":{"name":"bull_settle","description":"Use when two parties (agents, bots, contracts) have ALREADY agreed on a trade and just need a trustless way to swap: returns the signed createDeal transaction for an atomic escrow settlement on Bull. No account, no signature, no RFQ needed. On Robinhood Chain pay in ETH or USDG; on Base (chain \"base\") pay in USDC. The fee is returned in the response. Next call bull_settle_steps with the dealId and the same chain. Base: unaudited contracts, not yet tested with a live deal.","inputSchema":{"type":"object","required":["buyer","seller","sellToken","sellAmount","payAmount"],"properties":{"buyer":{"type":"string","description":"Wallet of the side that pays. It sends the createDeal transaction."},"chain":{"type":"string","description":"robinhood (default) or base. Base: USDC, the signature and fee quote are bound to Base's escrow. Unaudited contracts, no live Base deal tested yet."},"seller":{"type":"string","description":"Wallet of the side that delivers the tokens."},"deadline":{"type":"number","description":"Unix time of the deal deadline, fixed inside the consent (returned by consentOnly)."},"payAsset":{"type":"string","description":"Robinhood: \"eth\" (default) or \"usdg\". Base: \"usdc\" (default, only option)."},"payAmount":{"type":"string","description":"What the buyer pays, in the pay asset (ETH, USDG or USDC), e.g. \"0.25\"."},"sellToken":{"type":"string","description":"Token contract address the seller delivers (an ERC-20 on the chosen chain)."},"sellerSig":{"type":"string","description":"The seller's EIP-712 signature over the consent typed data. Required to get the createDeal transaction."},"sellAmount":{"type":"string","description":"Token amount, e.g. \"1000\"."},"validUntil":{"type":"number","description":"Unix time until which the seller's consent is valid (returned by consentOnly)."},"consentOnly":{"type":"boolean","description":"true = return the typed data (EIP-712) the SELLER must sign. Do this first, the seller signs, then call again with sellerSig, validUntil and deadline."},"buyerReceive":{"type":"string","description":"Wallet that receives the tokens (optional)."},"sellerPayout":{"type":"string","description":"Wallet that receives the payment (optional)."},"deadlineHours":{"type":"number","description":"Hours until anyone can cancel and refund both sides. Default 24, max 168."}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":661,"tokensAfter":661},{"name":"bull_settle_plan","fixed":{"name":"bull_settle_plan","description":"Use FIRST when you want to pay another agent and want to state WHAT you want (\"pay agent 0xB 25 USD for X, released when Y\"), not HOW: Bull decides the settlement chain, the asset and whether a bridge is needed, in this order: the seller's signed payout preferences (if you can satisfy them), otherwise the chain where YOU already hold enough (no bridge, the seller uses the same address there), otherwise the cheapest bridge route. Returns a machine-readable plan {settlementChain, settlementAsset, ","inputSchema":{"type":"object","required":["buyer","seller"],"properties":{"asset":{"type":"string","description":"\"stable\" or \"eth\": the denomination of `amount`."},"buyer":{"type":"string","description":"YOUR wallet (the payer). Bull never signs or sends for you."},"chain":{"type":"string","description":"Force the settlement chain: \"base\" or \"robinhood\". Normally leave empty: Bull decides."},"terms":{"type":"string","description":"What is being bought, in words (max 1000 characters). Committed as a hash."},"amount":{"type":"string","description":"Whole-unit amount in `asset`, e.g. \"0.01\" ETH. Needs asset."},"maxUsd":{"type":"number","description":"Policy: refuse anything above this many USD. Default 100."},"seller":{"type":"string","description":"The agent to pay (payee wallet)."},"arbiter":{"type":"string","description":"Arbiter wallet for templates that need one."},"payWith":{"type":"string","description":"What you hold and want to spend: \"stable\" or \"eth\". Different from the settlement asset = swap route."},"template":{"type":"string","description":"Template for the open-agreement step, e.g. arbiter_escrow (see bull_agreement_templates)."},"amountUsd":{"type":"number","description":"What to pay in USD, e.g. 25. Give this OR amount + asset."},"allowBridge":{"type":"boolean","description":"Policy: may the plan use a bridge? Default true, always shown in the plan."},"allowedAssets":{"type":"array","items":{"type":"string"},"description":"Policy: subset of [\"stable\",\"eth\"]. Default [\"stable\"]: ETH must be allowed on purpose."},"allowedChains":{"type":"array","items":{"type":"string"},"description":"Policy: subset of [\"base\",\"robinhood\"]. Default both."},"preferredAsset":{"type":"string","description":"\"stable\" or \"eth\": your wish when the seller has no stronger preference."},"maxBridgeFeeBps":{"type":"number","description":"Policy: refuse a bridge whose worst-case loss is above this many basis points. Default 500 (5%)."},"withTransactions":{"type":"boolean","description":"Also return the exact transactions of the first step (default true)."}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":738,"tokensAfter":738},{"name":"bull_settle_steps","fixed":{"name":"bull_settle_steps","description":"Use after createDeal: returns the exact transactions (approve and fund) each side must send next, with calldata, plus the deal status. The swap settles automatically when the second side funds. Public, no signature.","inputSchema":{"type":"object","required":["dealId"],"properties":{"chain":{"type":"string","description":"robinhood (default) or base. Pass the chain the deal was opened on."},"dealId":{"type":"string","description":"Deal id from the DealCreated event."}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":144,"tokensAfter":144},{"name":"bull_stats","fixed":{"name":"bull_stats","description":"Use to check Bull's track record: number of settled deals, total volume, open RFQs and the latest settled deals, read from the escrow contract. Public, no signature needed.","inputSchema":{"type":"object","required":[],"properties":{}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":76,"tokensAfter":76},{"name":"bull_stream_create","fixed":{"name":"bull_stream_create","description":"Use to pay someone per second: the payee's share unlocks linearly, they can withdraw what has vested at any time, and you (the payer) can cancel and get the unvested rest back. Optional arbiter can pause and resume (never move funds). ETH or any ERC-20. Returns the (approve and) createStream transactions with calldata. No account, no signature.","inputSchema":{"type":"object","required":["payer","payee","amount"],"properties":{"chain":{"type":"string","description":"robinhood (default) or base."},"payee":{"type":"string","description":"Wallet that receives the stream. Must differ from the payer."},"payer":{"type":"string","description":"Wallet that funds the stream. It sends the (approve and) createStream transactions."},"token":{"type":"string","description":"Leave out or \"ETH\" = native ETH (the default on BOTH chains). \"usdg\" (Robinhood Chain), \"usdc\" (Base) or any ERC-20 address."},"amount":{"type":"string","description":"Total amount to stream in WHOLE units of the token, e.g. \"100\" (or 0.5 for ETH). Use amountRaw for atomic units."},"arbiter":{"type":"string","description":"Optional third wallet that can pause and resume the stream. It can never move funds."},"startAt":{"type":"number","description":"Optional unix time in the future. Default: starts now."},"amountRaw":{"type":"string","description":"Optional: total in the token's smallest unit as an integer string (wei for ETH, 6 decimals for USDC/USDG). Overrides amount."},"durationDays":{"type":"number","description":"Days until everything has vested. Or use durationSeconds."},"durationSeconds":{"type":"number","description":"Seconds until everything has vested (1 second to 10 years)."}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":480,"tokensAfter":480},{"name":"bull_stream_status","fixed":{"name":"bull_stream_status","description":"Use to read a stream: vested, withdrawn, withdrawable, unvested, paused, and ready withdraw / cancel / pause / resume transactions (withdraw can be sent by anyone, the money always goes to the payee). Public, no signature.","inputSchema":{"type":"object","required":["streamId"],"properties":{"chain":{"type":"string","description":"robinhood (default) or base."},"streamId":{"type":"string","description":"Stream id from the StreamCreated event."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":138,"tokensAfter":138}],"toolsChanged":19,"tokensSaved":0,"todo":[],"note":"Deterministic fixes. Changes marked verify need a human look before shipping (renames, inferred annotations, inferred types, removed text). Parameter descriptions in `todo` need to be written by someone who knows the API."}