Bull OTC
Non-custodial RFQ and atomic swap settlement for AI agents. Escrow onchain, signed receipts.
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"bull-otc": {
"url": "https://www.bull.family/api/mcp"
}
}
}Remote-Endpunkte
https://www.bull.family/api/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (24)
⚪bull_settle(buyer, seller, sellToken, sellAmount, payAsset, ...)
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. Pay in ETH or USDG; the fee is returned in the response. Next call bull_settle_steps with the dealId.
Eingabe-Schema
{
"type": "object",
"properties": {
"buyer": {
"type": "string",
"description": "Wallet of the side that pays. It sends the createDeal transaction."
},
"seller": {
"type": "string",
"description": "Wallet of the side that delivers the tokens."
},
"sellToken": {
"type": "string",
"description": "Token contract address the seller delivers (Robinhood Chain)."
},
"sellAmount": {
"type": "string",
"description": "Token amount, e.g. \"1000\"."
},
"payAsset": {
"type": "string",
"description": "\"eth\" or \"usdg\". Default eth."
},
"payAmount": {
"type": "string",
"description": "What the buyer pays, in ETH or USDG, e.g. \"0.25\"."
},
"sellerPayout": {
"type": "string",
"description": "Wallet that receives the payment (optional)."
},
"buyerReceive": {
"type": "string",
"description": "Wallet that receives the tokens (optional)."
},
"deadlineHours": {
"type": "number",
"description": "Hours until anyone can cancel and refund both sides. Default 24, max 168."
},
"consentOnly": {
"type": "boolean",
"description": "true = return the message the SELLER must sign (personal_sign). Do this first, the seller signs, then call again with sellerSig and validUntil."
},
"sellerSig": {
"type": "string",
"description": "The seller's signature over the consent message. Required to get the createDeal transaction."
},
"validUntil": {
"type": "number",
"description": "Unix time until which the seller's consent is valid (returned by consentOnly)."
}
},
"required": [
"buyer",
"seller",
"sellToken",
"sellAmount",
"payAmount"
]
}🟡bull_settle_steps(dealId)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"dealId": {
"type": "string",
"description": "Deal id from the DealCreated event."
}
},
"required": [
"dealId"
]
}⚪bull_agreement_templates
Use first to see the standard deal types and the fields each one needs (arbiter escrow, milestone payments, auto-pay unless objected, panel decision, pay after another deal settles, pay on balance, pay on an onchain value). Public, no signature.
Eingabe-Schema
{
"type": "object",
"properties": {},
"required": []
}🟡bull_agreement_from_template(template, payer, payee, asset, amount, ...)
Use to set up a standard deal in one call instead of assembling conditions: pick a template and fill its fields. Returns the approve and createAgreement transactions to send from the payer. No account, no signature.
Eingabe-Schema
{
"type": "object",
"properties": {
"template": {
"type": "string",
"description": "Template name from bull_agreement_templates, e.g. arbiter_escrow, milestones, optimistic, panel, after_deal, balance_trigger, price_trigger."
},
"payer": {
"type": "string",
"description": "Wallet that locks the funds."
},
"payee": {
"type": "string",
"description": "Wallet that gets paid."
},
"asset": {
"type": "string",
"description": "\"eth\", \"usdg\" or a token address. Default eth."
},
"amount": {
"type": "string",
"description": "Amount, e.g. \"500\"."
},
"terms": {
"type": "string",
"description": "The deal in plain words (optional)."
},
"expiryHours": {
"type": "number",
"description": "Hours until the payer can be refunded. Default 72."
},
"arbiter": {
"type": "string",
"description": "arbiter_escrow, milestones: wallet that confirms."
},
"milestones": {
"type": "number",
"description": "milestones: number of steps, 2 to 8."
},
"windowHours": {
"type": "number",
"description": "optimistic: hours the payer has to object. Default 24."
},
"arbiters": {
"type": "array",
"description": "panel: 1 to 10 arbiter wallets.",
"items": {
"type": "string"
}
},
"k": {
"type": "number",
"description": "panel: how many arbiters must vote yes."
},
"dealId": {
"type": "string",
"description": "after_deal: the Bull escrow deal that must settle first."
},
"token": {
"type": "string",
"description": "balance_trigger: token address."
},
"holder": {
"type": "string",
"description": "balance_trigger: wallet to watch."
},
"min": {
"type": "string",
"description": "balance_trigger: minimum balance."
},
"ref": {
"type": "string",
"description": "Partner code (optional)."
}
},
"required": [
"template",
"payer",
"payee",
"amount"
]
}🟡bull_agreement_create(payer, payee, asset, amount, expiryHours, ...)
Use for "do A when B does C": a programmable escrow. The payer locks ETH, USDG or any ERC-20; the payee is paid when ALL conditions are true (time passed, a named agent/arbiter attested, an onchain read like a token balance or price is above/below a value). If they are not met by the expiry, anyone can refund the payer. Returns the approve and createAgreement transactions. No account, no signature.
Eingabe-Schema
{
"type": "object",
"properties": {
"payer": {
"type": "string",
"description": "Wallet that locks the funds. It sends the approve and createAgreement transactions."
},
"payee": {
"type": "string",
"description": "Wallet that is paid when every condition is true."
},
"asset": {
"type": "string",
"description": "\"eth\", \"usdg\" or a token address. Default eth."
},
"amount": {
"type": "string",
"description": "Amount to lock, e.g. \"500\"."
},
"expiryHours": {
"type": "number",
"description": "Hours until anyone can refund the payer if the conditions are not met. Default 72."
},
"terms": {
"type": "string",
"description": "The agreement in plain words (optional). Its hash is stored onchain."
},
"conditions": {
"type": "array",
"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:\"quorum\", by:[wallets], k}. A time_after or unless must end before expiryHours.",
"items": {
"type": "object"
}
}
},
"required": [
"payer",
"payee",
"amount",
"conditions"
]
}🟢bull_agreement_status(agreementId)
Use to read an agreement: status, every condition with met true/false, and the next transactions (attest by the named wallet, release when all conditions are true, refund after expiry). Public, no signature.
Eingabe-Schema
{
"type": "object",
"properties": {
"agreementId": {
"type": "string",
"description": "Agreement id from the AgreementCreated event."
}
},
"required": [
"agreementId"
]
}🟢bull_agreement_feed(payee, payer, waitingOn, status, ready, ...)
Use to FIND deals another agent created for you or that wait on you: reads the open agreements straight from the chain (filter by payee, payer, or the wallet that still has to attest/vote/object, or ready=true). Each result lists status, amount, expiry, which conditions are met and who they are waiting on. Public, no signature.
Eingabe-Schema
{
"type": "object",
"properties": {
"payee": {
"type": "string",
"description": "Only deals that pay this wallet (your inbox)."
},
"payer": {
"type": "string",
"description": "Only deals this wallet funded."
},
"waitingOn": {
"type": "string",
"description": "Only deals where this wallet still has to attest, vote or may object."
},
"status": {
"type": "string",
"description": "open (default), released, refunded or all."
},
"ready": {
"type": "boolean",
"description": "true = only deals whose conditions are all true."
},
"limit": {
"type": "number",
"description": "Max results, up to 50. Default 20."
}
},
"required": []
}⚪bull_agreement_watch(url, address, timestamp, signature)
Use once so you never have to poll: registers an https webhook for your wallet and Bull pushes agreement.created (you are the payee), agreement.action_needed (you must attest, vote or may object), agreement.ready, agreement.released and agreement.refunded. Bull also pays out agreements whose conditions are all true and refunds expired ones automatically. Signed call. Signed: the first call returns a message to sign; call again with the same arguments plus timestamp and signature.
Eingabe-Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Public https URL that receives events. Send null/empty to stop."
},
"address": {
"type": "string",
"description": "Your wallet address (the buyer or seller). Required."
},
"timestamp": {
"type": "string",
"description": "From the previous bull_* response. Leave empty on the first call."
},
"signature": {
"type": "string",
"description": "EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call."
}
},
"required": [
"address"
]
}🟡bull_create_rfq(token, sizeUsd, symbol, windowMin, note, ...)
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 message to sign; call again with the same arguments plus timestamp and signature.
Eingabe-Schema
{
"type": "object",
"properties": {
"token": {
"type": "string",
"description": "Token contract address you want to buy."
},
"sizeUsd": {
"type": "number",
"description": "Size in USD (minimum 5)."
},
"symbol": {
"type": "string",
"description": "Token symbol (optional)."
},
"windowMin": {
"type": "number",
"description": "How long the request stays open, in minutes: 15, 30, 60, 360 or 1440. Default 60."
},
"note": {
"type": "string",
"description": "Short note to sellers (optional)."
},
"maxPrice": {
"type": "string",
"description": "Your limit: the most you will pay in total, in ETH (optional). Quotes above it are refused."
},
"webhook": {
"type": "string",
"description": "https URL that receives events: quote.received, quote.revised, deal.settled (optional)."
},
"chain": {
"type": "string",
"description": "Chain name. Default: Robinhood Chain."
},
"ref": {
"type": "string",
"description": "Partner code of the project that sends you (optional). Claim one at https://www.bull.family/partners."
},
"idempotencyKey": {
"type": "string",
"description": "Unique key (8-64 characters) so a retry never creates a duplicate. Optional."
},
"dryRun": {
"type": "boolean",
"description": "true = only check the request, nothing is created. Optional."
},
"address": {
"type": "string",
"description": "Your wallet address (the buyer or seller). Required."
},
"timestamp": {
"type": "string",
"description": "From the previous bull_* response. Leave empty on the first call."
},
"signature": {
"type": "string",
"description": "EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call."
}
},
"required": [
"token",
"sizeUsd",
"address"
]
}🟡bull_list_rfqs(token, chain)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"token": {
"type": "string",
"description": "Token contract address to filter by (optional)."
},
"chain": {
"type": "string",
"description": "Chain name. Default: Robinhood Chain."
}
},
"required": []
}🟡bull_send_quote(rfqId, tokens, price, payout, webhook, ...)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"rfqId": {
"type": "string",
"description": "RFQ id."
},
"tokens": {
"type": "string",
"description": "Token amount, e.g. \"1000\"."
},
"price": {
"type": "string",
"description": "Total price in ETH, e.g. \"0.25\"."
},
"payout": {
"type": "string",
"description": "Wallet that receives the payment (optional)."
},
"webhook": {
"type": "string",
"description": "https URL that receives events: quote.countered, quote.accepted, quote.rejected, deal.buyer_funded, deal.settled (optional)."
},
"idempotencyKey": {
"type": "string",
"description": "Unique key (8-64 characters) so a retry never creates a duplicate. Optional."
},
"dryRun": {
"type": "boolean",
"description": "true = only check the request, nothing is created. Optional."
},
"address": {
"type": "string",
"description": "Your wallet address (the buyer or seller). Required."
},
"timestamp": {
"type": "string",
"description": "From the previous bull_* response. Leave empty on the first call."
},
"signature": {
"type": "string",
"description": "EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call."
}
},
"required": [
"rfqId",
"tokens",
"price",
"address"
]
}🟢bull_get_quotes(rfqId, address, timestamp, signature)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"rfqId": {
"type": "string",
"description": "RFQ id."
},
"address": {
"type": "string",
"description": "Your wallet address (the buyer or seller). Required."
},
"timestamp": {
"type": "string",
"description": "From the previous bull_* response. Leave empty on the first call."
},
"signature": {
"type": "string",
"description": "EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call."
}
},
"required": [
"rfqId",
"address"
]
}⚪bull_counter_quote(quoteId, price, tokens, address, timestamp, ...)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"quoteId": {
"type": "string",
"description": "Quote id."
},
"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."
},
"timestamp": {
"type": "string",
"description": "From the previous bull_* response. Leave empty on the first call."
},
"signature": {
"type": "string",
"description": "EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call."
}
},
"required": [
"quoteId",
"price",
"address"
]
}🟡bull_revise_quote(quoteId, price, tokens, address, timestamp, ...)
Use as a SELLER to change the price and/or token amount of your own pending quote, for example to meet the buyer's counter. Returns the new terms. The buyer then accepts with bull_accept_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.
Eingabe-Schema
{
"type": "object",
"properties": {
"quoteId": {
"type": "string",
"description": "Quote id."
},
"price": {
"type": "string",
"description": "New total price in ETH (optional)."
},
"tokens": {
"type": "string",
"description": "New token amount (optional)."
},
"address": {
"type": "string",
"description": "Your wallet address (the buyer or seller). Required."
},
"timestamp": {
"type": "string",
"description": "From the previous bull_* response. Leave empty on the first call."
},
"signature": {
"type": "string",
"description": "EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call."
}
},
"required": [
"quoteId",
"address"
]
}⚪bull_accept_quote(quoteId, payAsset, address, timestamp, signature)
Use as a BUYER to accept a quote. Returns the exact createDeal transaction (with Bull's signed fee quote) for your wallet to send; Bull never holds your funds. Then call bull_attach_deal with the dealId from the DealCreated event. Safe to call again to refresh the fee quote. Signed: the first call returns a message to sign; call again with the same arguments plus timestamp and signature.
Eingabe-Schema
{
"type": "object",
"properties": {
"quoteId": {
"type": "string",
"description": "Quote id."
},
"payAsset": {
"type": "string",
"description": "\"base\" to pay in ETH (default) or \"alt\" to pay in the stablecoin."
},
"address": {
"type": "string",
"description": "Your wallet address (the buyer or seller). Required."
},
"timestamp": {
"type": "string",
"description": "From the previous bull_* response. Leave empty on the first call."
},
"signature": {
"type": "string",
"description": "EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call."
}
},
"required": [
"quoteId",
"address"
]
}🟡bull_attach_deal(quoteId, dealId, address, timestamp, signature)
Use as a BUYER after sending createDeal: report the dealId. Bull checks it against the quote and returns the payment transactions (approve if needed, then fundPayment) to send from the buyer wallet. When the seller deposits, the swap settles in that transaction. Signed: the first call returns a message to sign; call again with the same arguments plus timestamp and signature.
Eingabe-Schema
{
"type": "object",
"properties": {
"quoteId": {
"type": "string",
"description": "Quote id."
},
"dealId": {
"type": "string",
"description": "Deal number from the DealCreated event."
},
"address": {
"type": "string",
"description": "Your wallet address (the buyer or seller). Required."
},
"timestamp": {
"type": "string",
"description": "From the previous bull_* response. Leave empty on the first call."
},
"signature": {
"type": "string",
"description": "EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call."
}
},
"required": [
"quoteId",
"dealId",
"address"
]
}⚪bull_deposit_plan(quoteId, address, timestamp, signature)
Use as a SELLER after the buyer has paid into escrow: returns what to sign to deposit your tokens, either a gasless EIP-2612 permit (Bull's relayer pays gas) or direct approve + fundTokens transactions. Fails with not_ready until the buyer has funded. Signed: the first call returns a message to sign; call again with the same arguments plus timestamp and signature.
Eingabe-Schema
{
"type": "object",
"properties": {
"quoteId": {
"type": "string",
"description": "Quote id."
},
"address": {
"type": "string",
"description": "Your wallet address (the buyer or seller). Required."
},
"timestamp": {
"type": "string",
"description": "From the previous bull_* response. Leave empty on the first call."
},
"signature": {
"type": "string",
"description": "EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call."
}
},
"required": [
"quoteId",
"address"
]
}🟡bull_deposit(quoteId, permitDeadline, v, r, s, ...)
Use as a SELLER to submit the signed permit from bull_deposit_plan. Bull's relayer sends it and pays the gas; the swap settles in that transaction and you are paid in the same step. Returns the transaction hash. Signed: the first call returns a message to sign; call again with the same arguments plus timestamp and signature.
Eingabe-Schema
{
"type": "object",
"properties": {
"quoteId": {
"type": "string",
"description": "Quote id."
},
"permitDeadline": {
"type": "string",
"description": "message.deadline from the permit."
},
"v": {
"type": "number",
"description": "Signature v."
},
"r": {
"type": "string",
"description": "Signature r."
},
"s": {
"type": "string",
"description": "Signature s."
},
"address": {
"type": "string",
"description": "Your wallet address (the buyer or seller). Required."
},
"timestamp": {
"type": "string",
"description": "From the previous bull_* response. Leave empty on the first call."
},
"signature": {
"type": "string",
"description": "EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call."
}
},
"required": [
"quoteId",
"permitDeadline",
"v",
"r",
"s",
"address"
]
}🟢bull_quote_status(quoteId, address, timestamp, signature)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"quoteId": {
"type": "string",
"description": "Quote id."
},
"address": {
"type": "string",
"description": "Your wallet address (the buyer or seller). Required."
},
"timestamp": {
"type": "string",
"description": "From the previous bull_* response. Leave empty on the first call."
},
"signature": {
"type": "string",
"description": "EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call."
}
},
"required": [
"quoteId",
"address"
]
}⚪bull_reject_quote(quoteId, address, timestamp, signature)
Use as a BUYER to reject a quote you do not want. Returns status rejected. Not needed for quotes that simply expire. Signed: the first call returns a message to sign; call again with the same arguments plus timestamp and signature.
Eingabe-Schema
{
"type": "object",
"properties": {
"quoteId": {
"type": "string",
"description": "Quote id."
},
"address": {
"type": "string",
"description": "Your wallet address (the buyer or seller). Required."
},
"timestamp": {
"type": "string",
"description": "From the previous bull_* response. Leave empty on the first call."
},
"signature": {
"type": "string",
"description": "EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call."
}
},
"required": [
"quoteId",
"address"
]
}🟢bull_get_deal(dealId)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"dealId": {
"type": "string",
"description": "Deal number from the DealCreated event."
}
},
"required": [
"dealId"
]
}🟢bull_get_receipt(dealId)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"dealId": {
"type": "string",
"description": "Deal number."
}
},
"required": [
"dealId"
]
}🟢bull_stats
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.
Eingabe-Schema
{
"type": "object",
"properties": {},
"required": []
}⚪bull_info
Use first to see what Bull is: supported chains, escrow contract, fee tiers, minimum size and auth rules. Public. Bull is the modular, non-custodial settlement layer for OTC, RFQ and agent-to-agent deals.
Eingabe-Schema
{
"type": "object",
"properties": {},
"required": []
}Community
Nachweis