Metadata-Version: 2.4
Name: brs-signals-mcp
Version: 0.1.0
Summary: ₿RS Signals MCP Server — Bitcoin regime-switch detection for AI agents
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>=1.0.0
Description-Content-Type: text/markdown

# ₿RS Signals — MCP Server

`pip install brs-signals-mcp` — Bitcoin regime-switch detection for AI agents.

## Quick Start

```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)
```

## Configure Your AI Agent

Add to Claude Desktop, Cursor, or any MCP-compatible agent:

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

## 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)
- **Pro tier ($60/mo)** — Full directional bias + raw streams + unlimited requests

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)
