# BASTION MCP

> Risk Intelligence MCP Server for Claude Agents | 49 tools, 560+ signals, fine-tuned 72B AI model

- **Type:** MCP server
- **Install:** `agentstack add mcp-bastionfintech-spec-bastion-mcp`
- **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
- **Website:** https://bastionfi.tech/agents

## Install

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

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 Claude Agents

**49 tools. 560+ signals. One protocol.**

Give your Claude agent real-time crypto market intelligence, autonomous risk management, and institutional-grade derivatives analytics.

[](https://modelcontextprotocol.io)
[](https://bastionfi.tech/agents)
[](https://claude.ai)
[](https://claude.ai)
[](LICENSE)
[](https://github.com/bastionfintech-spec/BASTION-MCP)

---

[Platform](https://bastionfi.tech) | [Agents Hub](https://bastionfi.tech/agents) | [Dashboard](https://bastionfi.tech/dashboard) | [MCP Endpoint](https://bastionfi.tech/mcp/sse) | [Get API Key](https://bastionfi.tech/account)

---

## Table of Contents

- [What is BASTION?](#what-is-bastion)
- [Quick Start](#quick-start) — Get connected in 30 seconds
- [Features](#features) — 49 tools across 9 categories
- [Architecture](#architecture) — How it works under the hood
- [Authentication](#authentication) — API keys and scopes
- [Example Conversations](#example-conversations) — Real Claude + BASTION interactions
- [Tool Categories Deep Dive](#tool-categories-deep-dive) — Detailed tool documentation
- [Signal Coverage](#signal-coverage) — 560+ signals breakdown
- [Agent Patterns](#agent-patterns) — Proven agentic workflows
- [Rate Limits](#rate-limits) — Tiers and quotas
- [Supported Symbols](#supported-symbols) — 100+ pairs
- [Repository Structure](#repository-structure) — What's in this repo
- [FAQ](#faq)
- [Links](#links)

---

## What is BASTION?

BASTION is a **Model Context Protocol (MCP) server** that gives Claude agents real-time access to comprehensive crypto market intelligence. Through a single SSE connection, your Claude agent gains 49 specialized tools spanning market data, derivatives analytics, on-chain intelligence, AI-powered risk evaluation, portfolio management, and autonomous trading execution.

At its core, BASTION is powered by a **fine-tuned 72B parameter AI model** that analyzes **560+ real-time signals** across derivatives flow, on-chain metrics, macro indicators, whale activity, and market microstructure. The model was trained on thousands of validated trade outcomes and delivers structured risk assessments with explicit reasoning, confidence scores, and actionable recommendations -- not just price predictions, but complete risk intelligence.

Unlike traditional crypto APIs that return raw data and leave interpretation to the user, BASTION's MCP tools deliver **contextual intelligence**. When your Claude agent calls `bastion_evaluate_risk`, it doesn't just get numbers -- it gets a structured analysis that synthesizes open interest changes, funding rates, CVD divergence, whale positioning, liquidation clusters, and market structure into a single coherent risk assessment with a recommended action and full reasoning chain.

> **TL;DR** — Connect once, get 49 tools. Your Claude agent becomes a professional crypto trading desk.

---

## Quick Start

BASTION connects via the **Model Context Protocol (MCP)** over Server-Sent Events. No local installation required -- the server runs in the cloud.

### Claude Code

One command. That's it.

```bash
claude mcp add bastion-mcp --transport sse https://bastionfi.tech/mcp/sse
```

Restart Claude Code and all 49 tools are available. Try:

```
You: What's the current state of BTC? Check derivatives flow and sentiment.
```

### Claude Desktop

Add to your `claude_desktop_config.json`:

**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

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

Restart Claude Desktop. BASTION tools appear in the tools menu (hammer icon).

### API / Custom MCP 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()

        # Get Bitcoin price
        result = await session.call_tool("bastion_get_price", {"symbol": "BTC"})
        print(result)

        # Evaluate risk on a position
        risk = await session.call_tool("bastion_evaluate_risk", {
            "symbol": "ETH",
            "direction": "LONG",
            "entry_price": 2450.0,
            "current_price": 2520.0,
            "leverage": 5,
            "stop_loss": 2380.0
        })
        print(risk)
```

### Setting Your API Key

For authenticated tools (portfolio, trading, engine), pass your key in the URL:

```
https://bastionfi.tech/mcp/sse?api_key=bst_your_key_here
```

Get your key at [bastionfi.tech/account](https://bastionfi.tech/account).

> **Tip:** See the full [Quickstart Guide](quickstart.md) for a 5-minute walkthrough, or check the detailed setup guides in [`guides/`](guides/).

---

## Features

### 49 Tools Across 9 Categories

:brain: Core AI — 4 tools

| Tool | Description |
|------|-------------|
| `bastion_evaluate_risk` | Full risk evaluation for an open position using 560+ signals |
| `bastion_chat` | Natural language conversation with the fine-tuned risk model |
| `bastion_evaluate_all_positions` | Batch evaluation of all open positions |
| `bastion_scan_signals` | Scan a symbol for trade signals and opportunities |

:chart_with_upwards_trend: Market Data — 4 tools

| Tool | Description |
|------|-------------|
| `bastion_get_price` | Real-time price, 24h change, volume |
| `bastion_get_market_data` | Extended market data (market cap, supply, dominance) |
| `bastion_get_klines` | OHLCV candlestick data for any timeframe |
| `bastion_get_volatility` | Realized volatility, ATR, Bollinger bandwidth |

:ocean: Derivatives & Order Flow — 12 tools

| Tool | Description |
|------|-------------|
| `bastion_get_open_interest` | Aggregate open interest across exchanges |
| `bastion_get_oi_changes` | Open interest changes over time windows |
| `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 exchanges |
| `bastion_get_funding_arb` | Funding rate arbitrage opportunities |
| `bastion_get_liquidations` | Recent and aggregate liquidation data |
| `bastion_get_heatmap` | Liquidation heatmap (price clusters) |
| `bastion_get_taker_ratio` | Taker buy/sell ratio |
| `bastion_get_top_traders` | Top trader long/short ratios |
| `bastion_get_market_maker_magnet` | Market maker gamma exposure and magnet levels |
| `bastion_get_options` | Options flow, max pain, put/call ratio |

:link: On-Chain & Intelligence — 4 tools

| Tool | Description |
|------|-------------|
| `bastion_get_whale_activity` | Large wallet movements and accumulation |
| `bastion_get_exchange_flow` | Exchange inflow/outflow (deposit/withdrawal trends) |
| `bastion_get_onchain` | On-chain metrics (active addresses, NVT, SOPR) |
| `bastion_get_news` | Curated crypto news and event feed |

:globe_with_meridians: Macro & Sentiment — 6 tools

| Tool | Description |
|------|-------------|
| `bastion_get_fear_greed` | Crypto Fear & Greed Index |
| `bastion_get_macro_signals` | DXY, bond yields, SPX correlation |
| `bastion_get_etf_flows` | Bitcoin & Ethereum ETF flow data |
| `bastion_get_stablecoin_markets` | Stablecoin supply and flow analysis |
| `bastion_get_economic_data` | CPI, FOMC, jobs data and calendar |
| `bastion_get_polymarket` | Prediction market odds for crypto events |

:page_facing_up: Research — 3 tools

| Tool | Description |
|------|-------------|
| `bastion_generate_report` | Generate a full research report for a symbol |
| `bastion_get_reports` | Retrieve previously generated reports |
| `bastion_calculate_position` | Position size calculator with risk parameters |

:briefcase: Portfolio — 7 tools

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

:zap: Trading Actions — 6 tools

| Tool | Description |
|------|-------------|
| `bastion_emergency_exit` | Immediately close a position at market |
| `bastion_partial_close` | Close a percentage of a position |
| `bastion_set_take_profit` | Set or modify take-profit order |
| `bastion_set_stop_loss` | Set or modify stop-loss order |
| `bastion_move_to_breakeven` | Move stop-loss to entry price |
| `bastion_flatten_winners` | Close all positions currently in profit |

:gear: Engine Control — 3 tools

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

### Plus Resources & Prompts

| Type | Name | Description |
|------|------|-------------|
| Resource | `bastion://positions` | Live position data stream |
| Resource | `bastion://market/{symbol}` | Real-time market data for a 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                          │
│                                                                      │
│  "Check my BTC position risk"                                        │
│       │                                                              │
│       ▼                                                              │
│  ┌──────────┐  ┌──────────────┐  ┌──────────────┐                   │
│  │ get_     │  │ evaluate_    │  │ get_         │   Claude picks    │
│  │ positions│  │ risk         │  │ funding_rates│   the right tools │
│  └────┬─────┘  └──────┬───────┘  └──────┬───────┘                   │
│       │               │                 │                            │
└───────┼───────────────┼─────────────────┼────────────────────────────┘
        │               │                 │
        ▼               ▼                 ▼
┌──────────────────────────────────────────────────────────────────────┐
│                     MCP PROTOCOL (SSE Transport)                     │
│                  https://bastionfi.tech/mcp/sse                      │
└──────────────────────────────────────────────────────────────────────┘
        │               │                 │
        ▼               ▼                 ▼
┌──────────────────────────────────────────────────────────────────────┐
│                        BASTION MCP SERVER                            │
│                                                                      │
│  ┌─────────────┐  ┌──────────────┐  ┌───────────────┐               │
│  │ Tool Router │  │ Auth Layer   │  │ Rate Limiter  │               │
│  │ (49 tools)  │  │ (bst_ keys)  │  │               │               │
│  └──────┬──────┘  └──────────────┘  └───────────────┘               │
│         │                                                            │
│  ┌──────┴──────────────────────────────────────────┐                 │
│  │              Risk Intelligence Core             │                 │
│  │                                                  │                 │
│  │  ┌──────────┐  ┌──────────┐  ┌──────────────┐  │                 │
│  │  │ 72B AI   │  │ Signal   │  │ Structure    │  │                 │
│  │  │ Model    │  │ Aggregator│  │ Analyzer     │  │                 │
│  │  │ (Fine-   │  │ (560+    │  │ (VPVR, S/R,  │  │                 │
│  │  │  tuned)  │  │  signals) │  │  Order Flow) │  │                 │
│  │  └──────────┘  └──────────┘  └──────────────┘  │                 │
│  └──────┬──────────────────────────────────────────┘                 │
│         │                                                            │
└─────────┼────────────────────────────────────────────────────────────┘
          │
          ▼
┌──────────────────────────────────────────────────────────────────────┐
│                         DATA SOURCES                                 │
│                                                                      │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐  │
│  │ Binance  │ │ Bybit    │ │ CoinGlass│ │ On-Chain │ │ Macro    │  │
│  │ OKX      │ │ Bitget   │ │ Coinalyze│ │ Whale    │ │ ETF      │  │
│  │ dYdX     │ │ Hyperliq.│ │ Options  │ │ Exchange │ │ Polymark.│  │
│  └──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘  │
└──────────────────────────────────────────────────────────────────────┘
```

**How it works:**

1. Your Claude agent receives a user request (e.g., "evaluate my BTC long")
2. Claude selects the appropriate BASTION tools via MCP
3. Tool calls are sent over SSE to the BASTION server
4. BASTION authenticates, rate-limits, and routes to the correct handler
5. The Risk Intelligence Core aggregates data from multiple sources, runs the fine-tuned 72B model if needed, and returns structured results
6. Claude synthesizes the tool results into a natural language response

---

## Authentication

BASTION uses API keys prefixed with `bst_` to control access. Keys are scoped to specific permission levels:

| Scope | Access Level | Tools |
|-------|-------------|-------|
| **Public** | No key required | Market data, derivatives, on-chain, macro, sentiment, AI |
| **Read** | `bst_` key with `read` scope | Portfolio viewing, positions, balances, alerts |
| **Trade** | `bst_` key with `trade` scope | Trading actions (exit, partial close, TP/SL) |
| **Engine** | `bst_` key with `engine` scope | Autonomous engine control (start, arm, disarm) |

Public Tools (No Authentication)

The following tool categories work without an API key, making BASTION immediately useful for market research and analysis:

- All **Market Data** tools
- All **Derivatives & Order Flow** tools
- All **On-Chain & Intelligence** tools
- All **Macro & Sentiment** tools
- All **Core AI** tools (risk evaluation, chat, signal scanning)
- All **Research** tools

Getting an API Key

1. Visit [bastionfi.tech/account](https://bastionfi.tech/account)
2. Create an account or sign in
3. Generate an API key with the scopes you need
4. Add the key to your MCP connection URL

Key Security

- API keys are transmitted over HTTPS only
- Keys can be revoked instantly from the dashboard
- Each key has configurable rate limits
- Trading and engine scopes require explicit opt-in

---

## Example Conversations

These examples show how Claude uses BASTION tools in real conversations.

Example 1: Market Overview

```
User: What's the current state of BTC? Give me a quick overview.

Claude: I'll pull the latest Bitcoin data for you.

[Calls bastion_get_price with symbol "BTC"]
[Calls bastion_get_market_data with symbol "BTC"]
[Calls bastion_get_fear_greed]

Here's the current state of Bitcoin:

  Price:       $98,420 (+2.3% 24h)
  24h Volume:  $48.2B
  Market Cap:  $1.94T
  Dominance:   56.8%

  Fear & Greed: 72 (Greed)

  24h Range:   $95,880 - $99,150
  7d Change:   +5.1%
  30d Change:  +12.4%

BTC is showing strong momentum with price approaching the $100K psychological
level. Volume is elevated and sentiment is firmly in "Greed" territory.
Would you like me to check derivatives flow or run a deeper analysis?
```

Example 2: Position Risk Evaluation

```
User: Check my open positions and evaluate risk on all

…

## 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](https://github.com/bastionfintech-spec/BASTION-MCP)
- **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
- 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%.