mcp-server-sentinel

English | 繁體中文 | 简体中文 | 日本語 | 한국어

MCP server for Sentinel Bot — algorithmic trading backtesting, bot management, and account operations via AI agents.

This server implements the Model Context Protocol (MCP), providing 36 tools that let AI agents run crypto backtests, deploy trading bots, optimize parameters, browse strategy marketplace, and manage accounts & payments — all through natural language.

Quick Start

1. Get an API Key

Sign up for free at sentinel.redclawey.com. All plans (including the free trial) support API Keys. Generate a key in your dashboard under Settings > API Keys. Purchase credits to start backtesting, then upgrade your plan as needed for more bots.

2. Installation

Claude Code (Recommended)

claude mcp add sentinel -- npx mcp-server-sentinel

Then set your environment variable:

export SENTINEL_API_KEY=sk-your-api-key-here

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "sentinel": {
      "command": "npx",
      "args": ["-y", "mcp-server-sentinel"],
      "env": {
        "SENTINEL_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

Manual Setup (Any MCP Client)

{
  "command": "npx",
  "args": ["-y", "mcp-server-sentinel"],
  "env": {
    "SENTINEL_API_KEY": "sk-your-api-key-here",
    "SENTINEL_API_URL": "https://sentinel.redclawey.com/api/v1"
  }
}

Environment Variables

| Variable | Required | Default | Description | |---|---|---|---| | SENTINEL_API_KEY | Yes | — | Your API key (starts with sk-) | | SENTINEL_API_URL | No | https://sentinel.redclawey.com/api/v1 | API base URL |

Tools (36)

Backtesting

| Tool | Description | |---|---| | run_backtest | Submit a backtest and wait for results. Supports 8 entry types and 6 exit types. Returns summary metrics by default; set include_trades=true for the full trade list. | | get_backtest_result | Fetch a specific backtest result by Job ID. Optionally polls until completion. | | list_backtests | List recent backtest jobs, filterable by status/symbol. | | cancel_backtest | Cancel a running or queued backtest job. |

Bot Management

| Tool | Description | |---|---| | list_bots | List all trading bots with optional status filter (idle/running/paused/stopped/error/halted). | | create_bot | Create a new bot. Pass strategy_blocks from a backtest result to deploy a tested strategy. | | get_bot | Get full bot details and current status. | | start_bot | Start a bot (requires exchange_id to be set). Dispatches live trading signals. | | stop_bot | Stop a running or paused bot. | | pause_bot | Pause a running bot (keeps positions, stops new signals). Only RUNNING bots. | | recover_bot | Recover a HALTED bot (circuit breaker reset). Only HALTED bots. | | delete_bot | Permanently delete a bot (must be stopped first). | | get_bot_performance | Get cumulative PnL, win rate, and trade count for a bot. | | get_bot_trades | Get paginated trade history for a bot with entry/exit prices, PnL. |

Exchanges

| Tool | Description | |---|---| | list_exchanges | List configured exchange credentials (Binance, Bybit, OKX, etc.). Use the exchange ID when creating a bot. |

OKX Exchange

| Tool | Description | |---|---| | okx_orderbook | Fetch OKX order book (public, no credentials needed). | | okx_funding_rate | Get current funding rate for OKX perpetual swap. | | okx_set_leverage | Set leverage and margin mode on OKX (requires OKX credentials). | | okx_positions | Get current OKX positions (requires OKX credentials). | | okx_algo_order | Place conditional/algo order on OKX (TP/SL/trailing/OCO). | | okx_market_overview | Get OKX top movers and volume leaders (public). |

AI Strategy

| Tool | Description | |---|---| | build_strategy | Generate a trading strategy from natural language using AI. Costs 1 credit. Returns strategy_blocks JSON for create_bot or run_backtest. |

Grid Optimization

| Tool | Description | |---|---| | run_grid_backtest | Parameter sweep backtest. Each combo costs 1 credit. Supports wait mode. | | get_grid_status | Check grid backtest progress and top 10 results. | | get_grid_results | Get full paginated grid results, sortable by various metrics. |

Analysis & Signals

| Tool | Description | |---|---| | get_analysis | Get latest SMC analysis: direction, scores, AI summaries. Requires Analysis Subscription. | | get_analysis_history | List historical daily analysis runs. | | get_signals | Get trading signals from bots with direction, prices, execution status. |

Strategy Marketplace

| Tool | Description | |---|---| | list_strategies | Browse marketplace strategies ranked by PnL, win rate, Sharpe. | | get_strategy_detail | Full strategy details + recent trades + subscription status. | | subscribe_strategy | Subscribe for copy-trading. Free strategies activate immediately; paid returns payment URL. |

Account & Payments

| Tool | Description | |---|---| | get_account_info | Current plan, credits balance, bot usage (used/max), and upgrade suggestions. | | get_plan_info | Static plan pricing and feature comparison across tiers. | | create_payment_link | Create a Helio checkout link (credit card/USDC) for plan upgrades or credit top-ups. | | create_crypto_invoice | Create a NOWPayments invoice (300+ cryptocurrencies) for plan upgrades or credit top-ups. | | verify_payment | Confirm whether a payment completed and the plan was upgraded. |

Usage Examples

Typical AI agent workflow:

1. build_strategy          -> AI generates strategy from description (1 credit)
2. run_backtest            -> Validate on historical data
3. run_grid_backtest       -> Optimize parameters
4. get_grid_results        -> Find best parameter combo
5. create_bot              -> Deploy with optimal params
6. start_bot               -> Go live
7. get_signals             -> Monitor signal execution
8. get_analysis            -> Check daily market analysis
9. get_bot_performance     -> Review PnL

When credits run out:

get_account_info           -> credits_balance: 0
create_payment_link        -> strategy_id: "credits_topup", amount_usd: 20
  -> Returns payment URL -> User completes payment in browser
verify_payment             -> Confirm credits added
run_backtest               -> Continue backtesting

Supported Symbols

BTC, ETH, SOL, XRP, BNB, DOGE, LINK, TRX, SUI

Supported Timeframes

1m, 5m, 15m, 1h, 4h, 1d

Entry Block Types

| Type | Description | Key Parameters | |---|---|---| | ema_cross | EMA Crossover | fast_period, slow_period | | macd_cross | MACD Signal Cross | fast_period, slow_period, signal_period | | rsi | RSI Overbought/Oversold | period, overbought, oversold | | breakout | Price Breakout | period, threshold | | volume_breakout | Volume Breakout | period, multiplier | | bollinger_bounce | Bollinger Band Bounce | period, std_dev | | smc_structure | Smart Money Concept Structure | lookback | | smc_level_entry | SMC Key Level Entry | lookback, zone_type |

Exit Block Types

| Type | Description | Key Parameters | |---|---|---| | fixed_pct | Fixed Percentage TP/SL | tp_pct, sl_pct | | atr_mult | ATR Multiple TP/SL | tp_atr_mult, sl_atr_mult, atr_period | | atr_trail | ATR Trailing Stop | trail_atr_mult, atr_period | | time | Time-based Exit | max_bars | | key_bar | Key Bar Pattern Exit | pattern | | combined | Multi-condition Combined Exit | Any combination of the above |

Plan Pricing

| Plan | Price | Bots | API Key | Symbols | |---|---|---|---|---| | Trial | Free (7 days) | 1 | Available | BTC | | Starter | $19/mo | 3 | Available | 5 | | Pro | $49/mo | 5 | Available | 8 | | Expert | $99/mo | 8 | Available | 10 | | Expert 10 | $125/mo | 10 | Available | 10 | | Expert 15 | $190/mo | 15 | Available | 10 | | Expert 30 | $385/mo | 30 | Available | 10 | | Expert 60 | $775/mo | 60 | Available | 10 |

All plans include API Key access. Start with the free trial, purchase credits for backtesting, then upgrade your plan as needed for more bots or symbols.

Credits are consumed per backtest run. Use create_payment_link or create_crypto_invoice with strategy_id: "credits_topup" to top up (minimum $10, 17 credits per $1).

Payment Methods

Credit Card / USDC: Via Helio (create_payment_link) — Visa, Mastercard, or USDC on Solana
300+ Cryptocurrencies: Via NOWPayments (create_crypto_invoice) — BTC, ETH, SOL, USDT, etc.

Development

git clone https://github.com/clarencyu-boop/mcp-server-sentinel.git
cd mcp-server-sentinel
npm install
SENTINEL_API_KEY=sk-your-key node src/index.mjs

License

MIT

MCP Servers

mcp-server-sentinel

Quick Start

1. Get an API Key

2. Installation

Claude Code (Recommended)

Claude Desktop

Manual Setup (Any MCP Client)

Environment Variables

Tools (36)

Backtesting

Bot Management

Exchanges

OKX Exchange

AI Strategy

Grid Optimization

Analysis & Signals

Strategy Marketplace

Account & Payments

Usage Examples

Supported Symbols

Supported Timeframes

Entry Block Types

Exit Block Types

Plan Pricing

Payment Methods

Development

License

安装包（如果需要）

Cursor 配置 (mcp.json)

mcp-server-sentinel

Quick Start

1. Get an API Key

2. Installation

Claude Code (Recommended)

Claude Desktop

Manual Setup (Any MCP Client)

Environment Variables

Tools (36)

Backtesting

Bot Management

Exchanges

OKX Exchange

AI Strategy

Grid Optimization

Analysis & Signals

Strategy Marketplace

Account & Payments

Usage Examples

Supported Symbols

Supported Timeframes

Entry Block Types

Exit Block Types

Plan Pricing

Payment Methods

Development

License

安装包 （如果需要）

Cursor 配置 (mcp.json)

安装包（如果需要）