MCP Server

BV-7X exposes a Model Context Protocol server with 9 tools. Any MCP-compatible AI agent (Claude, GPT, custom) can query the oracle, check regimes, verify attestations, and more.

---

Transport Modes

Mode	Use Case	Command
stdio	Local agents (Claude Code, desktop apps)	npm run mcp
SSE	Remote agents (web-based, cloud-hosted)	npm run mcp:sse

SSE mode requires Basic tier authentication (500M+ $BV7X).

---

Setup: Claude Code (stdio)

Add the BV-7X MCP server to Claude Code:

claude mcp add bv7x -- npm run mcp

Once added, Claude can use all 9 tools directly in conversation.

---

Setup: Remote Agents (SSE)

Connect via Server-Sent Events:

SSE endpoint: https://bv7x.ai/mcp/sse

Pass your bearer token in the connection headers for authenticated access.

---

Tool Reference

Tool	Description
get_signal	Get the latest BV-7X signal (direction, confidence, regime)
get_regime	Get the current market regime classification
get_market_data	Get BTC price, Fear & Greed, ETF flows
get_scorecard	Get prediction history with win/loss outcomes
get_attestation	Get the latest on-chain attestation
verify_attestation	Verify a specific attestation by UID
get_track_record	Get accuracy statistics (30d, all-time)
get_macro	Get macro correlation data (DXY, S&P 500, ISM)
get_copy_trade	Get structured trade intent (Premium tier)

---

Tool Details

get_signal

Returns the current oracle signal.

Parameters: None

Returns:

{
  "signal": "SELL",
  "confidence": 0.615,
  "direction": "DOWN",
  "btcPrice": 66027,
  "regime": "BEAR_TREND",
  "horizon": "7d"
}

get_regime

Returns the current market regime with contributing factors.

Parameters: None

Returns:

{
  "regime": "BEAR_TREND",
  "riskLevel": "High",
  "description": "Sustained downtrend with price below long-term averages"
}

verify_attestation

Verifies an on-chain prediction attestation.

Parameters:

• uid (string, required) -- The attestation UID to verify

Returns:

{
  "verified": true,
  "date": "2026-03-28",
  "signal": "SELL",
  "direction": "DOWN",
  "easscanUrl": "https://base.easscan.org/attestation/view/0xabc..."
}

---

Authentication

• stdio mode: No authentication needed (runs locally)

• SSE mode: Requires bearer token. Signal direction is gated for unauthenticated connections.

• Premium tools (get_copy_trade): Requires Premium tier (1B+ $BV7X)

---

Next

• MCP + Claude Example -- example conversation

• A2A Protocol -- agent-to-agent communication