Skip to main content
Glama
deenesjakozh
kwizzlesurp10-ctrl

Alpha Sentinel Market Intelligence x402 MCP Server

by kwizzlesurp10-ctrl
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

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）：

资源

价格

配额（专业版）

描述

price_feed()

$0.005

5000/月

实时价格查询

volatility_alerts()

$0.02

500/月

异常检测 + 阈值

sentiment_analysis()

$0.01

1000/月

社交情绪聚合

risk_assessment()

$0.03

300/月

多因素风险评分

market_report()

$0.15

50/月

综合每日报告

Tool Credit Pack

$1.00

100 calls

灵活积分包

免费层级： 每月 50 次调用，每分钟 5 次限流
专业层级： 无限配额，每分钟 120 次，优先结算

🛠️ MCP 工具

核心智能工具

  1. fetch_price() ⭐ 包含免费层级

    • 从 CoinGecko API 获取最新价格

    • 支持：BTC、ETH、前 100 种山寨币

    • 响应：{ symbol, price_usd, change_24h, volume }

  2. analyze_volatility()

    • 通过 Z-score 统计分析检测价格异常

    • 可配置阈值（默认：2σ）

    • 返回异常分数 + 警报级别

  3. aggregate_sentiment()

    • 从 X/Twitter、Reddit、Telegram 来源聚合

    • 基于 NLP 生成情绪评分（-1.0 至 +1.0）

    • 趋势检测与动量指标

  4. calculate_risk_score()

    • 多因素风险评估（波动性、流动性、相关性）

    • 风险等级：LOW/MEDIUM/HIGH/CRITICAL

    • 包含置信区间

  5. 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 中的模式进行操作：

  1. 将工具定义添加到 TOOL_SPECS 列表

  2. 在 app/intelligence/ 目录中实现相应的处理程序

  3. 在 app/mcp_server.py 中注册

  4. 在 README 中新增工具表格行

  5. 运行 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 中的步骤操作：

Deploy with Vercel

手动部署

# 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 可以：

  1. 侦察（Scout） 探索上游 x402 数据源

  2. 守卫（Warden） 强制实施每个 ledger/policy.json 的支出限额

  3. 财务（Treasurer） 支付上游数据费用（唯一的支出角色）

  4. 档案（Archivist） 组装付费集合产品

  5. 主权（Sovereign） 重新定价以达到目标 LTV:CAC ≥ 3.0

  6. 商户（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 - 允许商业使用，请注明来源！ ★彡

准备好实现你的市场情报价值了吗？
👉 立即部署
👉 阅读用户指南
👉 查看仪表盘

(◕‿◕) ✨ 预测智能，由链上经济学提供动力！ ♪

This server cannot be installed

F
license - not found
Not graded
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • agentpulse-mcp

    BoltyBolterson
    A
    license
    Not graded
    quality
    C
    maintenance
    Provides AI agents with real-time, structured data feeds including news, trends, market sentiment, and crypto prices via MCP tools.
    MIT

  • Enterprise Crypto MCP Gateway

    Jinzo03
    F
    license
    Not graded
    quality
    C
    maintenance
    Enables MCP-compatible AI clients to access live crypto market data and AI-driven quantitative analysis, with structured outputs and full observability.

View all related MCP servers

Related MCP Connectors

  • CryptoData API

    Crypto MCP with 21 tools for market data, DeFi, analytics, and sentiment. Post-paid USDC billing.

  • midasflow-mcp-quickstart

    Agent-native crypto market-data over MCP+REST: order flow, whales, liquidations, calibrated scores

  • ko-mcp

    Real SEC, 13F, insider, congress & macro data your AI agent can cite. Hosted MCP, 24 tools.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/kwizzlesurp10-ctrl/alpha-sentinel-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server