io.github.clarencyu-boop/sentinel

编码与调试

by clarencyu-boop

面向 Sentinel Bot 的加密交易工具,支持策略回测、机器人部署与账户管理。

什么是 io.github.clarencyu-boop/sentinel

面向 Sentinel Bot 的加密交易工具,支持策略回测、机器人部署与账户管理。

README

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.

Why Use This MCP Server?

This MCP server is built for Sentinel — an autonomous algorithmic trading platform designed for AI agent workflows. By connecting your AI agent to Sentinel via MCP, you get a complete agent-driven trading pipeline:

  • Natural language backtesting — describe a strategy idea, AI generates and tests it
  • One-conversation deployment — go from backtest to live trading bot without writing code
  • Real-time monitoring — PnL tracking, trading signals, and SMC market analysis
  • Full autonomy — strategy research, parameter optimization, and trade execution, all handled by your AI agent

Best paired with Claude Code, Claude Desktop, or any MCP-compatible AI client.

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)

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

Then set your environment variable:

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

Claude Desktop

Add to claude_desktop_config.json:

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

Manual Setup (Any MCP Client)

json
{
  "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

VariableRequiredDefaultDescription
SENTINEL_API_KEYYesYour API key (starts with sk-)
SENTINEL_API_URLNohttps://sentinel.redclawey.com/api/v1API base URL

Tools (36)

Backtesting

ToolDescription
run_backtestSubmit 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_resultFetch a specific backtest result by Job ID. Optionally polls until completion.
list_backtestsList recent backtest jobs, filterable by status/symbol.
cancel_backtestCancel a running or queued backtest job.

Bot Management

ToolDescription
list_botsList all trading bots with optional status filter (idle/running/paused/stopped/error/halted).
create_botCreate a new bot. Pass strategy_blocks from a backtest result to deploy a tested strategy.
get_botGet full bot details and current status.
start_botStart a bot (requires exchange_id to be set). Dispatches live trading signals.
stop_botStop a running or paused bot.
pause_botPause a running bot (keeps positions, stops new signals). Only RUNNING bots.
recover_botRecover a HALTED bot (circuit breaker reset). Only HALTED bots.
delete_botPermanently delete a bot (must be stopped first).
get_bot_performanceGet cumulative PnL, win rate, and trade count for a bot.
get_bot_tradesGet paginated trade history for a bot with entry/exit prices, PnL.

Exchanges

ToolDescription
list_exchangesList configured exchange credentials (Binance, Bybit, OKX, etc.). Use the exchange ID when creating a bot.

OKX Exchange

ToolDescription
okx_orderbookFetch OKX order book (public, no credentials needed).
okx_funding_rateGet current funding rate for OKX perpetual swap.
okx_set_leverageSet leverage and margin mode on OKX (requires OKX credentials).
okx_positionsGet current OKX positions (requires OKX credentials).
okx_algo_orderPlace conditional/algo order on OKX (TP/SL/trailing/OCO).
okx_market_overviewGet OKX top movers and volume leaders (public).

AI Strategy

ToolDescription
build_strategyGenerate a trading strategy from natural language using AI. Costs 1 credit. Returns strategy_blocks JSON for create_bot or run_backtest.

Grid Optimization

ToolDescription
run_grid_backtestParameter sweep backtest. Each combo costs 1 credit. Supports wait mode.
get_grid_statusCheck grid backtest progress and top 10 results.
get_grid_resultsGet full paginated grid results, sortable by various metrics.

Analysis & Signals

ToolDescription
get_analysisGet latest SMC analysis: direction, scores, AI summaries. Requires Analysis Subscription.
get_analysis_historyList historical daily analysis runs.
get_signalsGet trading signals from bots with direction, prices, execution status.

Strategy Marketplace

ToolDescription
list_strategiesBrowse marketplace strategies ranked by PnL, win rate, Sharpe.
get_strategy_detailFull strategy details + recent trades + subscription status.
subscribe_strategySubscribe for copy-trading. Free strategies activate immediately; paid returns payment URL.

Account & Payments

ToolDescription
get_account_infoCurrent plan, credits balance, bot usage (used/max), and upgrade suggestions.
get_plan_infoStatic plan pricing and feature comparison across tiers.
create_payment_linkCreate a Helio checkout link (credit card/USDC) for plan upgrades or credit top-ups.
create_crypto_invoiceCreate a NOWPayments invoice (300+ cryptocurrencies) for plan upgrades or credit top-ups.
verify_paymentConfirm whether a payment completed and the plan was upgraded.

Usage Examples

Typical AI agent workflow:

code
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:

code
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

TypeDescriptionKey Parameters
ema_crossEMA Crossoverfast_period, slow_period
macd_crossMACD Signal Crossfast_period, slow_period, signal_period
rsiRSI Overbought/Oversoldperiod, overbought, oversold
breakoutPrice Breakoutperiod, threshold
volume_breakoutVolume Breakoutperiod, multiplier
bollinger_bounceBollinger Band Bounceperiod, std_dev
smc_structureSmart Money Concept Structurelookback
smc_level_entrySMC Key Level Entrylookback, zone_type

Exit Block Types

TypeDescriptionKey Parameters
fixed_pctFixed Percentage TP/SLtp_pct, sl_pct
atr_multATR Multiple TP/SLtp_atr_mult, sl_atr_mult, atr_period
atr_trailATR Trailing Stoptrail_atr_mult, atr_period
timeTime-based Exitmax_bars
key_barKey Bar Pattern Exitpattern
combinedMulti-condition Combined ExitAny combination of the above

Plan Pricing

PlanPriceBotsAPI KeySymbols
TrialFree (7 days)1AvailableBTC
Starter$19/mo3Available5
Pro$49/mo5Available8
Expert$99/mo8Available10
Expert 10$125/mo10Available10
Expert 15$190/mo15Available10
Expert 30$385/mo30Available10
Expert 60$775/mo60Available10

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

bash
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

常见问题

io.github.clarencyu-boop/sentinel 是什么?

面向 Sentinel Bot 的加密交易工具,支持策略回测、机器人部署与账户管理。

相关 Skills

网页构建器

by anthropics

Universal
热门

面向复杂 claude.ai HTML artifact 开发,快速初始化 React + Tailwind CSS + shadcn/ui 项目并打包为单文件 HTML,适合需要状态管理、路由或多组件交互的页面。

在 claude.ai 里做复杂网页 Artifact 很省心,多组件、状态和路由都能顺手搭起来,React、Tailwind 与 shadcn/ui 组合效率高、成品也更精致。

编码与调试
未扫描114.1k

前端设计

by anthropics

Universal
热门

面向组件、页面、海报和 Web 应用开发,按鲜明视觉方向生成可直接落地的前端代码与高质感 UI,适合做 landing page、Dashboard 或美化现有界面,避开千篇一律的 AI 审美。

想把页面做得既能上线又有设计感,就用前端设计:组件到整站都能产出,难得的是能避开千篇一律的 AI 味。

编码与调试
未扫描114.1k

网页应用测试

by anthropics

Universal
热门

用 Playwright 为本地 Web 应用编写自动化测试,支持启动开发服务器、校验前端交互、排查 UI 异常、抓取截图与浏览器日志,适合调试动态页面和回归验证。

借助 Playwright 一站式验证本地 Web 应用前端功能,调 UI 时还能同步查看日志和截图,定位问题更快。

编码与调试
未扫描114.1k

相关 MCP Server

GitHub

编辑精选

by GitHub

热门

GitHub 是 MCP 官方参考服务器,让 Claude 直接读写你的代码仓库和 Issues。

这个参考服务器解决了开发者想让 AI 安全访问 GitHub 数据的问题,适合需要自动化代码审查或 Issue 管理的团队。但注意它只是参考实现,生产环境得自己加固安全。

编码与调试
83.4k

by Context7

热门

Context7 是实时拉取最新文档和代码示例的智能助手,让你告别过时资料。

它能解决开发者查找文档时信息滞后的问题,特别适合快速上手新库或跟进更新。不过,依赖外部源可能导致偶尔的数据延迟,建议结合官方文档使用。

编码与调试
52.2k

by tldraw

热门

tldraw 是让 AI 助手直接在无限画布上绘图和协作的 MCP 服务器。

这解决了 AI 只能输出文本、无法视觉化协作的痛点——想象让 Claude 帮你画流程图或白板讨论。最适合需要快速原型设计或头脑风暴的开发者。不过,目前它只是个基础连接器,你得自己搭建画布应用才能发挥全部潜力。

编码与调试
46.3k

评论