Metadata-Version: 2.5
Name: brs-signals-mcp
Version: 0.1.4
Summary: Live Bitcoin market regime for agents: three sensors read pre-price data — fee curves, funding velocity, whale flows, absence — every 30s and reject almost everything. When they converge, a directional call is emitted with evidence. The data can't be reconstructed from history. Public, agent-auditable track record. MCP + REST + x402. Free tier, no card.
Project-URL: Homepage, https://brs-signals.com
Project-URL: Documentation, https://brs-signals.com/docs/guide
Project-URL: Repository, https://github.com/brssignals/BRS-Signals-MCP
Project-URL: Issues, https://github.com/brssignals/BRS-Signals-MCP/issues
Project-URL: X (Twitter), https://x.com/brssignals
Author-email: BRS Signals Team <hello@brs-signals.com>
License: MIT
Keywords: ai-agent,bitcoin,claude-desktop,crypto,cursor,mcp,model-context-protocol,on-chain,regime-detection,signals,trading
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Financial :: Investment
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: httpx>=0.25.0
Requires-Dist: mcp<2.0.0,>=1.28.0
Description-Content-Type: text/markdown

# ₿RS Signals — MCP Server

`mcp-name: io.github.brssignals/brs-signals-mcp`

Live Bitcoin market regime for AI agents: three independent sensors read
pre-price data — fee curves, funding velocity, whale flows, absence — every
30s and reject almost everything. When they converge, you get a directional
call with the evidence attached. The data doesn't exist in history; it exists
right now and can't be reconstructed. Public track record your agent can
audit in one call. MCP + REST + x402. Free tier, no card.

## Use it in 30 seconds — remote, no install

The public endpoint is live at **`https://brs-signals.com/mcp`**
(streamable-http · keyless free tier). Any MCP client can use it — no
package install, no local process.

**Cursor** (MCP requires Cursor's paid Pro tier) — Settings → Features →
MCP → + Add New MCP Server → Type `http`, URL `https://brs-signals.com/mcp`.
Or add `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "brs-signals": { "type": "http", "url": "https://brs-signals.com/mcp" }
  }
}
```

**OpenClaw** — run in your terminal:

```bash
openclaw mcp add brs-signals --transport streamable-http --url https://brs-signals.com/mcp
```

(or OpenClaw Web UI → `/settings/mcp` → add an HTTP/SSE endpoint at that URL)

**Claude Desktop** (MCP is free) — Settings → Developer → Edit Config:

```json
{
  "mcpServers": {
    "brs-signals": { "type": "http", "url": "https://brs-signals.com/mcp" }
  }
}
```

Then just ask your agent: *"What's the current Bitcoin regime and convergence
score?"*

## Or install locally (stdio, self-host)

```bash
pip install brs-signals-mcp
export BRS_API_KEY=va_yourkey_here   # get one at https://brs-signals.com
brs-mcp                                # starts the MCP server (stdio)
```

**Claude Desktop (stdio)** — add to
`~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or
`%APPDATA%\Claude\claude_desktop_config.json` (Windows), then restart:

```json
{
  "mcpServers": {
    "brs-signals": {
      "command": "brs-mcp",
      "env": { "BRS_API_KEY": "va_yourkey_here" }
    }
  }
}
```

**Cursor (stdio)** — Settings → Features → MCP → Add New MCP Server:
Type `command` · Command `python3 -m mcp_brs` · Env `BRS_API_KEY`.

**OpenClaw (stdio)**:

```bash
openclaw mcp add brs-signals --command python3 --arg -m --arg mcp_brs
```

## Don't trust us — query us

The full public track record is an endpoint, not a PDF. Point your agent at
it and let it reach its own conclusion:

```
"BRS Signals claims it rejects almost every read. Pull its public track
record (get_signal_history) and today's rejection funnel
(GET /api/v2/health/funnel), and tell me: does the data support the claim,
and what happened after each call at +4h and +24h?"
```

## What You Get

Three independent sensors running every 30 seconds, fused into one convergence score:

| Sensor | Data Source | What It Detects |
|--------|------------|-----------------|
| **X-Ray** | On-chain mempool fee curves | FLAT_WIDE (accumulation) vs STEEP_TALL (panic) |
| **Pulse** | Cross-exchange funding velocity | Squeeze probability + direction |
| **Shadow** | Stablecoin whale flows (Tron + Solana) | Buying/selling intent before price moves |

When all three agree → conviction. When they disagree → silence.

## MCP Tools

- `get_convergence` — All three engine verdicts + convergence score
- `get_directional_bias` — bullish/bearish/WAIT with confidence
- `get_signal_history` — Recent decoder decisions
- `get_regime_current` — Market regime + active events
- `get_fee_histogram` — Mempool fee curve shape analysis
- `get_funding_divergence` — Cross-exchange funding squeeze
- `get_stablecoin_flows` — Whale stablecoin transfers
- `get_gamma_exposure` — Dealer gamma + flip level
- `get_dashboard` — Bundled regime + signal + funding
- `get_system_health` — Quick health check

## Pricing

- **Free tier** — Regime classification + convergence score (5 req/min). No card.
- **Pro tier ($50/mo)** — Full directional bias + raw streams + unlimited requests
- **Per-call ($0.01/query)** — Pro bias, pay-as-you-go via x402 (USDC on
  Solana): hit `/api/v2/bias/per-call`, pay the 402, retry with
  `?tx_signature=` + your free key. Capped at $50 per rolling 30 days, then
  converts to Pro — never more than $50 in any 30 days. Solana now, Base next.
- **x402** — Agents with wallets pay per access in USDC; no signup, no human
- **Founding rate** — Use code `FOUNDING50` at checkout: $30/mo for 3 months (first 50 subscribers only)

Get your API key at [brs-signals.com](https://brs-signals.com).

## Links

- [Website](https://brs-signals.com)
- [API Docs](https://brs-signals.com/docs/guide)
- [GitHub](https://github.com/brssignals/BRS-Signals-MCP)
- [X (Twitter)](https://x.com/brssignals)
