# Bull OTC (remote · www.bull.family)

Non-custodial RFQ and atomic swap settlement for AI agents. Escrow onchain, signed receipts.

- Trust score: 66/100 (medium)
- Change this week: +2
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

- remote · `www.bull.family`: 66/100 (this document), [markdown](https://verifymcp.io/servers/tmcodingarc-bull-otc/api-mcp.md), [page](https://verifymcp.io/servers/tmcodingarc-bull-otc/api-mcp)

## Channel facts

- Endpoint: `https://www.bull.family/api/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-21.

- **Endpoint Security**: 63/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 29 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 65/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 5187 tokens (~178/item across 29 items; 29 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 29/100
  - Stability check failed: schema churn in the 10 days we've observed: 0 tool removals, 1 breaking changes, 0 auth/transport breaks, 13 additions.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 75/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - 0 of 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "bull_send_quote" implies "send" and declares no destructiveHint at all, which the MCP spec reads as destructive by default.
  - An AI judge read all 30 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 60/100
  - Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28.

## Install

### How do I install the Bull OTC MCP server?

Bull OTC is a hosted endpoint at https://www.bull.family/api/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http tmcodingarc-bull-otc 'https://www.bull.family/api/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "tmcodingarc-bull-otc": {
      "url": "https://www.bull.family/api/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "tmcodingarc-bull-otc": {
      "type": "http",
      "url": "https://www.bull.family/api/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.tmcodingarc-bull-otc]
url = "https://www.bull.family/api/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "tmcodingarc-bull-otc": {
      "type": "remote",
      "url": "https://www.bull.family/api/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add tmcodingarc-bull-otc --url 'https://www.bull.family/api/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  tmcodingarc-bull-otc:
    url: "https://www.bull.family/api/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "tmcodingarc-bull-otc": {
      "Transport": "http",
      "Url": "https://www.bull.family/api/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add tmcodingarc-bull-otc -t streamable-http -u 'https://www.bull.family/api/mcp'
```

### Other

```json
{
  "mcpServers": {
    "tmcodingarc-bull-otc": {
      "type": "http",
      "url": "https://www.bull.family/api/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-21 (score 66, 0)

- [cosmetic] “bull_agreement_from_template” added an optional parameter “afterHours”
- [cosmetic] “bull_agreement_from_template” added an optional parameter “everyHours”
- [cosmetic] “bull_agreement_from_template” added an optional parameter “payees”
- [cosmetic] “bull_agreement_from_template” added an optional parameter “payments”
- [cosmetic] “bull_agreement_from_template” added an optional parameter “shares”
- [cosmetic] “bull_agreement_from_template” reworded the description of “template”

### 2026-11-20 (score 66, +1)

- [functional] New tool “bull_stream_create”
- [functional] New tool “bull_stream_status”

### 2026-11-18 (score 65, +1)

- [security regression] A breaking change shipped without a version bump: still 1.0.0
- [functional regression] “bull_consent” added a required parameter “consentSig”, so existing callers break
- [cosmetic] “bull_consent” made “signature” optional

### 2026-11-17 (score 64, 0)

- [security regression] Stability: 0.17 → fail
- [security regression] A breaking change shipped without a version bump: still 1.0.0
- [functional regression] “bull_deposit” added a required parameter “fundSig”, so existing callers break
- [functional] New tool “bull_consent”
- [functional] New tool “bull_consent_plan”
- [cosmetic] “bull_settle” added an optional parameter “deadline”
- [cosmetic] “bull_settle” reworded the description of “consentOnly”
- [cosmetic] “bull_settle” reworded the description of “sellerSig”

### 2026-11-16 (score 64, 0)

- [functional] New tool “bull_agent_reputation”
- [cosmetic] “bull_settle” added an optional parameter “consentOnly”
- [cosmetic] “bull_settle” added an optional parameter “sellerSig”
- [cosmetic] “bull_settle” added an optional parameter “validUntil”
- [cosmetic] “bull_agreement_from_template” reworded the description of “template”

### 2026-11-15 (score 64, 0)

- [security] Tool “bull_create_rfq” rewrote its description, which is the text the model reads
- [security] Tool “bull_info” rewrote its description, which is the text the model reads
- [functional regression] Schema quality: 2982 → 4203
- [functional] New tool “bull_agreement_create”
- [functional] New tool “bull_agreement_feed”
- [functional] New tool “bull_agreement_from_template”
- [functional] New tool “bull_agreement_status”
- [functional] New tool “bull_agreement_templates”
- [functional] New tool “bull_agreement_watch”

### 2026-11-14 (score 64, +1)

- [functional regression] Schema quality: 2629 → 2982
- [functional] New tool “bull_settle”
- [functional] New tool “bull_settle_steps”
- [cosmetic] “bull_create_rfq” added an optional parameter “ref”
- [cosmetic] “bull_create_rfq” reworded the description of “sizeUsd”

### 2026-11-12 (score 63, +1)

- [functional improvement] Stability: unverified → 0.03

## MCP tools (29)

### `bull_consent_plan` (~148 tokens)

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; call again with the same arguments plus timestamp and signature.

Input parameters:

- `address` (string, required): Your wallet address (the buyer or seller). Required.
- `quoteId` (string, required): Quote id.
- `signature` (string): EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call.
- `timestamp` (string): From the previous bull_* response. Leave empty on the first call.

### `bull_consent` (~158 tokens)

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.

Input parameters:

- `address` (string, required): Your wallet address (the buyer or seller). Required.
- `consentSig` (string, required): 65-byte EIP-712 signature over the typedData from bull_consent_plan (not the request signature).
- `quoteId` (string, required): Quote id.
- `signature` (string): EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call.
- `timestamp` (string): From the previous bull_* response. Leave empty on the first call.

### `bull_settle` (~378 tokens)

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.

Input parameters:

- `buyer` (string, required): Wallet of the side that pays. It sends the createDeal transaction.
- `buyerReceive` (string): Wallet that receives the tokens (optional).
- `consentOnly` (boolean): 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.
- `deadline` (number): Unix time of the deal deadline, fixed inside the consent (returned by consentOnly).
- `deadlineHours` (number): Hours until anyone can cancel and refund both sides. Default 24, max 168.
- `payAmount` (string, required): What the buyer pays, in ETH or USDG, e.g. "0.25".
- `payAsset` (string): "eth" or "usdg". Default eth.
- `sellAmount` (string, required): Token amount, e.g. "1000".
- `sellToken` (string, required): Token contract address the seller delivers (Robinhood Chain).
- `seller` (string, required): Wallet of the side that delivers the tokens.
- `sellerPayout` (string): Wallet that receives the payment (optional).
- `sellerSig` (string): The seller's EIP-712 signature over the consent typed data. Required to get the createDeal transaction.
- `validUntil` (number): Unix time until which the seller's consent is valid (returned by consentOnly).

### `bull_settle_steps` (~68 tokens)

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.

Input parameters:

- `dealId` (string, required): Deal id from the DealCreated event.

### `bull_stream_create` (~251 tokens)

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.

Input parameters:

- `amount` (string, required): Total amount to stream, e.g. "100".
- `arbiter` (string): Optional third wallet that can pause and resume the stream. It can never move funds.
- `durationDays` (number): Days until everything has vested. Or use durationSeconds.
- `durationSeconds` (number): Seconds until everything has vested (1 second to 10 years).
- `payee` (string, required): Wallet that receives the stream. Must differ from the payer.
- `payer` (string, required): Wallet that funds the stream. It sends the (approve and) createStream transactions.
- `startAt` (number): Optional unix time in the future. Default: starts now.
- `token` (string): ERC-20 address, or leave out / "ETH" for ETH.

### `bull_stream_status` (~75 tokens)

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.

Input parameters:

- `streamId` (string, required): Stream id from the StreamCreated event.

### `bull_agreement_templates` (~63 tokens)

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` (~468 tokens)

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.

Input parameters:

- `afterHours` (number): scheduled_payment: hours from now until the payee can be paid.
- `amount` (string, required): Amount, e.g. "500".
- `arbiter` (string): arbiter_escrow, milestones: wallet that confirms.
- `arbiters` (array): panel: 1 to 10 arbiter wallets.
- `asset` (string): "eth", "usdg" or a token address. Default eth.
- `dealId` (string): after_deal: the Bull escrow deal that must settle first.
- `everyHours` (number): recurring_payment: hours between payments. Default 168.
- `expiryHours` (number): Hours until the payer can be refunded. Default 72.
- `holder` (string): balance_trigger: wallet to watch.
- `k` (number): panel: how many arbiters must vote yes.
- `milestones` (number): milestones: number of steps, 2 to 8.
- `min` (string): balance_trigger: minimum balance.
- `payee` (string, required): Wallet that gets paid.
- `payees` (array): split_payment: 2 to 10 wallets that get paid.
- `payer` (string, required): Wallet that locks the funds.
- `payments` (number): recurring_payment: number of payments, 2 to 12 (amount is ONE payment).
- `ref` (string): Partner code (optional).
- `shares` (array): split_payment: one positive number per payee, e.g. [70, 30].
- `template` (string, required): Template name from bull_agreement_templates, e.g. arbiter_escrow, milestones, recurring_payment, split_payment, optimistic, panel, scheduled_payment, after_deal, balance_trigger, price_trigger, token…
- `terms` (string): The deal in plain words (optional).
- `token` (string): balance_trigger: token address.
- `windowHours` (number): optimistic: hours the payer has to object. Default 24.

### `bull_agreement_create` (~361 tokens)

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.

Input parameters:

- `amount` (string, required): Amount to lock, e.g. "500".
- `asset` (string): "eth", "usdg" or a token address. Default eth.
- `conditions` (array, required): 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,…
- `expiryHours` (number): Hours until anyone can refund the payer if the conditions are not met. Default 72.
- `payee` (string, required): Wallet that is paid when every condition is true.
- `payer` (string, required): Wallet that locks the funds. It sends the approve and createAgreement transactions.
- `terms` (string): The agreement in plain words (optional). Its hash is stored onchain.

### `bull_agreement_status` (~69 tokens)

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.

Input parameters:

- `agreementId` (string, required): Agreement id from the AgreementCreated event.

### `bull_agreement_feed` (~183 tokens)

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.

Input parameters:

- `limit` (number): Max results, up to 50. Default 20.
- `payee` (string): Only deals that pay this wallet (your inbox).
- `payer` (string): Only deals this wallet funded.
- `ready` (boolean): true = only deals whose conditions are all true.
- `status` (string): open (default), released, refunded or all.
- `waitingOn` (string): Only deals where this wallet still has to attest, vote or may object.

### `bull_agreement_watch` (~188 tokens)

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.

Input parameters:

- `address` (string, required): Your wallet address (the buyer or seller). Required.
- `signature` (string): EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call.
- `timestamp` (string): From the previous bull_* response. Leave empty on the first call.
- `url` (string): Public https URL that receives events. Send null/empty to stop.

### `bull_agent_reputation` (~79 tokens)

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. Public, no signature.

Input parameters:

- `wallet` (string, required): The wallet (0x…) to look up.

### `bull_create_rfq` (~442 tokens)

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.

Input parameters:

- `address` (string, required): Your wallet address (the buyer or seller). Required.
- `chain` (string): Chain name. Default: Robinhood Chain.
- `dryRun` (boolean): true = only check the request, nothing is created. Optional.
- `idempotencyKey` (string): Unique key (8-64 characters) so a retry never creates a duplicate. Optional.
- `maxPrice` (string): Your limit: the most you will pay in total, in ETH (optional). Quotes above it are refused.
- `note` (string): Short note to sellers (optional).
- `ref` (string): Partner code of the project that sends you (optional). Claim one at https://www.bull.family/partners.
- `signature` (string): EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call.
- `sizeUsd` (number, required): Size in USD (minimum 5).
- `symbol` (string): Token symbol (optional).
- `timestamp` (string): From the previous bull_* response. Leave empty on the first call.
- `token` (string, required): Token contract address you want to buy.
- `webhook` (string): https URL that receives events: quote.received, quote.revised, deal.settled (optional).
- `windowMin` (number): How long the request stays open, in minutes: 15, 30, 60, 360 or 1440. Default 60.

### `bull_list_rfqs` (~98 tokens)

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.

Input parameters:

- `chain` (string): Chain name. Default: Robinhood Chain.
- `token` (string): Token contract address to filter by (optional).

### `bull_send_quote` (~305 tokens)

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.

Input parameters:

- `address` (string, required): Your wallet address (the buyer or seller). Required.
- `dryRun` (boolean): true = only check the request, nothing is created. Optional.
- `idempotencyKey` (string): Unique key (8-64 characters) so a retry never creates a duplicate. Optional.
- `payout` (string): Wallet that receives the payment (optional).
- `price` (string, required): Total price in ETH, e.g. "0.25".
- `rfqId` (string, required): RFQ id.
- `signature` (string): EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call.
- `timestamp` (string): From the previous bull_* response. Leave empty on the first call.
- `tokens` (string, required): Token amount, e.g. "1000".
- `webhook` (string): https URL that receives events: quote.countered, quote.accepted, quote.rejected, deal.buyer_funded, deal.settled (optional).

### `bull_get_quotes` (~157 tokens)

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.

Input parameters:

- `address` (string, required): Your wallet address (the buyer or seller). Required.
- `rfqId` (string, required): RFQ id.
- `signature` (string): EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call.
- `timestamp` (string): From the previous bull_* response. Leave empty on the first call.

### `bull_counter_quote` (~181 tokens)

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.

Input parameters:

- `address` (string, required): Your wallet address (the buyer or seller). Required.
- `price` (string, required): Your proposed total price in ETH.
- `quoteId` (string, required): Quote id.
- `signature` (string): EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call.
- `timestamp` (string): From the previous bull_* response. Leave empty on the first call.
- `tokens` (string): Your proposed token amount (optional).

### `bull_revise_quote` (~183 tokens)

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.

Input parameters:

- `address` (string, required): Your wallet address (the buyer or seller). Required.
- `price` (string): New total price in ETH (optional).
- `quoteId` (string, required): Quote id.
- `signature` (string): EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call.
- `timestamp` (string): From the previous bull_* response. Leave empty on the first call.
- `tokens` (string): New token amount (optional).

### `bull_accept_quote` (~196 tokens)

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.

Input parameters:

- `address` (string, required): Your wallet address (the buyer or seller). Required.
- `payAsset` (string): "base" to pay in ETH (default) or "alt" to pay in the stablecoin.
- `quoteId` (string, required): Quote id.
- `signature` (string): EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call.
- `timestamp` (string): From the previous bull_* response. Leave empty on the first call.

### `bull_attach_deal` (~176 tokens)

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.

Input parameters:

- `address` (string, required): Your wallet address (the buyer or seller). Required.
- `dealId` (string, required): Deal number from the DealCreated event.
- `quoteId` (string, required): Quote id.
- `signature` (string): EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call.
- `timestamp` (string): From the previous bull_* response. Leave empty on the first call.

### `bull_deposit_plan` (~166 tokens)

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.

Input parameters:

- `address` (string, required): Your wallet address (the buyer or seller). Required.
- `quoteId` (string, required): Quote id.
- `signature` (string): EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call.
- `timestamp` (string): From the previous bull_* response. Leave empty on the first call.

### `bull_deposit` (~222 tokens)

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.

Input parameters:

- `address` (string, required): Your wallet address (the buyer or seller). Required.
- `fundSig` (string, required): Signature over the `fund` typed data from bull_deposit_plan (the full 65-byte signature).
- `permitDeadline` (string, required): message.deadline from the permit.
- `quoteId` (string, required): Quote id.
- `r` (string, required): Signature r.
- `s` (string, required): Signature s.
- `signature` (string): EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call.
- `timestamp` (string): From the previous bull_* response. Leave empty on the first call.
- `v` (number, required): Signature v.

### `bull_quote_status` (~157 tokens)

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.

Input parameters:

- `address` (string, required): Your wallet address (the buyer or seller). Required.
- `quoteId` (string, required): Quote id.
- `signature` (string): EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call.
- `timestamp` (string): From the previous bull_* response. Leave empty on the first call.

### `bull_reject_quote` (~133 tokens)

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.

Input parameters:

- `address` (string, required): Your wallet address (the buyer or seller). Required.
- `quoteId` (string, required): Quote id.
- `signature` (string): EIP-191 personal_sign of `message` from the previous response. Leave empty on the first call.
- `timestamp` (string): From the previous bull_* response. Leave empty on the first call.

### `bull_get_deal` (~63 tokens)

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.

Input parameters:

- `dealId` (string, required): Deal number from the DealCreated event.

### `bull_get_receipt` (~71 tokens)

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.

Input parameters:

- `dealId` (string, required): Deal number.

### `bull_stats` (~45 tokens)

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` (~56 tokens)

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.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/tmcodingarc-bull-otc/api-mcp#diagnostics

## Score history

- 2026-11-21: 66
- 2026-11-20: 66
- 2026-11-19: 65
- 2026-11-18: 65
- 2026-11-17: 64
- 2026-11-16: 64
- 2026-11-15: 64
- 2026-11-14: 64
- 2026-11-13: 63
- 2026-11-12: 63
- 2026-11-11: 62

## Common questions

### What is the Bull OTC MCP server?

Bull OTC is an MCP server listed in the public MCP registry as io.github.TMcodingarc/bull-otc. Non-custodial RFQ and atomic swap settlement for AI agents. Escrow onchain, signed receipts. This page covers its hosted endpoint (https://www.bull.family/api/mcp).

### Is the Bull OTC MCP server safe to use?

Bull OTC scores 66 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Bull OTC MCP server expose?

Bull OTC exposes 29 tools: bull_consent_plan, bull_consent, bull_settle, bull_settle_steps, bull_stream_create, and 24 more. Their descriptions and schemas cost roughly 5,140 tokens of context every time the server is loaded.

### Does the Bull OTC MCP server require authentication?

No. We connected to Bull OTC without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the Bull OTC MCP server still maintained?

Bull OTC is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What did VerifyMCP test on the Bull OTC MCP server?

VerifyMCP ran 12 checks on Bull OTC, covering TLS certificate, HTTPS, HSTS header, DNSSEC and 8 more. One item could not be completed, a gap on our side rather than a finding about Bull OTC: Authorization. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- Remote endpoint: https://www.bull.family/api/mcp
- Repository: https://github.com/TMcodingarc/bull-family
- Website: https://www.bull.family/
- Changelog RSS feed: https://verifymcp.io/servers/tmcodingarc-bull-otc/api-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/tmcodingarc-bull-otc/api-mcp/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/tmcodingarc-bull-otc/api-mcp.json
- HTML version of this page: https://verifymcp.io/servers/tmcodingarc-bull-otc/api-mcp
