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

Keywords

mcp

model-context-protocol

FAQs

What is mcp-server-sentinel?

Is mcp-server-sentinel well maintained?

Package last updated on 13 Mar 2026

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

mcp-server-sentinel