Bull OTC
io.github.TMcodingarc/bull-otc · v1.0.0 · MCP 2025-06-18
Non-custodial RFQ and atomic swap settlement for AI agents. Escrow onchain, signed receipts.
Reachability
reachable
checked 2026-11-21 05:39 UTC
Registry status active
Tools pinned 29
191196af9322
Tools last changed
2026-11-21
Provenance
Registry namespace io.github.TMcodingarc
(GitHub-account verified by the official registry)
Repository
github.com/tmcodingarc/bull-family
repo gone
Website
https://www.bull.family
Remote endpoints
https://www.bull.family/api/mcp (streamable-http)
Observed changes
| When (UTC) | Event | Detail |
|---|---|---|
| 2026-11-21 05:39 | tools changed | 0 added, 0 removed, 1 changed |
| 2026-11-20 05:37 | tools changed | 2 added, 0 removed, 0 changed |
| 2026-11-18 05:37 | tools changed | 0 added, 0 removed, 1 changed |
| 2026-11-17 05:35 | tools changed | 2 added, 0 removed, 2 changed |
| 2026-11-16 05:34 | tools changed | 1 added, 0 removed, 2 changed |
| 2026-11-15 05:32 | tools changed | 6 added, 0 removed, 2 changed |
| 2026-11-14 05:31 | tools changed | 2 added, 0 removed, 1 changed |
| 2026-11-12 05:30 | first capture | 16 tools pinned |
Pinned tool definitions (29)
| Tool | Description |
|---|---|
| bull_consent_plan | Use as a SELLER right after the buyer accepted your quote: returns the exact deal terms to sign (EIP-712). Nothing moves, but the escrow contract only opens the deal with this signature. Signed: the first call returns a message to sign;... |
| bull_consent | Use as a SELLER to submit the signature from bull_consent_plan so the buyer can open the escrow. Signed: the first call returns a message to sign; call again with the same arguments plus timestamp and signature. |
| bull_settle | 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... |
| bull_settle_steps | 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. |
| bull_stream_create | 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).... |
| bull_stream_status | 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. |
| 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. |
| bull_agreement_from_template | 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. |
| bull_agreement_create | 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... |
| bull_agreement_status | 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. |
| bull_agreement_feed | 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... |
| bull_agreement_watch | 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... |
| bull_agent_reputation | Use BEFORE you accept or fund a deal with another agent: returns that wallet's record on Bull (deals completed, refunded, still open, how often it confirmed as evaluator, completion rate, settled volume), recomputed from the chain.... |
| bull_create_rfq | 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;... |
| bull_list_rfqs | 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... |
| bull_send_quote | 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... |
| bull_get_quotes | 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... |
| bull_counter_quote | 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.... |
| bull_revise_quote | 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.... |
| bull_accept_quote | 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... |
| bull_attach_deal | 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... |
| bull_deposit_plan | 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... |
| bull_deposit | 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... |
| bull_quote_status | 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... |
| bull_reject_quote | 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. |
| bull_get_deal | 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. |
| bull_get_receipt | 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. |
| 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. |
| 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. |
Get alerted when this changes.
Email the moment io.github.TMcodingarc/bull-otc drifts, dies, or revives.
Status badge
[](https://toolpin.dev/servers/io.github.TMcodingarc/bull-otc)
Maintain this server? Add the badge to your README. It links your users to this live status page.