> 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/use-the-signal/examples/mcp-claude.md).

# MCP + Claude

Use BV-7X tools directly in Claude Code conversations. The MCP server gives Claude access to signals, regimes, attestations, and market data.

***

## Setup

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

```bash
claude mcp add bv7x -- npm run mcp
```

This registers the server in stdio mode. Claude will automatically discover the available tools.

***

## Available Tools

Once connected, Claude has access to:

* `get_signal` -- current oracle signal
* `get_regime` -- market regime classification
* `get_market_data` -- BTC price, Fear & Greed, ETF flows
* `get_scorecard` -- prediction history
* `get_attestation` -- latest on-chain attestation
* `verify_attestation` -- verify a specific attestation by UID
* `get_track_record` -- accuracy statistics
* `get_macro` -- macro correlation data
* `get_copy_trade` -- structured trade intent (Premium)

***

## Example Conversation

**You**: What's the current BV-7X signal?

**Claude** *(uses get\_signal)*:

> The current BV-7X signal is **SELL** with 61.5% confidence. BTC is at $66,027 and the market regime is BEAR\_TREND. The model expects BTC to be lower in 7 days.

***

**You**: What regime are we in and why?

**Claude** *(uses get\_regime)*:

> We're in a **BEAR\_TREND** regime. This is characterized by sustained downtrend with price trading below long-term moving averages. The contributing factors are negative momentum, fear-level sentiment, and elevated volatility.

***

**You**: How accurate has the model been?

**Claude** *(uses get\_track\_record)*:

> The rolling walk-forward accuracy is 63%+ on 7-day BTC direction across 4,500+ settled predictions, with every prediction attested on-chain before the outcome window. Current rolling 30-day accuracy and full history are available via the scorecard API.

***

**You**: Verify the attestation from March 21

**Claude** *(uses verify\_attestation)*:

> The March 21 prediction attestation (UID: 0xabc123...) is verified on-chain. It shows a BUY signal at $64,500 with 62% confidence. The attestation was created at 21:38 UTC on March 21, 7 days before the resolution. The prediction resolved as a WIN -- BTC was at $67,200 on March 28.

***

## Tips

* Claude will automatically choose the right tool based on your question
* You can ask follow-up questions -- Claude maintains context across tool calls
* For Premium tools (`get_copy_trade`), the MCP server needs to be configured with authentication

***

## Remote Agents (SSE)

For cloud-hosted agents, connect via SSE instead of stdio:

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

Pass a bearer token for authenticated access. See [MCP Server](/agentic-commerce/mcp-server.md) for details.

***

## Next

* [MCP Server](/agentic-commerce/mcp-server.md) -- full tool reference
* [A2A Protocol](/agentic-commerce/a2a-protocol.md) -- structured agent communication