> For the complete documentation index, see [llms.txt](https://docs.bv7x.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bv7x.ai/agentic-commerce/mcp-server.md).

# MCP Server

BV-7X exposes a [Model Context Protocol](https://modelcontextprotocol.io) 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:

```bash
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**:

```json
{
  "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**:

```json
{
  "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**:

```json
{
  "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](/use-the-signal/examples/mcp-claude.md) -- example conversation
* [A2A Protocol](/agentic-commerce/a2a-protocol.md) -- agent-to-agent communication