Alpha Sentinel - Market Intelligence x402 MCP Server

⭐ Predictive intelligence agent earning rewards on-chain! ★

このサービスは、AIエージェント向け有料MCPツールとして、リアルタイムの暗号通貨マーケット監視、ボラティリティアラート、センチメント分析を提供する本番グレードのx402マーケットプレイスサービスです。

🎯 ミッション

マイクロペイメントでゲートされたAPIエンドポイントとMCPツールを通じて、遅延30秒未満の実用的かつリアルタイムなマーケットインテリジェンスを提供します。成功 = 通話ごとにROIを測定可能な実用的アラートです！

Related MCP server: Enterprise Crypto MCP Gateway

💰 価格戦略

x402のマーケットリサーチに基づく（中央値 $0.014、約90%が$0.10未満）：

無料ティア: 月50コール、5回/分のレート制限
プロティア: 無制限クォータ、120回/分、優先決済

🛠️ MCPツール

コアインテリジェンスツール

1. fetch_price() ⭐ 無料ティア込み

   • CoinGecko APIから現在価格を取得

   • 対応: BTC、ETH、トップ100のアルトコイン

   • レスポンス: { symbol, price_usd, change_24h, volume }

2. analyze_volatility()

   • Zスコア統計分析による価格異常の検知

   • しきい値を設定可能（デフォルト: 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の出力形式

📦 有料複合プロダクト

• US Rental Diligence Pack（都市コンプライアンス連携による）: $1.50

  • 賃貸ライセンス、違反履歴、テナント権利を突き合わせ

  • 複数物件のバッチ処理

  • 自治体のオープンデータ結合

• パルスレポート**: $0.05

  • ベースネットワークの探索 + マーケット指標

  • 12ブロックのサンプル深度

  • リアルタイムのスポット価格統合

• TX Decision Fee: $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が実行するもの:

• ✅ Python 3.12でのPytest

• ✅ ダッシュボードでのVitest

• ✅ セキュリティスキャン（秘密情報検出、SAST）

• ✅ カバレッジチェック（>80%）

• ✅ Dockerビルド & プッシュ

📊 観測性

メトリクスエンドポイント

• /stats - 利用統計のライブ

• /ledger/{主題} - 決済履歴

• /quota/{agent_id} - 残りのクォータ

• /swarm/stats - 自律エージェンシーのメトリクス

イベントストリーム

/events でSSEを購読するとリアルタイムに以下を取得できます:

• ツールの実行ログ

• 決済の確認

• クォータの更新

• Swarmのフェーズ遷移

🔒 セキュリティ

• ✅ 秘密鍵をコミットしない（ .env は常に .no Jin）

• ✅ すべてのURLプローブにSSRFガード

• ✅ エージェントごとのレート制限per agent_idは

• ✅ 決済用の冪等性キー

• ✅ KEY_PROVIDER シームによるキーローテーション対応

• ✅ レスポンスに例外の内部情報を絶対に含めない

販売者キーと購入者キーの使い分け:

• RECEIVE ADDRESS: 収益を受け取るコールドウォレット（購入者用とは別に）

• BUYER KEY: アップストリームコストの支払い専用コールドウォレット（受取には決して使用しない）

• EVM_PRIVATE_KEY はRenderに絶対に配置しないでください - ローカルのみ！

🌐 デプロイ

ライブダッシュボード: 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 でデプロえば自動設定されます:

• ポート8403でWebサービス

• 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.activated の場合, 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 Market Intelligence

• タグ: base,intelligence,crypto,market,x402,mcp

• 所有権の証明: 受取アドレスで署名

• カタログURL: https://alpha-sentinel-mcp.onrender.com/.well-known/x402

🎓 ドキュメント

• User Guide - ツールの使い方

• セットアップ手順 - ローカル + デプロイ準備

• Agent Ops - コストを最適化した運用モード

• 都市コンプライアンス - 複数都市のコンプライアンスデータ

🏆 成功指標

• アラート遅延: 30秒未満（エンドツーエンド）

• 決済成功率: 初回で95%以上

• LTV:CAC比: 目標 ≥ 3.0

• 利益率下限: 複合プロダクトで50%以上

• クォータ利用率: プロ 層転換率70%以上

🙏 クレジット

AI Agency Factoryエコシステムの一環として、Keith（ kwizzlesurp10-ctrl ）によって構築されました。インスピレーションは、KarpathyのLLM Wikiのナレッジ整理アプローチとx402マイクロペイメント革命から得ています。

特別協力に感謝:

• Coinbase CDPチーム（x402ファシリテータ/調整者）

• FastAPI + FastMCPのメンテナーたち

• オープンソースのx402コミュニティ全体

📄 ライセンス

MIT - 商用利用可能、文章名を入れて頂けると嬉しいです！★彡

マーケットインテリジェンスで収益化する準備はできましたか? 　 👉 いますぐデプロイ 👉 ユーザーガイドを読む 👉 ダッシュボードを見る

(◕‿◕) ✨ Predictive intelligence, powered by on-chain economics! ♪