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)
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
常见问题
io.github.clarencyu-boop/sentinel 是什么?
面向 Sentinel Bot 的加密交易工具,支持策略回测、机器人部署与账户管理。
相关 Skills
网页构建器
by anthropics
面向复杂 claude.ai HTML artifact 开发,快速初始化 React + Tailwind CSS + shadcn/ui 项目并打包为单文件 HTML,适合需要状态管理、路由或多组件交互的页面。
✎ 在 claude.ai 里做复杂网页 Artifact 很省心,多组件、状态和路由都能顺手搭起来,React、Tailwind 与 shadcn/ui 组合效率高、成品也更精致。
前端设计
by anthropics
面向组件、页面、海报和 Web 应用开发,按鲜明视觉方向生成可直接落地的前端代码与高质感 UI,适合做 landing page、Dashboard 或美化现有界面,避开千篇一律的 AI 审美。
✎ 想把页面做得既能上线又有设计感,就用前端设计:组件到整站都能产出,难得的是能避开千篇一律的 AI 味。
网页应用测试
by anthropics
用 Playwright 为本地 Web 应用编写自动化测试,支持启动开发服务器、校验前端交互、排查 UI 异常、抓取截图与浏览器日志,适合调试动态页面和回归验证。
✎ 借助 Playwright 一站式验证本地 Web 应用前端功能,调 UI 时还能同步查看日志和截图,定位问题更快。
相关 MCP Server
GitHub
编辑精选by GitHub
GitHub 是 MCP 官方参考服务器,让 Claude 直接读写你的代码仓库和 Issues。
✎ 这个参考服务器解决了开发者想让 AI 安全访问 GitHub 数据的问题,适合需要自动化代码审查或 Issue 管理的团队。但注意它只是参考实现,生产环境得自己加固安全。
Context7 文档查询
编辑精选by Context7
Context7 是实时拉取最新文档和代码示例的智能助手,让你告别过时资料。
✎ 它能解决开发者查找文档时信息滞后的问题,特别适合快速上手新库或跟进更新。不过,依赖外部源可能导致偶尔的数据延迟,建议结合官方文档使用。
by tldraw
tldraw 是让 AI 助手直接在无限画布上绘图和协作的 MCP 服务器。
✎ 这解决了 AI 只能输出文本、无法视觉化协作的痛点——想象让 Claude 帮你画流程图或白板讨论。最适合需要快速原型设计或头脑风暴的开发者。不过,目前它只是个基础连接器,你得自己搭建画布应用才能发挥全部潜力。