# Bastion Mcp Server

> Risk Intelligence MCP Server for Crypto Agents | 52 tools, 560+ signals, 72B AI model

- **Type:** MCP server
- **Install:** `agentstack add mcp-bastionfintech-spec-bastion-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [bastionfintech-spec](https://agentstack.voostack.com/s/bastionfintech-spec)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [bastionfintech-spec](https://github.com/bastionfintech-spec)
- **Source:** https://github.com/bastionfintech-spec/bastion-mcp-server
- **Website:** https://bastionfi.tech/agents

## Install

```sh
agentstack add mcp-bastionfintech-spec-bastion-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# BASTION

### Risk Intelligence MCP Server for Crypto Agents

**75.4% Win Rate**  |  **147 Tools**  |  **560+ Signals**  |  **72B Parameter AI**  |  **5 Exchanges**

[](https://modelcontextprotocol.io)
[](https://claude.ai)
[](https://github.com/bastionfintech-spec/bastion-mcp-server/releases)
[](LICENSE)
[](https://github.com/bastionfintech-spec/bastion-mcp-server)

**[Quick Start](#-quick-start)**  ·  **[Features](#-features)**  ·  **[Architecture](#-architecture)**  ·  **[Examples](#-example-conversations)**  ·  **[Docs](https://bastionfi.tech/agents)**

[Platform](https://bastionfi.tech)  •  [Agents Hub](https://bastionfi.tech/agents)  •  [Developers](https://bastionfi.tech/protocol)  •  [Get API Key](https://bastionfi.tech/account)

> [!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

```bash
# 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\`):

```json
{
  "mcpServers": {
    "bastion": {
      "type": "streamable-http",
      "url": "https://bastionfi.tech/mcp/stream"
    }
  }
}
```

Or use legacy SSE transport

```json
{
  "mcpServers": {
    "bastion": {
      "type": "sse",
      "url": "https://bastionfi.tech/mcp/sse"
    }
  }
}
```

### Python MCP Client

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

Legacy SSE client

```python
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](https://bastionfi.tech/account)**  |  Full walkthrough in **[quickstart.md](quickstart.md)**  |  Detailed guides in **[`guides/`](guides/)**

---

## Features

### Key Capabilities

| Capability | Description |
|:---|:---|
| **Risk Intelligence** | 560+ signal evaluation with reasoning chains and action recommendations |
| **Derivatives Analytics** | OI, CVD, funding, liquidation heatmaps, options flow, gamma exposure |
| **On-Chain Intelligence** | Whale tracking, exchange flow, accumulation detection |
| **Macro & Sentiment** | DXY, ETF flows, Fear/Greed, Polymarket, FRED economic data |
| **Market Data** | Real-time price, OHLCV klines, volatility metrics |
| **Portfolio Management** | Multi-exchange positions, balances, alerts, session stats |
| **Trade Execution** | Emergency exits, partial closes, TP/SL, breakeven moves |
| **Autonomous Engine** | Self-monitoring risk engine with armed/disarmed modes |
| **Research Reports** | AI-generated deep analysis reports with position sizing |

### 147 Tools Across 35 Categories

Core AI — 4 tools

| Tool | Description |
|:-----|:------------|
| `bastion_evaluate_risk` | Full risk evaluation with 560+ signals, reasoning chain, and action recommendation |
| `bastion_chat` | Natural language conversation with the fine-tuned 72B risk model |
| `bastion_evaluate_all_positions` | Batch risk evaluation of every open position |
| `bastion_scan_signals` | Proactive signal scanner — finds trade opportunities ranked by conviction |

Market Data — 4 tools

| Tool | Description |
|:-----|:------------|
| `bastion_get_price` | Real-time price, 24h change, volume |
| `bastion_get_market_data` | Market cap, circulating supply, dominance, ATH tracking |
| `bastion_get_klines` | OHLCV candlestick data — any timeframe from 1m to 1M |
| `bastion_get_volatility` | Realized volatility, ATR, Bollinger bandwidth, IV percentile |

Derivatives & Order Flow — 12 tools

| Tool | Description |
|:-----|:------------|
| `bastion_get_open_interest` | Aggregate open interest across all exchanges |
| `bastion_get_oi_changes` | OI delta over time windows (confirms or denies price moves) |
| `bastion_get_cvd` | Cumulative Volume Delta — buyer vs seller aggression |
| `bastion_get_orderflow` | Order flow imbalance and absorption analysis |
| `bastion_get_funding_rates` | Perpetual funding rates across 5 exchanges |
| `bastion_get_funding_arb` | Cross-exchange funding rate arbitrage opportunities |
| `bastion_get_liquidations` | Real-time and aggregate liquidation data |
| `bastion_get_heatmap` | Liquidation heatmap — see where cascading liquidations cluster |
| `bastion_get_taker_ratio` | Taker buy/sell ratio (real-time directional aggression) |
| `bastion_get_top_traders` | Top trader long/short positioning ratios |
| `bastion_get_market_maker_magnet` | Market maker gamma exposure and magnet price levels |
| `bastion_get_options` | Options flow, max pain, put/call ratio, IV skew |

On-Chain & Intelligence — 4 tools

| Tool | Description |
|:-----|:------------|
| `bastion_get_whale_activity` | Large wallet movements, accumulation/distribution patterns |
| `bastion_get_exchange_flow` | Exchange inflow/outflow trends (deposit vs withdrawal) |
| `bastion_get_onchain` | Active addresses, NVT ratio, SOPR, network metrics |
| `bastion_get_news` | AI-curated crypto news feed with sentiment scoring |

Macro & Sentiment — 6 tools

| Tool | Description |
|:-----|:------------|
| `bastion_get_fear_greed` | Crypto Fear & Greed Index with historical context |
| `bastion_get_macro_signals` | DXY, US10Y, SPX correlation, macro regime detection |
| `bastion_get_etf_flows` | Bitcoin & Ethereum spot ETF daily flow data |
| `bastion_get_stablecoin_markets` | Stablecoin supply changes and capital flow analysis |
| `bastion_get_economic_data` | CPI, FOMC, NFP, unemployment — via FRED API |
| `bastion_get_polymarket` | Prediction market odds for crypto-relevant events |

Portfolio — 7 tools

| Tool | Auth | Description |
|:-----|:----:|:------------|
| `bastion_get_positions` | `read` | All open positions across connected exchanges |
| `bastion_get_balance` | `read` | Account balance and margin information |
| `bastion_get_exchanges` | `read` | Connected exchange accounts and status |
| `bastion_engine_status` | `read` | Autonomous engine status and configuration |
| `bastion_engine_history` | `read` | Engine action history and audit log |
| `bastion_get_alerts` | `read` | Active alerts and notifications |
| `bastion_get_session_stats` | `read` | Trading session performance statistics |

Trading Actions — 6 tools

| Tool | Auth | Reversible | Description |
|:-----|:----:|:----------:|:------------|
| `bastion_emergency_exit` | `trade` | No | Close position at market immediately |
| `bastion_partial_close` | `trade` | No | Close a percentage of a position |
| `bastion_set_take_profit` | `trade` | Yes | Set or modify take-profit order |
| `bastion_set_stop_loss` | `trade` | Yes | Set or modify stop-loss order |
| `bastion_move_to_breakeven` | `trade` | Yes | Move stop-loss to entry price |
| `bastion_flatten_winners` | `trade` | No | Close all positions currently in profit |

Engine Control — 3 tools

| Tool | Auth | Description |
|:-----|:----:|:------------|
| `bastion_engine_start` | `engine` | Start the autonomous risk engine |
| `bastion_engine_arm` | `engine` | Arm for live trade execution |
| `bastion_engine_disarm` | `engine` | Disarm to monitor-only mode |

```
STOPPED  →  engine_start  →  MONITORING  →  engine_arm  →  ARMED (live)
                                                              │
                                                        engine_disarm
                                                              │
                                                          MONITORING
```

War Room — 3 tools

| Tool | Auth | Description |
|:-----|:----:|:------------|
| `bastion_war_room_post` | `read` | Post signals, theses, or alerts to the multi-agent War Room feed |
| `bastion_war_room_read` | — | Read the latest signals and consensus from the War Room |
| `bastion_war_room_consensus` | — | Get real-time directional consensus across all active agents |

The War Room is a shared intelligence feed where multiple Claude agents can post signals, build consensus, and coordinate strategies in real-time.

Chart Generation — 4 tools

| Tool | Auth | Description |
|:-----|:----:|:------------|
| `bastion_chart_candlestick` | — | OHLCV candlestick chart as SVG |
| `bastion_chart_vpvr` | — | Volume Profile Visible Range heatmap |
| `bastion_chart_liquidation` | — | Liquidation cluster heatmap |
| `bastion_chart_equity` | — | Portfolio equity curve chart |

Position DNA — 3 tools

| Tool | Auth | Description |
|:-----|:----:|:------------|
| `bastion_position_dna` | — | Encode position into DNA fingerprint |
| `bastion_dna_search` | — | Search stored DNA entries |
| `bastion_dna_similar` | — | Find historically similar positions |

Scenario Stress Engine — 3 tools

| Tool | Auth | Description |
|:-----|:----:|:------------|
| `bastion_stress_test` | — | Monte Carlo stress test across disaster scenarios |
| `bastion_scenario_builder` | — | Natural language to scenario parameters |
| `bastion_cascade_simulator` | — | Liquidation cascade simulation |

Devil's Advocate — 2 tools

| Tool | Auth | Description |
|:-----|:----:|:------------|
| `bastion_devils_advocate` | — | Data-driven counter-arguments against any trade |
| `bastion_challenge_thesis` | — | Challenge a trading thesis with live signals |

Smart Alerts — 4 tools

| Tool | Auth | Description |
|:-----|:----:|:------------|
| `bastion_smart_alert` | — | Create alert from natural language |
| `bastion_list_smart_alerts` | — | List active smart alerts |
| `bastion_check_smart_alerts` | — | Check alerts against market conditions |
| `bastion_cancel_smart_alert` | — | Cancel a smart alert |

Strategy Personas — 3 tools

| Tool | Auth | Description |
|:-----|:----:|:------------|
| `bastion_list_personas` | — | List all 6 strategy personas |
| `bastion_get_persona` | — | Get full persona details and rules |
| `bastion_persona_evaluate` | — | Evaluate trade through a persona's lens |

Portfolio X-Ray — 1 tool

| Tool | Auth | Description |
|:-----|:----:|:------------|
| `bastion_portfolio_xray` | — | Full portfolio diagnostic (correlation, concentration, exposure) |

Risk Budget — 1 tool

| Tool | Auth | Description |
|:-----|:----:|:------------|
| `bastion_risk_budget` | — | Volatility-adjusted position sizing from max loss budget |

Correlation Shock — 1 tool

| Tool | Auth | Description |
|:-----|:----:|:------------|
| `bastion_correlation_monitor` | — | Cross-asset correlation shifts + regime detection |

Sentiment Heatmap — 1 tool

| Tool | Auth | Description |
|:-----|:----:|:------------|
| `bastion_sentiment_heatmap` | — | Composite sentiment scoring across symbols |

AI Trading Plan — 1 tool

| Tool | Auth | Description |
|:-----|:----:|:------------|
| `bastion_trading_plan` | — | Structured 24h trading plan from live market data |

Kill Switch Protocol — 1 tool

| Tool | Auth | Description |
|:-----|:----:|:------------|
| `bastion_kill_switch` | `trade` | Emergency exit — close ALL positions, cancel orders, disarm engine |

The nuclear option. Logs market state at kill time for post-mortem review.

Market Autopsy — 2 tools

| Tool | Auth | Description |
|:-----|:----:|:------------|
| `bastion_autopsy_list` | — | List recent flash crashes, selloffs, and anomalies |
| `bastion_market_autopsy` | — | Full forensic breakdown — timeline, casualties, warning signals |

Like an NTSB crash report for crypto. Reconstructs exactly what happened.

Risk DNA Heatmap — 2 tools

| Tool | Auth | Description |
|:-----|:----:|:------------|
| `bastion_risk_dna` | — | Generate trading personality profile from history |
| `bastion_risk_dna_patterns` | — | Deep pattern mining — find edges and leaks |

Your behavioral fingerprint. Maps leverage, symbols, direction bias, streaks, and assigns a personality type.

### MCP Resources & Prompts

| Type | Name | Description |
|:-----|:-----|:------------|
| Resource | `bastion://positions` | Live position data stream |
| Resource | `bastion://market/{symbol}` | Real-time market data for any symbol |
| Resource | `bastion://engine/status` | Engine status and health |
| Prompt | `bastion-risk-check` | Guided risk evaluation workflow |
| Prompt | `bastion-morning-brief` | Daily market briefing template |
| Prompt | `bastion-research` | Deep research analysis template |

---

## Architecture

```
┌─────────────────────────────────────────────────────────────────┐
│                      YOUR CLAUDE AGENT                          │
│                                                                 │
│  "Evaluate my BTC long and check whale activity"                │
│       │                                                         │
│       ▼                                                         │
│  ┌────────────┐  ┌─────────────┐  ┌───────────────┐            │
│  │ evaluate_  │  │ get_whale_  │  │ get_funding_  │  Claude    │
│  │ risk       │  │ activity    │  │ rates         │  picks     │
│  └─────┬──────┘  └──────┬──────┘  └──────┬────────┘  tools    │
│        │                │                │                      │
└────────┼────────────────┼────────────────┼──────────────────────┘
         │                │                │
         ▼

…

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [bastionfintech-spec](https://github.com/bastionfintech-spec)
- **Source:** [bastionfintech-spec/bastion-mcp-server](https://github.com/bastionfintech-spec/bastion-mcp-server)
- **License:** MIT
- **Homepage:** https://bastionfi.tech/agents

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-bastionfintech-spec-bastion-mcp-server
- Seller: https://agentstack.voostack.com/s/bastionfintech-spec
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.