BPE (Bitcoin Pricing Engine)
Consolidated Bitcoin market data for AI agents: BBO pricing, ML signals, funding skew, briefings.
Open source Open in the app JSON README (API)
About
Consolidated Bitcoin market data for AI agents: BBO pricing, ML signals, funding skew, briefings.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- bxetech
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.2.1
- Last push
- 2026-05-13T17:17:26Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 03:02:33
- Updated
- 2026-08-29 03:02:33
- Origin id
io.github.bxetech/bpe-mcp
README
# BPE MCP Server
Model Context Protocol server for the [BPE](https://bxetech.com) market-data
API. Lets Claude Desktop, Cursor, Goose, and other MCP-enabled agents query
consolidated Bitcoin pricing, ML signals, funding-rate skew, and
natural-language market briefings — without writing any HTTP boilerplate.
> **Status:** v0.2 — five tools, local stdio transport, no LLM
> calls inside the briefing endpoint (template-rendered). API key required.
Listed in the [official MCP Server Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.bxetech/bpe-mcp) as `io.github.bxetech/bpe-mcp`. Install via `npm install -g @bxetech/bpe-mcp` or `npx -y @bxetech/bpe-mcp`.
## Why use it
If you're building an agent that touches Bitcoin markets, you have two
options today:
1. **Talk to 36 different exchange APIs directly.** Each has a different
schema, different auth, different rate limits, different reliability.
Your agent burns tokens reasoning over inconsistent payloads.
2. **Use one consolidated source.** BPE aggregates all 36 venues into a
single normalised feed with derived signals (ML predictions,
sentiment, funding skew, basis). One auth, one schema, one tool call.
This MCP server is option 2 dressed up as native tools your agent can
discover and call.
## Tools (v0.2)
| Tool | What it does |
|---|---|
| `get_consolidated_price` | Current BTC price aggregated across the BPE network |
| `get_market_briefing` | ~4 lines (brief) or 6–8 (detailed) natural-language summary — price, funding skew, ML signal, sentiment, anomalies |
| `get_funding_skew` | Per-venue annualised funding rates + max-spread pair |
| `get_ml_signal` | Current ML prediction (direction, probability, confidence) at the requested horizon |
| `get_sentiment_snapshot` | Crypto Fear & Greed index, news sentiment, mempool stress |
## Install
```bash
npm install -g @bxetech/bpe-mcp
```
Or use `npx` with no install (recommended for Claude Desktop):
```jsonc
// ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"bpe": {
"command": "npx",
"args": ["-y", "@bxetech/bpe-mcp"],
"env": {
"BPE_API_KEY": "bpe_..."
}
}
}
}
```
Restart Claude Desktop. The five tools appear under the MCP server picker.
## Configuration
| Env var | Default | Notes |
|---|---|---|
| `BPE_API_KEY` | *(required)* | Get one at https://bxetech.com/contact |
| `BPE_BASE_URL` | `https://mcp.bxetech.com` | Override for self-hosted / local dev |
| `BPE_TIMEOUT_MS` | `5000` | Per-request timeout |
## Local development
```bash
git clone https://github.com/bxetech/bpe-mcp
cd bpe-mcp
npm install
npm run build
BPE_API_KEY=... npm run dev
```
To dogfood in Claude Desktop while iterating, point at the local build:
```jsonc
{
"mcpServers": {
"bpe-dev": {
"command": "node",
"args": ["/abs/path/to/mcp-server/dist/index.js"],
"env": {
"BPE_API_KEY": "...",
"BPE_BASE_URL": "http://localhost:8082"
}
}
}
}
```
## Roadmap
- **v0.2** — `get_sentiment_snapshot` ✅, friendly tier-aware errors ✅, timestamped briefings ✅
- **v0.3** — `get_basis`, `subscribe_alert` (webhook subscription), hosted HTTP transport for non-developer install (Cursor extension, ChatGPT Desktop)
- **v0.4** — Optional LLM-rendered briefing via Haiku (richer prose, with per-call cost)
See [`docs/research/AGENT_INTEGRATION_AND_MONETISATION_2026-04-27.md`](../docs/research/AGENT_INTEGRATION_AND_MONETISATION_2026-04-27.md) for the broader product / monetisation plan.
## License
MIT — see [`LICENSE`](./LICENSE).