Alpha Sentinel Market Intelligence x402 MCP Server
Alpha Sentinel - Market Intelligence x402 MCP Server
⭐ 链上赚取奖励的预测智能代理! ★
一个生产级 x402 市场服务,通过付费 MCP 工具为 AI 智能体提供实时加密市场监控、波动性警报和情绪分析。
🎯 任务
通过处理微支付 API 端点和 MCP 工具,提供具有 <30s 延迟的可操作实时市场情报。成功状态 = 可操作警报,每次调用 ROI 可衡量!
Related MCP server: Enterprise Crypto MCP Gateway
💰 定价
根据 x402 市场调研(中位价格为 $0.014,约 90% 低于 $0.10):
资源 | 价格 | 配额(专业版) | 描述 |
| $0.005 | 5000/月 | 实时价格查询 |
| $0.02 | 500/月 | 异常检测 + 阈值 |
| $0.01 | 1000/月 | 社交情绪聚合 |
| $0.03 | 300/月 | 多因素风险评分 |
| $0.15 | 50/月 | 综合每日报告 |
Tool Credit Pack | $1.00 | 100 calls | 灵活积分包 |
免费层级: 每月 50 次调用,每分钟 5 次限流
专业层级: 无限配额,每分钟 120 次,优先结算
🛠️ MCP 工具
核心智能工具
fetch_price()⭐ 包含免费层级从 CoinGecko API 获取最新价格
支持:BTC、ETH、前 100 种山寨币
响应:
{ symbol, price_usd, change_24h, volume }
analyze_volatility()通过 Z-score 统计分析检测价格异常
可配置阈值(默认:2σ)
返回异常分数 + 警报级别
aggregate_sentiment()从 X/Twitter、Reddit、Telegram 来源聚合
基于 NLP 生成情绪评分(-1.0 至 +1.0)
趋势检测与动量指标
calculate_risk_score()多因素风险评估(波动性、流动性、相关性)
风险等级:LOW/MEDIUM/HIGH/CRITICAL
包含置信区间
generate_market_report()综合每日/每周/每月报告
整合所有数据源
PDF + JSON 输出格式
📦 +代表付费组合产品
美国租赁尽职调查包(依赖城市合规集成层):$1.50
涉及租赁许可证、违规单和租户权利
多物业批量处理
市政位置开放数据关联
脉冲快讯:$0.05
基链 + 市场指标综合分析
12 区块采样深度
实时现货价格集成
信用决策费:$0.01
低成本交易价查询层,用于常规交易前检查
主网交易前即时反馈
🏗️ 架构
┌─────────────────────────────────────────────────────┐
│ Alpha Sentinel MCP Server │
├─────────────────────────────────────────────────────┤
│ │
│ [MCP Layer] │
│ ├─ FastMCP Server (stdio + SSE) │
│ └─ Tool Registry (SSOT) │
│ │ │
│ [Commerce Layer] │
│ ├─ x402 Middleware (verify+settle) │
│ ├─ Quota Management (free/pro tiers) │
│ ├─ Challenge Cache (sync, 10s TTL) │
│ └─ Stripe Integration (fiat rail fallback) │
│ │ │
│ [Intelligence Layer] │
│ ├─ Price Feed (CoinGecko API) │
│ ├─ Sentiment Engine (X/Reddit/NLP) │
│ ├─ Volatility Analyzer (statistical models) │
│ └─ Risk Calculator (ML-enhanced) │
│ │ │
│ [On-Chain Layer] │
│ ├─ CDP Facilitator (Base mainnet) │
│ ├─ Ledger (spend/revenue tracking) │
│ └─ Swarm Agency (buy-compose-resell) │
│ │
└─────────────────────────────────────────────────────┘🚀 快速开始
前置条件
Python 3.12+
Redis(可选,用于生产环境)
x402 卖家凭证(与买家凭证分开!)
CoinGecko API 密钥(免费层级即可)
初始设置
# Clone and setup
git clone https://github.com/kwizzlesurp10-ctrl/alpha-sentinel-mcp
cd alpha-sentinel-mcp
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
# Configure environment
cp .env.example .env
nano .env # Edit with your credentials
# Run locally
make up # API (8403) + dashboard (5174)环境变量
# Seller (receive revenue)
X402_PAY_TO_ADDRESS=0xAB745e5F... # Separate from buyer!
# Buyer (hot wallet for spending)
EVM_PRIVATE_KEY=<your_buyer_key> # NEVER on Render!
# APIs
COINGECKO_API_KEY=<your_key>
X_API_KEY=<twitter/x_api_key> # Optional
# Commerce
STRIPE_SECRET_KEY=<your_stripe_key> # Optional
REDIS_URL=redis://localhost:6379 # Optional
# Network
X402_DEFAULT_NETWORK=eip155:84532 # Base Sepolia dev
CDP_API_KEY_ID=<cdp_id> # For mainnet selling
CDP_API_KEY_SECRET=<cdp_secret>🔧 开发
运行测试
# Full test suite
make test
# Specific tests
pytest tests/test_mcp_tools.py -v
pytest tests/test_commerce.py -v
# Dashboard tests
cd dashboard && pnpm vitest run添加新的 MCP 工具
按照 app/tools_registry.py 中的模式进行操作:
将工具定义添加到
TOOL_SPECS列表在
app/intelligence/目录中实现相应的处理程序在
app/mcp_server.py中注册在 README 中新增工具表格行
运行
scripts/capture_goal_evidence.py更新已记录的测试结果
要记住: 工具注册表是唯一的事实来源!必须同步修改所有相关文件,否则 CI 将会失败。
CI/CD 流程
GitHub Actions 包括:
✅ Pytest(Python 3.12)
✅ Vitest(仪表盘)
✅ 安全扫描(秘密扫描、SAST)
✅ 覆盖率检查(>80%)
✅ Docker 构建与推送
📊 可观测性
指标端点
/stats- 实时使用统计数据/ledger/{name}- 结算历史记录/quota/{agent_id}- 剩余配额/swarm/stats- 自治智能体指标
事件流
订阅 SSE 服务 /events 以获取实时:
工具执行日志
结算确认
配额更新
Swarm 阶段转换
🔒 安全性
✅ 不会提交任何私钥到仓库(
.env始终被忽略)✅ 对所有 URL 探测启用 SSRF 防御
✅ 按 agent_id 对请求频率进行限制
✅ 结算使用幂等键
✅ 支持通过
KEY_PROVIDER服务接口进行密钥轮换✅ 绝不会在响应中暴露异常内部实现信息
卖家与买家密钥:
收款地址(接收地址): 冷钱包用于接收收益(与买家密钥分开!)
买家密钥: 仅用于支付上游成本的热钱包(绝不用于接收)
绝对不要在 Render 上设置 EVM_PRIVATE_KEY - 仅本地使用!
|## 🌐 部署
在线仪表盘: https://alpha-sentinel-mcp.vercel.app/ (即将推出)
快速部署到 Vercel
点击下方链接或按照 DEPLOYMENT.md 中的步骤操作:
手动部署
# Install Vercel CLI
npm install -g vercel
# Deploy dashboard
cd /home/keef/alpha-sentinel-mcp
vercel --prod仪表盘将自动代理 API 调用到您的个人后端。
Render(API 服务)
通过 render.yaml 部署 - 自动配置:
Web 服务(端口 8403)
Redis 实例(自动配置)
环境变量来自安全存储
健康检查端点:
/health
Docker
docker build -t alpha-sentinel-mcp .
docker run -p 8403:8403 \
-e X402_PAY_TO_ADDRESS=$PAY_TO \
-e EVM_PRIVATE_KEY=$BUYER_KEY \
alpha-sentinel-mcp🤝 Swarm 智能体集成
当 SWARM_ENABLED=true 时,Alpha Sentinel 可以:
侦察(Scout) 探索上游 x402 数据源
守卫(Warden) 强制实施每个
ledger/policy.json的支出限额财务(Treasurer) 支付上游数据费用(唯一的支出角色)
档案(Archivist) 组装付费集合产品
主权(Sovereign) 重新定价以达到目标 LTV:CAC ≥ 3.0
商户(Merchant) 列出生成的合成产品
集合示例:购买来自 3 个上游的原始价格 → 聚合 → 以 3 倍加价重新销售为“高级套装”!
📈 市场发现
在 CDP Bazaar 上展示:
服务名称:
Alpha Sentinel 市场情报平台标签:
基础、智能、加密、市场、情绪所有权证明:使用接收地址签名
产品列表 URL:
https://alpha-sentinel-mcp.onrender.com/.well-known/x402
🎓 文档
🏆 成功指标
警报延迟: 端到端 <30s
结算成功率: >95% 首次尝试
LTV:CAC 比率: 目标 ≥ 3.0
锁仓边际: 组合产品 ≥ 50%
配额利用率: 超过 70% 的专业层级转化率
🎯 设立
由 Keith 构建 (kwizzlesurp10-ctrl)作为 AI Agency Factory 生态的一部分。灵感来源于 Karpathy 的 LLM Wiki 知识组织方式和 x402 微支付革命!
特别感谢:
Coinbase CDP 团队提供 x402 促进层
FastAPI + FastMCP 维护者们
整个开源 x402 社区
📄 开源许可证
MIT - 允许商业使用,请注明来源! ★彡
准备好实现你的市场情报价值了吗?
👉 立即部署
👉 阅读用户指南
👉 查看仪表盘
(◕‿◕) ✨ 预测智能,由链上经济学提供动力! ♪
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Crypto market & research MCP for AI agents: prices, derivatives, options, on-chain, sentiment, news.
Crypto MCP with 21 tools for market data, DeFi, analytics, and sentiment. Post-paid USDC billing.
Real-time data feeds for AI agents with USDC micropayments on Base for premium tools.
Production-grade MCP gateway delivering 8 real-time AI tools with instant x402 micropayments settled in USDC on Base Mainnet or SPL-USDC on Solana. Features Basescan contract auditing, wallet analytics, headless browser scraping, and pre-scraped oracle data feeds.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceProvides AI agents with real-time, structured data feeds including news, trends, market sentiment, and crypto prices via MCP tools.MIT
- FlicenseNot gradedqualityCmaintenanceEnables MCP-compatible AI clients to access live crypto market data and AI-driven quantitative analysis, with structured outputs and full observability.-

Stelar Signals MCPofficial
AlicenseAqualityDmaintenanceEnables AI agents to access crypto market signals including regime, sentiment, price, risk, and text tools like summarization and fact-checking, backed by a live production-grade classifier.656 npmMIT- AlicenseNot gradedqualityDmaintenanceEnables AI agents to access professional crypto market intelligence via 8 MCP tools, covering market regime, fear/greed, funding rates, DeFi yields, token signals, wallet risk, and contract audits. Backed by real-time data from Binance, DeFiLlama, Etherscan, with both free tools and x402 micropayment options.2MIT