BASTION
Risk Intelligence MCP Server for Crypto Agents
75.4% Win Rate | 147 Tools | 560+ Signals | 72B Parameter AI | 5 Exchanges
Quick Start · Features · Architecture · Examples · Docs
Platform • Agents Hub • Developers • Get API Key
[!IMPORTANT] Zero install required. BASTION is a cloud-hosted MCP server. Connect with one command and your Claude agent instantly gets 147 real-time crypto tools. No dependencies, no Docker, no API wrappers.
What is BASTION?
BASTION is a Model Context Protocol (MCP) server that turns any Claude agent into a professional crypto trading desk. Through a single MCP connection (Streamable HTTP or SSE), your agent gains 147 specialized tools for market data, derivatives analytics, on-chain intelligence, AI risk evaluation, portfolio management, and autonomous trade execution.
The core engine is a fine-tuned 72B parameter model running on a 4x RTX 5090 GPU cluster, analyzing 560+ real-time signals per evaluation. It doesn't just return data — it returns structured risk assessments with reasoning chains, confidence scores, and explicit action recommendations.
You: "Check my BTC long, I'm worried about the funding spike"
Claude: [Calls bastion_evaluate_risk, bastion_get_funding_rates, bastion_get_liquidations]
Your BTC LONG is at moderate risk (52/100). Here's why:
Funding at 0.035% is elevated but not extreme. However, there's a
$2.1B liquidation cluster at $94,200 — just 3.8% below current price.
OI rose 4.2% without corresponding volume, suggesting overleveraged
longs. CVD is diverging bearish on the 1h.
Recommendation: TP_PARTIAL — Take 50% profit here. Move stop to
breakeven on the remainder.
[!TIP] All market data, derivatives, on-chain, macro, and AI tools work without an API key. You only need a key for portfolio access and trade execution.
Quick Start
Claude Code — One Command
# Streamable HTTP (recommended)
claude mcp add bastion-mcp --transport http https://bastionfi.tech/mcp/stream
# Or legacy SSE
claude mcp add bastion-mcp --transport sse https://bastionfi.tech/mcp/sse
That's it. Restart Claude Code. All 147 tools are live.
Claude Desktop — One Config
Add to claude_desktop_config.json (macOS ~/Library/Application Support/Claude/ · Windows %APPDATA%\Claude\):
{
"mcpServers": {
"bastion": {
"type": "streamable-http",
"url": "https://bastionfi.tech/mcp/stream"
}
}
}
{
"mcpServers": {
"bastion": {
"type": "sse",
"url": "https://bastionfi.tech/mcp/sse"
}
}
}
Python MCP Client
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client
# Streamable HTTP (recommended)
async with streamablehttp_client("https://bastionfi.tech/mcp/stream") as (read, write, _):
async with ClientSession(read, write) as session:
await session.initialize()
result = await session.call_tool("bastion_evaluate_risk", {
"symbol": "BTC",
"direction": "LONG",
"entry_price": 96200.0,
"current_price": 98400.0,
"leverage": 5,
"stop_loss": 94000.0
})
from mcp import ClientSession
from mcp.client.sse import sse_client
async with sse_client("https://bastionfi.tech/mcp/sse") as (read, write):
async with ClientSession(read, write) as session:
await session.initialize()
result = await session.call_tool("bastion_evaluate_risk", {...})
Authenticated Access
For portfolio, trading, and engine tools — pass your key in the URL:
https://bastionfi.tech/mcp/stream?api_key=bst_your_key_here
Get a key at bastionfi.tech/account | Full walkthrough in quickstart.md | Detailed guides in guides/
Features
Key Capabilities
147 Tools Across 35 Categories
STOPPED → engine_start → MONITORING → engine_arm → ARMED (live)
│
engine_disarm
│
MONITORING
The War Room is a shared intelligence feed where multiple Claude agents can post signals, build consensus, and coordinate strategies in real-time.
The nuclear option. Logs market state at kill time for post-mortem review.
Like an NTSB crash report for crypto. Reconstructs exactly what happened.
Your behavioral fingerprint. Maps leverage, symbols, direction bias, streaks, and assigns a personality type.
MCP Resources & Prompts
Architecture
┌─────────────────────────────────────────────────────────────────┐
│ YOUR CLAUDE AGENT │
│ │
│ "Evaluate my BTC long and check whale activity" │
│ │ │
│ ▼ │
│ ┌────────────┐ ┌─────────────┐ ┌───────────────┐ │
│ │ evaluate_ │ │ get_whale_ │ │ get_funding_ │ Claude │
│ │ risk │ │ activity │ │ rates │ picks │
│ └─────┬──────┘ └──────┬──────┘ └──────┬────────┘ tools │
│ │ │ │ │
└────────┼────────────────┼────────────────┼──────────────────────┘
│ │ │
▼ ▼ ▼
┌─────────────────────────────────────────────────────────────────┐
│ MCP PROTOCOL · SSE Transport │
│ https://bastionfi.tech/mcp/sse │
└─────────────────────────────────────────────────────────────────┘
│ │ │
▼ ▼ ▼
┌─────────────────────────────────────────────────────────────────┐
│ BASTION MCP SERVER │
│ │
│ ┌──────────┐ ┌────────────┐ ┌─────────────┐ │
│ │147 Tools │ │ Auth Layer │ │ Rate Limiter│ │
│ │ Router │ │ (bst_ keys)│ │ (4 tiers) │ │
│ └────┬─────┘ └────────────┘ └─────────────┘ │
│ │ │
│ ┌────┴────────────────────────────────────────────────────┐ │
│ │ RISK INTELLIGENCE CORE │ │
│ │ │ │
│ │ ┌────────────┐ ┌────────────┐ ┌──────────────────┐ │ │
│ │ │ 72B AI │ │ Signal │ │ Structure │ │ │
│ │ │ Model │ │ Aggregator│ │ Analyzer │ │ │
│ │ │ (4x 5090) │ │ (560+) │ │ (VPVR, S/R, │ │ │
│ │ │ │ │ │ │ Order Flow) │ │ │
│ │ └────────────┘ └────────────┘ └──────────────────┘ │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
│ │ │
▼ ▼ ▼
┌─────────────────────────────────────────────────────────────────┐
│ DATA SOURCES │
│ │
│ Binance · Bybit · OKX · Bitget · Hyperliquid · CoinGlass │
│ Coinalyze · On-Chain APIs · Whale Alert · ETF Providers │
│ FRED · Polymarket · News Aggregators · Social Sentiment │
└─────────────────────────────────────────────────────────────────┘
Signal Coverage
The risk model ingests 560+ signals per evaluation across 8 categories:
Example Conversations
You: What's the current state of BTC? Give me a quick overview.
Claude: [bastion_get_price] [bastion_get_market_data] [bastion_get_fear_greed]
Bitcoin Overview:
Price: $98,420 (+2.3% 24h)
24h Volume: $48.2B
Market Cap: $1.94T
Dominance: 56.8%
Fear/Greed: 72 (Greed)
BTC is showing strong momentum approaching the $100K psychological
level. Volume is elevated and sentiment is firmly in Greed territory.
You: Check all my positions and evaluate risk.
Claude: [bastion_get_positions] [bastion_evaluate_all_positions]
3 open positions evaluated:
1. BTC/USDT LONG · 5x · Entry $96,200 · Now $98,420 (+2.3%)
Risk: 35/100 (Low) → HOLD
OI rising with price confirms genuine demand.
2. ETH/USDT LONG · 3x · Entry $2,680 · Now $2,645 (-1.3%)
Risk: 55/100 (Moderate) → HOLD with caution
ETH/BTC ratio declining signals relative weakness.
3. SOL/USDT SHORT · 2x · Entry $195.40 · Now $198.20 (-1.4%)
Risk: 68/100 (Elevated) → REDUCE_SIZE
Rising OI + positive CVD + whale accumulation detected.
You: Any funding rate arb opportunities right now?
Claude: [bastion_get_funding_rates] [bastion_get_funding_arb]
Top Opportunity: BTC/USDT
Spread: Bybit vs dYdX = 0.043% per 8h (47.1% annualized)
Strategy:
→ Long on dYdX (collect 0.008%)
→ Short on Bybit (pay 0.035%)
→ Net: Collect spread while delta-neutral
You: What are the whales doing with ETH right now?
Claude: [bastion_get_whale_activity] [bastion_get_exchange_flow]
Whale Activity — ETH (last 24h):
→ 3 large wallets accumulated 12,400 ETH ($32.8M)
→ Exchange outflow exceeds inflow by 8,200 ETH
→ Top 100 wallets increased holdings by 0.3%
Interpretation: Smart money is accumulating. Exchange outflow
suggests coins moving to cold storage (bullish signal).
Authentication
[!NOTE] Higher scopes include all lower scope permissions. An
enginekey has fulltradeandreadaccess.
- Keys transmitted over HTTPS only — TLS encrypted
- Server-side SHA-256 hashing — plaintext keys are never stored
- Instant revocation from the dashboard
- Configurable rate limits per key
- IP restriction support on exchange API keys
- Exchange withdrawal permissions are never required
Agent Patterns
Proven agentic workflows for building with BASTION tools:
Monitor & Alert
bastion_get_positions → Get all open positions
bastion_evaluate_all_positions → Run AI risk on each
[If risk > 70] → Alert user with full analysis
[If risk > 90] → bastion_emergency_exit
Research Pipeline
bastion_get_price → Current price context
bastion_get_open_interest → Derivatives positioning
bastion_get_whale_activity → Smart money flow
bastion_get_fear_greed → Market sentiment
bastion_generate_report → Synthesize into research report
Execution Loop
bastion_evaluate_risk → Get AI recommendation
[EXIT_FULL] → bastion_emergency_exit
[TP_PARTIAL] → bastion_partial_close (50%)
[REDUCE_SIZE] → bastion_partial_close (30%)
[HOLD + near TP] → bastion_set_take_profit
See
workflows/for 6 complete multi-step workflow templates andprompt-templates/for ready-to-use Claude prompt personas.
Rate Limits
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 118
X-RateLimit-Reset: 1708444800
Supported Symbols
Plus 90+ additional pairs with market data and derivatives support.
[!NOTE] Pass symbols without the
/USDTsuffix — use"BTC"not"BTC/USDT".
Comparison
Error Handling
{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded. Retry after 12 seconds.",
"retry_after": 12
}
}
Repository Structure
BASTION-MCP/
├── README.md ← You are here
├── quickstart.md ← 5-minute getting started
├── TOOLS.md ← Complete 147-tool reference
├── mcp-config.json ← Copy-paste MCP config
├── LICENSE ← MIT
├── CONTRIBUTING.md ← How to contribute
├── SECURITY.md ← API key safety & disclosure
├── CHANGELOG.md ← Version history
│
├── .github/
│ ├── ISSUE_TEMPLATE/ ← Bug, feature, example templates
│ ├── PULL_REQUEST_TEMPLATE.md
│ └── FUNDING.yml
│
├── examples/ ← 55 tool examples
│ ├── core-ai/ ← Risk eval, chat, signals (4)
│ ├── market-data/ ← Price, klines, volatility (4)
│ ├── derivatives/ ← OI, CVD, funding, options (12)
│ ├── onchain/ ← Whales, exchange flow (4)
│ ├── macro-sentiment/ ← Fear/greed, ETF, macro (6)
│ ├── portfolio/ ← Positions, balance, engine (7)
│ ├── trading-actions/ ← Exit, TP/SL, breakeven (6)
│ ├── engine-control/ ← Start, arm, disarm (3)
│ ├── research/ ← Reports, position calc (3)
│ ├── resources/ ← MCP resources (3)
│ └── prompts/ ← MCP prompts (3)
│
├── guides/
│ ├── claude-code-setup.md
│ ├── claude-desktop-setup.md
│ └── api-custom-setup.md
│
├── workflows/ ← 6 multi-step workflows
│ ├── morning-briefing.md
│ ├── position-risk-review.md
│ ├── pre-trade-analysis.md
│ ├── risk-engine-setup.md
│ ├── whale-intelligence-sweep.md
│ └── macro-crypto-correlation.md
│
└── prompt-templates/ ← 4 Claude prompt personas
├── market-overview.md
├── risk-check.md
├── trade-setup.md
└── continuous-monitor.md
FAQ
No. BASTION is cloud-hosted. Your Claude client connects via SSE — no Docker, no pip install, no local server.
Claude Code, Claude Desktop, and any custom client built with the MCP Python SDK. Anything that speaks MCP over SSE.
Yes. All market data, derivatives, on-chain, macro, sentiment, and AI tools are free at 30 req/min. You only need a paid key for higher rate limits or portfolio/trading access.
Yes. With a trade-scoped API key and a connected exchange (Binance, Bybit, OKX, Bitget, or Hyperliquid), BASTION can execute exits, partial closes, and TP/SL orders. All actions require explicit Claude agent confirmation.
Backtested at 75.4% combined accuracy across BTC (71.7%), ETH (72.7%), and SOL (81.8%). Extended testing: DOGE 89.6%, LINK 77.8%, ADA 74.5%. The model provides probabilistic assessments with explicit reasoning — not guarantees.
Market data tools: <100ms. AI risk evaluations: 2-5 seconds (full 560+ signal analysis on 4x RTX 5090 cluster). Structure analysis: ~1ms on cache hit, ~700ms on cache miss.
Keys are HTTPS-only, SHA-256 hashed server-side, instantly revocable, and never logged in plaintext. Exchange API keys connected through BASTION are session-encrypted and never stored.
Links
Contributing
We welcome contributions — new examples, workflows, prompt templates, bug reports, and docs improvements.
git clone https://github.com/bastionfintech-spec/bastion-mcp-server.git
cd BASTION-MCP
git checkout -b feature/your-contribution
See CONTRIBUTING.md for file format standards and guidelines.
Disclaimer
BASTION provides market intelligence and risk analysis tools. It does not provide financial advice. Cryptocurrency trading involves substantial risk of loss. Past model performance does not guarantee future results. Always DYOR and never trade with funds you cannot afford to lose.
License
MIT License — See LICENSE for details.
Built for the agentic era.