@bxetech/bpe-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BXETECH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,105 @@
+# 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.1 prototype. Four tools, local stdio transport, no LLM
+> calls inside the briefing endpoint (template-rendered). API key required.
+
+## 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.1)
+
+| Tool | What it does |
+|---|---|
+| `get_consolidated_price` | Current BTC price aggregated across the BPE network |
+| `get_market_briefing` | 5–8 line natural-language market summary (price, funding, ML, sentiment, anomalies) |
+| `get_funding_skew` | Per-venue annualised funding rates + max-spread pair |
+| `get_ml_signal` | Current ML prediction across configurable time horizons |
+
+## 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 four 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_basis`, `get_sentiment_snapshot`, `subscribe_alert` (webhook subscription)
+- **v0.3** — 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).

package/SECURITY.md

@@ -0,0 +1,67 @@
+# Security Policy
+
+## Reporting a vulnerability
+
+If you believe you have found a security vulnerability in this MCP
+server, **please do not open a public GitHub issue.** Instead, report it
+privately so we can investigate and ship a fix before details become
+public.
+
+**Preferred channel:** GitHub Security Advisory — open a draft advisory
+on this repository under the *Security* tab → *Advisories* → *Report a
+vulnerability*. This routes the report directly to the maintainers and
+is invisible to anyone else until we publish.
+
+**Alternative:** email <security@bxetech.com> with a description of the
+issue and steps to reproduce. PGP encryption available on request.
+
+## Scope
+
+In scope:
+
+- This npm package (`@bxetech/bpe-mcp`) and its installation flow.
+- The protocol-level interaction between the MCP server and any
+  upstream BPE API endpoints it calls on behalf of the user.
+- API-key handling on the local machine where the MCP server runs.
+
+Out of scope (handled separately):
+
+- The BPE API itself (`api.bxetech.com`) — report at
+  <security@bxetech.com> with subject prefix `[BPE API]`.
+- The BXETECH website (`bxetech.com`) — same address, prefix
+  `[BXETECH website]`.
+- Issues affecting Anthropic's Claude Desktop, Cursor, or other MCP
+  clients themselves — report to those vendors directly.
+
+## What we ask
+
+- Provide enough detail for us to reproduce the issue.
+- Don't exploit the vulnerability beyond what is needed to demonstrate
+  it.
+- Don't access, modify, or delete data belonging to other BPE API
+  customers.
+- Give us reasonable time to fix the issue before public disclosure
+  (typically 90 days, faster for critical issues).
+
+## What you can expect
+
+- Acknowledgement within 3 business days.
+- A status update within 10 business days, including whether the issue
+  is accepted, deferred, or out of scope.
+- Credit in the release notes when a fix ships, unless you'd prefer to
+  remain anonymous.
+
+## Known limitations
+
+The v0.1 release does not currently:
+
+- Validate webhook subscription URLs against SSRF (the
+  `subscribe_alert` tool ships in v0.2; SSRF protections will land at
+  the same time).
+- Encrypt API keys at rest within MCP client config files (this is a
+  property of the host MCP client, e.g. Claude Desktop, not of this
+  package).
+
+These are tracked publicly in the issue tracker and in the
+[`AGENT_INTEGRATION_AND_MONETISATION_2026-04-27.md`](https://bxetech.com/agents)
+research note.

package/SKILL.md

@@ -0,0 +1,121 @@
+---
+name: bpe-market-intelligence
+version: 0.1.0
+description: Cross-venue Bitcoin market intelligence — consolidated pricing, ML signals, funding-rate skew, sentiment, and natural-language briefings across 36 exchanges. Companion to single-exchange MCPs.
+homepage: https://bxetech.com/agents
+license: MIT
+---
+
+# BPE Market Intelligence
+
+A skill for AI agents that need to reason about Bitcoin markets across
+venues. Pairs naturally with single-exchange MCP servers (Bybit,
+Coinbase, Gemini, Kraken, OKX) — those handle execution on one venue;
+BPE handles cross-venue intelligence.
+
+## When to use this skill
+
+Reach for BPE tools when the agent's task involves any of:
+
+- **"What's BTC doing right now?"** → call `get_market_briefing` first.
+  One call replaces dozens of raw-data calls plus the synthesis work.
+- **Spread / arbitrage / basis questions** → `get_funding_skew` for
+  perp-perp; the briefing endpoint surfaces consolidated-vs-venue
+  divergence.
+- **Directional questions** ("is the market bullish?", "should I expect
+  mean-reversion?") → `get_ml_signal` returns calibrated probability,
+  not just direction.
+- **Reconciling a position against the broader market** → if the user
+  is on a single exchange and asks why their P&L looks the way it does,
+  cross-check the venue's price against `get_consolidated_price`.
+- **Anomaly detection** → the briefing's anomaly hint flags extreme
+  funding spreads or high ML confidence regimes worth investigating.
+
+## When NOT to use this skill
+
+- **Order routing, fills, balances, withdrawals** → use the user's
+  exchange MCP (Bybit, Coinbase, etc.). BPE is read-only and has
+  no execution surface.
+- **Exchange-specific account state** ("what's my Bybit balance?") →
+  exchange MCP, not BPE. We don't have visibility into user accounts.
+- **Wallet operations, signing, on-chain** → not this skill.
+
+## Recommended call patterns
+
+### Pattern 1 — orient before drilling down
+
+For open-ended market questions, **always call `get_market_briefing`
+first**. It costs ~1 rate-limit token and ~50 tokens of context, and
+gives the agent enough situational awareness to decide what (if
+anything) to drill into next. Avoid making the agent assemble a
+briefing from individual `get_consolidated_price` / `get_funding_skew`
+/ `get_ml_signal` calls — that's slower, more expensive, and what
+the briefing endpoint exists to prevent.
+
+### Pattern 2 — confidence-gated decision-making
+
+`get_ml_signal` returns calibrated probabilities. Confidence is on a
+0–1 scale where:
+
+- **< 0.55** — treat as noise. The model has a slight edge but not
+  enough to justify a thesis.
+- **0.55–0.70** — directionally interesting. Worth combining with other
+  signals (funding skew, sentiment, regime) before acting.
+- **> 0.70** — high-conviction. Surfaced as an anomaly in the briefing.
+- **> 0.85** — rare; the model is unusually confident. Worth flagging
+  to the user explicitly.
+
+Don't treat confidence as binary. Don't translate "up" / "down" into
+trade signals without considering the magnitude.
+
+### Pattern 3 — companion to an exchange MCP
+
+When the user has both an exchange MCP and BPE installed:
+
+- Use **the exchange MCP** for: order placement, account state, fills,
+  balance queries, withdrawals.
+- Use **BPE** for: pre-trade context (is the market right for this
+  trade?), post-trade reconciliation (did my venue's price match
+  consensus?), strategy ideation (where's funding cheapest?).
+- **Never confuse the two.** A BPE call that reads `get_consolidated_price`
+  doesn't reflect the price the user can actually execute at on their
+  venue. Use the exchange MCP's order-book or quote tools for that.
+
+## Tool reference
+
+| Tool | Use when | Cost |
+|---|---|---|
+| `get_market_briefing` | Default first call for any open-ended market question | 1 rate-limit token |
+| `get_consolidated_price` | "What's BTC at right now?" | 1 token |
+| `get_funding_skew` | Perp-perp arb, basis trade ideation, positioning skew analysis | 1 token |
+| `get_ml_signal` | Directional questions, regime detection | 1 token |
+
+All tools return text content blocks designed for direct consumption
+by the LLM. No JSON parsing required.
+
+## Available time horizons
+
+`get_ml_signal` accepts `30s`, `60s`, `5m`. Available horizons may
+evolve over time — if the agent receives an "available horizons"
+error, it should retry with one of the listed alternatives.
+
+## Limitations to surface to the user
+
+- **Read-only.** BPE cannot place orders, manage positions, or move
+  funds. If the user asks the agent to act on a signal, route through
+  their exchange MCP.
+- **BTC-only in v0.1.** ETH, SOL, and other assets are out of scope.
+  If the user asks about another asset, say so plainly.
+- **ML signal is a probability, not a guarantee.** The model is well-
+  calibrated but markets remain noisy. Frame predictions as "the model
+  thinks X is more likely than Y", not "X will happen".
+
+## Background
+
+BPE (Bitcoin Pricing Engine) consolidates 36 exchanges into a single
+normalised market-data feed with sub-100µs internal latency, plus
+derived intelligence layers: a calibrated gradient-boosted ML model
+trained on a broad engineered feature set, sentiment indicators
+(Fear & Greed, news, mempool stress), and cross-venue funding /
+basis analysis. Running in production for institutional users; the
+MCP server exposes this as native agent tools.

package/dist/briefing.d.ts

@@ -0,0 +1,3 @@
+import type { BpeClient } from "./client.js";
+export type BriefingVerbosity = "brief" | "detailed";
+export declare function buildBriefing(client: BpeClient, verbosity: BriefingVerbosity): Promise<string>;

package/dist/briefing.js

@@ -0,0 +1,137 @@
+// Briefing endpoint synthesiser.
+//
+// v0.1 strategy: call the api-gateway's bundled /briefing endpoint, which
+// returns price + derivatives + predictions + sentiment in a single
+// envelope. Fold into a deterministic natural-language template. No LLM
+// involved — that's a v0.2 upgrade if we want richer summaries.
+//
+// Why deterministic first:
+//  - zero per-call cost, no LLM dependency
+//  - predictable output shape (easier for downstream agents to parse)
+//  - we can A/B against an LLM-rendered version later
+//
+// Why the bundled endpoint vs 4 separate calls:
+//  - 1 rate-limit token per briefing (was 4)
+//  - 1 HTTP round-trip (was 4)
+//  - server filters by tier permissions, so Free callers receive a
+//    partial bundle (graceful degradation) rather than 4× 403s
+//  - underlying channels are read from the gateway's in-memory cache,
+//    so freshness is identical to the per-channel endpoints
+export async function buildBriefing(client, verbosity) {
+    // Single bundled call — replaces the 4-channel fan-out.
+    let bundle;
+    try {
+        bundle = await client.get("briefing");
+    }
+    catch {
+        bundle = {};
+    }
+    // Re-pack as Promise.allSettled-shaped results so the rest of the
+    // synthesis code can stay unchanged.
+    const wrap = (v) => v != null
+        ? { status: "fulfilled", value: v }
+        : { status: "rejected", reason: new Error("not in bundle") };
+    const price = wrap(bundle.price);
+    const derivs = wrap(bundle.derivatives);
+    const preds = wrap(bundle.predictions);
+    const sent = wrap(bundle.sentiment);
+    const lines = [];
+    // Price line
+    if (price.status === "fulfilled" && price.value?.price) {
+        const p = price.value;
+        const venues = p.exchange_count ?? "?";
+        const ageMs = p.timestamp_ms != null ? Math.max(0, Date.now() - p.timestamp_ms) : null;
+        const ageStr = ageMs == null ? "fresh" : ageMs < 1000 ? `${ageMs} ms old` : `${(ageMs / 1000).toFixed(1)}s old`;
+        lines.push(`BTC: $${formatPrice(p.price)} (consolidated across ${venues} exchanges, ${ageStr}).`);
+    }
+    else {
+        lines.push("BTC price: unavailable.");
+    }
+    // Funding skew
+    if (derivs.status === "fulfilled" && derivs.value?.funding_rates?.length) {
+        const rates = derivs.value.funding_rates
+            .filter((r) => Number.isFinite(r.annualized_rate ?? r.funding_rate * 3 * 365))
+            .map((r) => ({
+            ex: r.exchange,
+            ann: r.annualized_rate ?? r.funding_rate * 3 * 365,
+        }));
+        if (rates.length >= 2) {
+            rates.sort((a, b) => b.ann - a.ann);
+            const top = rates[0];
+            const bot = rates[rates.length - 1];
+            const spread = top.ann - bot.ann;
+            lines.push(`Funding skew: ${top.ex} ${formatPct(top.ann)} APR vs ${bot.ex} ${formatPct(bot.ann)} APR — spread ${formatPct(spread)} APR.`);
+            if (verbosity === "detailed") {
+                const detail = rates
+                    .slice(0, 6)
+                    .map((r) => `${r.ex} ${formatPct(r.ann)}`)
+                    .join(", ");
+                lines.push(`  All venues: ${detail}.`);
+            }
+        }
+    }
+    // ML signal — server returns a single prediction snapshot (whichever
+    // horizon the upstream pricing-service most recently emitted).
+    if (preds.status === "fulfilled" && preds.value?.direction) {
+        const p = preds.value;
+        const horizon = p.horizon_secs != null ? `${p.horizon_secs}s` : "?";
+        const conf = p.confidence != null ? ` (${(p.confidence * 100).toFixed(0)}% confidence)` : "";
+        const prob = p.probability != null ? `, p=${(p.probability * 100).toFixed(0)}%` : "";
+        lines.push(`ML ${horizon}: ${p.direction}${conf}${prob}.`);
+        if (verbosity === "detailed" && p.models?.length) {
+            const detail = p.models
+                .map((m) => `${m.name}${m.signal != null ? `=${m.signal.toFixed(3)}` : ""}`)
+                .join(", ");
+            lines.push(`  Sub-models: ${detail}.`);
+        }
+    }
+    // Sentiment
+    if (sent.status === "fulfilled") {
+        const s = sent.value;
+        const parts = [];
+        if (s?.fear_greed_index != null) {
+            parts.push(`F&G ${s.fear_greed_index}${s.fear_greed_label ? ` (${s.fear_greed_label})` : ""}`);
+        }
+        if (s?.news_sentiment != null)
+            parts.push(`news ${s.news_sentiment.toFixed(2)}`);
+        if (s?.mempool_stress != null)
+            parts.push(`mempool ${s.mempool_stress.toFixed(2)}`);
+        if (parts.length)
+            lines.push(`Sentiment: ${parts.join(", ")}.`);
+    }
+    // Anomaly hint — only thing computed locally (over the data we just pulled)
+    const anomaly = detectAnomaly(derivs, preds);
+    if (anomaly)
+        lines.push(`Anomaly: ${anomaly}`);
+    return lines.join("\n");
+}
+// Cheap heuristics — flag obvious abnormalities so the agent doesn't have to
+// reason them out.
+function detectAnomaly(derivs, preds) {
+    if (derivs.status === "fulfilled" && derivs.value?.funding_rates) {
+        const ann = derivs.value.funding_rates
+            .map((r) => r.annualized_rate ?? r.funding_rate * 3 * 365)
+            .filter((x) => Number.isFinite(x));
+        const max = ann.length ? Math.max(...ann) : 0;
+        const min = ann.length ? Math.min(...ann) : 0;
+        if (max - min > 0.25)
+            return `funding spread ${formatPct(max - min)} APR (>25% — basis or perp-perp arb opportunity).`;
+        if (Math.abs(max) > 0.5)
+            return `extreme funding ${formatPct(max)} APR — perp positioning stretched.`;
+    }
+    if (preds.status === "fulfilled" && preds.value?.direction) {
+        const p = preds.value;
+        if ((p.confidence ?? 0) > 0.85) {
+            const horizon = p.horizon_secs != null ? `${p.horizon_secs}s` : "current";
+            return `ML confidence ${(p.confidence * 100).toFixed(0)}% on ${horizon} horizon (${p.direction}).`;
+        }
+    }
+    return null;
+}
+function formatPrice(n) {
+    return n >= 1000 ? n.toLocaleString("en-US", { maximumFractionDigits: 0 }) : n.toFixed(2);
+}
+function formatPct(frac) {
+    return `${(frac * 100).toFixed(2)}%`;
+}
+//# sourceMappingURL=briefing.js.map

package/dist/briefing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"briefing.js","sourceRoot":"","sources":["../src/briefing.ts"],"names":[],"mappings":"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"}

package/dist/client.d.ts

@@ -0,0 +1,65 @@
+export declare class BpeApiError extends Error {
+    readonly status?: number | undefined;
+    readonly endpoint?: string | undefined;
+    constructor(message: string, status?: number | undefined, endpoint?: string | undefined);
+}
+export declare class BpeClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly timeoutMs;
+    constructor(opts: {
+        baseUrl?: string;
+        apiKey: string;
+        timeoutMs?: number;
+    });
+    get<T = unknown>(path: string): Promise<T>;
+}
+export interface PriceResponse {
+    price: number;
+    best_bid?: number;
+    best_ask?: number;
+    spread_bps?: number;
+    confidence?: number;
+    exchange_count?: number;
+    sequence?: number;
+    timestamp_ms?: number;
+    symbol?: string;
+}
+export interface FundingRateEntry {
+    exchange: string;
+    funding_rate: number;
+    next_funding_time?: number;
+    annualized_rate?: number;
+}
+export interface DerivativesResponse {
+    funding_rates?: FundingRateEntry[];
+    open_interest?: Array<{
+        exchange: string;
+        oi_btc: number;
+        oi_usd?: number;
+    }>;
+    timestamp_ms?: number;
+}
+export interface PredictionsResponse {
+    horizon_secs?: number;
+    direction?: "up" | "down" | "flat";
+    probability?: number;
+    confidence?: number;
+    signal?: number;
+    risk_adjusted_signal?: number;
+    position_scale?: number;
+    volatility_forecast?: number;
+    models?: Array<{
+        name: string;
+        signal?: number;
+        confidence?: number;
+    }>;
+    timestamp_ms?: number;
+}
+export interface SentimentResponse {
+    fear_greed_index?: number;
+    fear_greed_label?: string;
+    news_sentiment?: number;
+    mempool_stress?: number;
+    timestamp_ms?: number;
+}

package/dist/client.js

@@ -0,0 +1,68 @@
+// Thin HTTP client for the BPE api-gateway. One file, no class hierarchy —
+// each tool calls the channel it needs.
+//
+// Backend lives at the api-gateway (port 8082 in dev, https://mcp.bxetech.com
+// in prod). Auth is an `X-API-Key` header — same key the dashboard / portal
+// uses, supplied by the user via env or MCP server config.
+//
+// Why mcp.bxetech.com (not api.bxetech.com): the agent-facing endpoint is
+// brand-separated from the (future) human-facing API SKU. Same backend
+// today; lets us diverge later (dedicated MCP-shaped service, different
+// rate-limit policy, etc.) without forcing customers to migrate.
+const DEFAULT_BASE_URL = "https://mcp.bxetech.com";
+export class BpeApiError extends Error {
+    status;
+    endpoint;
+    constructor(message, status, endpoint) {
+        super(message);
+        this.status = status;
+        this.endpoint = endpoint;
+        this.name = "BpeApiError";
+    }
+}
+export class BpeClient {
+    baseUrl;
+    apiKey;
+    timeoutMs;
+    constructor(opts) {
+        this.baseUrl = (opts.baseUrl ?? process.env.BPE_BASE_URL ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+        this.apiKey = opts.apiKey;
+        this.timeoutMs = opts.timeoutMs ?? 5_000;
+    }
+    // GET /api/v1/<path>. Returns the unwrapped `data` payload from the
+    // gateway's ApiEnvelope ({channel, seq, timestamp, snapshot, data}).
+    // Throws BpeApiError on non-2xx, network failure, or timeout.
+    async get(path) {
+        const url = `${this.baseUrl}/api/v1/${path.replace(/^\//, "")}`;
+        const ctrl = new AbortController();
+        const timer = setTimeout(() => ctrl.abort(), this.timeoutMs);
+        try {
+            const res = await fetch(url, {
+                method: "GET",
+                headers: { "X-API-Key": this.apiKey, Accept: "application/json" },
+                signal: ctrl.signal,
+            });
+            if (!res.ok) {
+                const body = await res.text().catch(() => "");
+                throw new BpeApiError(`BPE API ${res.status} on /${path}: ${body.slice(0, 200)}`, res.status, path);
+            }
+            const json = (await res.json());
+            // Every gateway endpoint wraps in an ApiEnvelope. Unwrap `data` so
+            // callers receive the channel-specific payload directly.
+            if (json && typeof json === "object" && "data" in json) {
+                return json.data;
+            }
+            return json;
+        }
+        catch (err) {
+            if (err instanceof BpeApiError)
+                throw err;
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new BpeApiError(`BPE API request failed on /${path}: ${msg}`, undefined, path);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+// BPE MCP server — entry point.
+//
+// Boots a stdio-transport MCP server that exposes the BPE market-data API
+// to MCP-enabled agents (Claude Desktop, Cursor, Goose, etc.). All real
+// work happens in tools.ts; this file just wires transport + lifecycle.
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { BpeClient } from "./client.js";
+import { registerTools } from "./tools.js";
+async function main() {
+    const apiKey = process.env.BPE_API_KEY;
+    if (!apiKey) {
+        // We can't write to stdout (it's the MCP transport), so log to stderr —
+        // Claude Desktop surfaces stderr in the MCP server logs panel.
+        process.stderr.write("Error: BPE_API_KEY environment variable is required.\n" +
+            "Get a key at https://bxetech.com/contact and set it in your\n" +
+            "MCP server config under `env.BPE_API_KEY`.\n");
+        process.exit(1);
+    }
+    const client = new BpeClient({
+        apiKey,
+        baseUrl: process.env.BPE_BASE_URL,
+        timeoutMs: process.env.BPE_TIMEOUT_MS ? Number(process.env.BPE_TIMEOUT_MS) : undefined,
+    });
+    const server = new McpServer({ name: "bpe", version: "0.1.0" }, { capabilities: { tools: {} } });
+    registerTools(server, client);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Don't log on successful boot — Claude Desktop only shows stderr if it
+    // looks like an error, and a routine "started" line trips false-positive
+    // warnings in the UI.
+}
+main().catch((err) => {
+    process.stderr.write(`bpe-mcp fatal: ${err instanceof Error ? err.stack ?? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,gCAAgC;AAChC,EAAE;AACF,0EAA0E;AAC1E,wEAAwE;AACxE,wEAAwE;AAExE,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IACvC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,wEAAwE;QACxE,+DAA+D;QAC/D,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,wDAAwD;YACtD,+DAA+D;YAC/D,8CAA8C,CACjD,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,MAAM;QACN,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY;QACjC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS;KACvF,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EACjC,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;IAEF,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,wEAAwE;IACxE,yEAAyE;IACzE,sBAAsB;AACxB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1G,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type BpeClient } from "./client.js";
+export declare function registerTools(server: McpServer, client: BpeClient): void;

package/dist/tools.js

@@ -0,0 +1,151 @@
+// MCP tool registrations.
+//
+// v0.1 ships 4 tools (functions 1, 2, 3, 5 from the research note's §3.1):
+//   get_consolidated_price — current consolidated BTC price
+//   get_market_briefing    — natural-language synthesis of 4 channels
+//   get_funding_skew       — cross-venue funding rates + max-spread pair
+//   get_ml_signal          — current ML prediction for a given horizon
+//
+// Stretch (v0.2): get_basis, get_sentiment_snapshot, subscribe_alert.
+import { z } from "zod";
+import { buildBriefing } from "./briefing.js";
+// All tools return a single text content block. Returning structured JSON
+// would also work, but text is the most agent-portable shape — every model
+// handles it natively, and we can always graduate to structured output later.
+function asText(text) {
+    return { content: [{ type: "text", text }] };
+}
+function asError(text) {
+    return { content: [{ type: "text", text }], isError: true };
+}
+export function registerTools(server, client) {
+    // ── 1. get_consolidated_price ────────────────────────────────────────────
+    server.tool("get_consolidated_price", "Get the current consolidated Bitcoin price aggregated across the BPE exchange network. Returns price in USD, the number of contributing exchanges, and freshness in milliseconds. Use this when an agent or user asks 'what's the BTC price right now?' — it's faster and more authoritative than calling any individual exchange.", {
+        symbol: z
+            .enum(["BTC-USD"])
+            .default("BTC-USD")
+            .describe("Trading pair. Currently only BTC-USD is supported."),
+    }, async ({ symbol }) => {
+        try {
+            const r = await client.get("price");
+            const venues = r.exchange_count ?? "?";
+            const ageMs = r.timestamp_ms != null ? Math.max(0, Date.now() - r.timestamp_ms) : null;
+            const ageStr = ageMs == null ? "n/a" : ageMs < 1000 ? `${ageMs}ms` : `${(ageMs / 1000).toFixed(1)}s`;
+            const lines = [`${symbol}: $${formatPrice(r.price)}`];
+            if (r.best_bid != null && r.best_ask != null) {
+                lines.push(`Bid/Ask: $${formatPrice(r.best_bid)} / $${formatPrice(r.best_ask)}` +
+                    (r.spread_bps != null ? ` (${r.spread_bps.toFixed(1)} bps spread)` : ""));
+            }
+            lines.push(`Source: ${venues} exchanges contributing, ${ageStr} old` +
+                (r.confidence != null ? `, confidence ${(r.confidence * 100).toFixed(0)}%` : "") + ".");
+            return asText(lines.join("\n"));
+        }
+        catch (err) {
+            return asError(`Failed to fetch consolidated price: ${errMsg(err)}`);
+        }
+    });
+    // ── 2. get_market_briefing ───────────────────────────────────────────────
+    server.tool("get_market_briefing", "Get a concise natural-language summary of the current Bitcoin market state. Synthesises consolidated price, funding-rate skew across major perpetual venues, current ML prediction, and sentiment indicators into a 5-8 line briefing. This is the most token-efficient way for an agent to get the 'what's happening right now' picture — replaces 4-5 raw data calls plus the reasoning to summarise them. Set verbosity='detailed' for per-venue funding breakdown and multi-horizon ML signals.", {
+        verbosity: z
+            .enum(["brief", "detailed"])
+            .default("brief")
+            .describe("'brief' returns a 5-line headline summary; 'detailed' adds per-venue and multi-horizon breakdowns."),
+    }, async ({ verbosity }) => {
+        try {
+            const briefing = await buildBriefing(client, verbosity);
+            return asText(briefing);
+        }
+        catch (err) {
+            return asError(`Failed to build market briefing: ${errMsg(err)}`);
+        }
+    });
+    // ── 3. get_funding_skew ──────────────────────────────────────────────────
+    server.tool("get_funding_skew", "Get current perpetual-futures funding rates across major venues, plus the max-spread pair. Annualised. Useful for assessing perp-perp arbitrage conditions, basis trades, and overall positioning skew — high spread = stretched positioning on one side. Returns a sorted table.", {}, async () => {
+        try {
+            const r = await client.get("derivatives");
+            const rates = (r.funding_rates ?? [])
+                .map((f) => ({
+                ex: f.exchange,
+                ann: f.annualized_rate ?? f.funding_rate * 3 * 365,
+            }))
+                .filter((r) => Number.isFinite(r.ann))
+                .sort((a, b) => b.ann - a.ann);
+            if (!rates.length) {
+                return asError("No funding rate data available right now.");
+            }
+            const top = rates[0];
+            const bot = rates[rates.length - 1];
+            const spread = top.ann - bot.ann;
+            const lines = [];
+            lines.push(`Funding spread: ${formatPct(spread)} APR (${top.ex} ↔ ${bot.ex})`);
+            lines.push("");
+            lines.push("Per-venue annualised funding rates:");
+            for (const r of rates) {
+                lines.push(`  ${r.ex.padEnd(20)} ${formatPct(r.ann)}`);
+            }
+            return asText(lines.join("\n"));
+        }
+        catch (err) {
+            return asError(`Failed to fetch funding skew: ${errMsg(err)}`);
+        }
+    });
+    // ── 4. get_ml_signal ─────────────────────────────────────────────────────
+    server.tool("get_ml_signal", "Get the current ML prediction for a specified time horizon. Returns direction (up/down/flat), confidence (0-1), and detected market regime (low/medium/high volatility). The model is a calibrated gradient-boosted classifier trained on a broad feature set including order book imbalance, cross-exchange spreads, sentiment, derivatives, and momentum.", {
+        horizon: z
+            .enum(["30s", "60s", "5m"])
+            .default("30s")
+            .describe("Prediction horizon. Shorter horizons are more reactive; longer horizons are more stable. Available horizons may evolve over time — the tool will report which horizons are currently served if a requested one is unavailable."),
+    }, async ({ horizon }) => {
+        try {
+            const requestedSecs = horizon === "30s" ? 30 : horizon === "60s" ? 60 : 300;
+            const r = await client.get("predictions");
+            if (r.direction == null && r.signal == null) {
+                return asError("No ML prediction currently available — try again in a few seconds.");
+            }
+            const lines = [];
+            const servedSecs = r.horizon_secs ?? null;
+            if (servedSecs != null && servedSecs !== requestedSecs) {
+                lines.push(`Note: requested ${horizon} horizon, server returned ${servedSecs}s (only one horizon is cached at a time in v0.1).`);
+            }
+            lines.push(`Horizon: ${servedSecs != null ? servedSecs + "s" : horizon}`);
+            if (r.direction)
+                lines.push(`Direction: ${r.direction}`);
+            if (r.probability != null) {
+                lines.push(`Probability: ${(r.probability * 100).toFixed(1)}%`);
+            }
+            if (r.confidence != null) {
+                lines.push(`Confidence: ${(r.confidence * 100).toFixed(1)}%`);
+            }
+            if (r.signal != null)
+                lines.push(`Signal: ${r.signal.toFixed(4)}`);
+            if (r.risk_adjusted_signal != null) {
+                lines.push(`Risk-adjusted signal: ${r.risk_adjusted_signal.toFixed(4)}`);
+            }
+            if (r.position_scale != null) {
+                lines.push(`Position scale: ${r.position_scale.toFixed(2)}`);
+            }
+            if (r.volatility_forecast != null) {
+                lines.push(`Volatility forecast: ${r.volatility_forecast.toFixed(4)}`);
+            }
+            if (r.models?.length) {
+                const summaries = r.models.map((m) => `${m.name}=${m.signal != null ? m.signal.toFixed(3) : "?"}` +
+                    (m.confidence != null ? `@${(m.confidence * 100).toFixed(0)}%` : ""));
+                lines.push(`Sub-models: ${summaries.join(", ")}`);
+            }
+            return asText(lines.join("\n"));
+        }
+        catch (err) {
+            return asError(`Failed to fetch ML signal: ${errMsg(err)}`);
+        }
+    });
+}
+function formatPrice(n) {
+    return n >= 1000 ? n.toLocaleString("en-US", { maximumFractionDigits: 0 }) : n.toFixed(2);
+}
+function formatPct(frac) {
+    return `${(frac * 100).toFixed(2)}%`;
+}
+function errMsg(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@bxetech/bpe-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for the BPE (Bitcoin Pricing Engine) market-data API. Lets Claude Desktop, Cursor, and other MCP-enabled agents query consolidated BTC pricing, ML signals, funding-rate skew, and natural-language market briefings.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "bpe-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "SECURITY.md",
+    "SKILL.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "prepare": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "bitcoin",
+    "market-data",
+    "bxetech",
+    "claude",
+    "ai-agents"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bxetech/bpe-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/bxetech/bpe-mcp/issues"
+  },
+  "homepage": "https://bxetech.com/agents"
+}