Alpha Sentinel - Marktintelligenz-x402-MCP-Server

⭐ Prädiktiver Intelligenz-Agent sammelt Belohnungen on-chain ein! ★

Ein produktionsreifer x402-Marktplatzdienst, der Echtzeit-Krypto-Marktüberwachung, Volatilitätswarnungen und Sentiment-Analyse als kostenpflichtige MCP-Tools für KI-Agenten bereitstellt.

🎯 Mission

Liefern Sie handlungsrelevante, in Echtzeit bereitgestellte Marktintelligenz mit einer Latenz von unter 30s über per Micropayment zugangsbeschränkte API-Endpunkte und MCP-Tools. Erfolg = handlungsrelevante Warnungen mit messbarem ROI pro Aufruf!

Related MCP server: Enterprise Crypto MCP Gateway

💰 Preisstrategie

Basierend auf der x402-Marktforschung (Median $0.014, ~90% unter $0.10):

Kostenlose Stufe: 50 Aufrufe/Monat, 5/Min Rate-Limit
Pro-Stufe: Unbegrenztes Kontingent, 120/Min, priorisierte Abwicklung

🛠️ MCP-Tools

Zentrale Intelligenz-Tools

1. fetch_price() ⭐ In der kostenlosen Stufe enthalten

   • Aktuellen Preis von der CoinGecko-API abrufen

   • Unterstützt: BTC, ETH und Top-100-Altcoins

   • Antwort: {symbol, price_usd, change_24h, volume}

2. analyze_volatility()

   • Preis-Anomalien mithilfe der Z-Score-Statistik erkennen

   • Konfigurierbare Schwellenwerte (Standard: 2σ)

   • Liefert Anomalie-Scores und Alarmstufen

3. aggregate_sentiment()

   • Aggregation aus X/Twitter, Reddit- und Telegramm-Quellen

   • NLP-gestütztes Sentiment-Scoring (-1.0 bis +1.0)

   • Trend-Erkennung und Momentum-Indikatoren

4. calculate_risk_score()

   • Multi-Faktor-Risikobewertung (Volatilität, Liquidität, Korrelation)

   • Risikostufe: LOW/MEDIUM/HIGH/CRITICAL

   • Enthält Konfidenzintervalle

5. generate_market_report()

   • Umfassende Tages-, Wochen- und Monatsberichte

   • Kombiniert alle Datenquellen

   • PDF- und JSON-Ausgabeformate

📦 Kostenpflichtige Kompositprodukte

• US Rental Diligence Pack (über die Stadt-Compliance-Integration): $1.50

  • Gibtbst Mietlizenzen, Verstöße und Mieterrechte direkt wieder

  • Stapelverarbeitung für mehrere Objekte

  • Verknüpfung kommunaler Open Data

• Pulse-Report: $0.05

  • Base-Netzwerksynthese + Marktkennzahlen

  • Stichprobentiefe: 12 Blöcke

  • Echtzeit-Integration des Spot-Preises

• TX-Entscheidungsgebühr: $0.01

  • Günstige, in der Schleife residierende Stufe für Pre-Trade-Prüfungen

  • Sofortiges Feedback vor Mainnet-Transaktionen

🏗️ Architektur

┌─────────────────────────────────────────────────────┐
│           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)             │
│                                                      │
└─────────────────────────────────────────────────────┘

🚀 Schnellstart

Voraussetzungen

• Python 3.12+

• Redis (optional, für Produktionsumgebungen)

• x402-Verkäufer-Zugangsdaten (getrennt vom Käufer!)

• CoinGecko-API-Schlüssel (kostenloser Tarif funktioniert)

Einrichtung

# 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)

Umgebungsvariablen

# 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>

🔧 Entwicklung

Ausführung der Tests

# 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

Neue MCP-Tools hinzufügen

Folgen Sie dem Muster in app/tools_registry.py:

1. Tool-Spezifikation zur Liste TOOL_SPECS hinzufügen

2. Handler im Verzeichnis app/intelligence/ implementieren

3. In app/mcp_server.py registrieren

4. README mit neuer Zeile in der Tool-Tabelle aktualisieren

5. scripts/capture_goal_evidence.py ausführen, um Test-Artefakte zu aktualisieren

Wichtig: Die Tool-Registry ist die SINGLE SOURCE OF TRUTH! Aktualisieren Sie alle zugehörigen Dateien, sonst scheitert die CI.

CI/CD-Pipeline

GitHub Actions führt aus:

• ✅ Pytest unter Python 3.12

• ✅ Vitest auf dem Dashboard

• ✅ Sicherheitsscans (Geheimnis-Erkennung, SAST)

• ✅ Coverage-Prüfungen (> 80 %)

• ✅ Docker-Build und -Push

📊 Observability

Metrik-Endpunkte

• /stats – Live-Statistiken zur Nutzung

• /ledger/{name} – Abwicklungsverlauf

• /quota/{agent_id} – Verbleibendes Kontingent

• /swarm/stats – Kennzahlen der autonomen Agentur

Ereignisstrom

Abonnieren Sie SSE unter /events für Echtzeit-Events:

• Ausführungsprotokolle von Tools

• Settlement-Bestätigungen

• Kontingent-Updates

• Swarm-Phasenübergänge

🔒 Sicherheit

• ✅ Keine privaten Schlüssel im Repository (.env wird immer ignoriert)

• ✅ SSRF-Schutz bei allen URL-Prüfungen

• ✅ Rate-Limiting pro agent_id

• ✅ Idempotenzschlüssel für Settlements

• ✅ Unterstützung der Schlüsselrotation über die KEY_PROVIDER-Schnittstelle

• ✅ Interna von Ausnahmen niemals in Antworten offen

Verkäufer- und Käuferschlüssel:

• RECEIVE ADDRESS: Cold Wallet für Einnahmen (getrennt vom Käufer!)

• BUYER KEY: Heißes Wallet NUR zur Bezahlung von Upstream-Kosten (nie zum Empfang)

• EVM_PRIVATE_KEY NIEMALS auf Render legen – nur lokal!

|## 🌐 Bereitstellung

Live-Dashboard: https://alpha-sentinel-mcp.vercel.app/ (demnächst verfügbar)

Schnell Deployment bereitstellen

Klicken Sie unten oder befolgen Sie die Schritte in DEPLOYMENT.md:

Manuelles Deployment

# Install Vercel CLI
npm install -g vercel

# Deploy dashboard
cd /home/keef/alpha-sentinel-mcp
vercel --prod

Entsprechend leitet das Dashboard API-Aufrufe automatisch an Ihr bereitgestelltes Backend weiter!

Render (API)

Deployment über render.yaml – automatische Konfiguration:

• Webservice auf Port 8403

• Redis-Instanz (automatisch bereitgestellt)

• Umgebungsvariablen aus dem sicheren Store

• Health-Check-Endpunkt: /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-Agency-Integration

Wenn SWARM_ENABLE=true, kann Alpha Sentinel:

1. Scout – Upstream-x402-Datenquellen entgegen

2. Warden – Ausgabenlimit gemäß ledger/policy.json durchsetzen

3. Treasurer – Für Upstream-Daten bezahlen (einzige Rolle für Zahlungen)

4. Archivist – Preispflichtige Kompositprodukte zusammenstellen

5. Sovereign – Neubepreisen für Ziel-LTV:CAC ≥ 3.0

6. Merchant – Compositen anbieten

Beispiel-Komposit: Rohpreise von 3 Upstream-Anbietern kaufen → aggregieren → als „Premium-Paket“ mit 3-fachem Aufschlag weiterverkaufen!

📈 Bazaar-Erkundung

Gelistet im CDP Bazaar mit:

• Servicename: Alpha Sentinel Market Intelligence

• Tags: base,intelligence,crypto,market,x402,mcp

• Ownership-Beweis: mit der Empfangsadresse signiert

• Katalog-URL: https://alpha-sentinel-mcp.onrender.com/.well-known/x402

📚 Dokumentation

• Benutzer-Guide – So verwenden Sie die Tools

• Setup-Anleitung – Lokale und Deployment-Konfiguration

• Agent-Operationen – Kostenoptimierte Betriebsmodi

• City-Compliance – Multi-City-Compliance-Daten

🏆 Erfolgskennzahlen

• Alarmlatenz: < 30s von Ende zu Ende

• Settlement-Erfolg: > 95 % Fehler, beim ersten Versuch

• LTV:CAC-Verhältnis: Ziel ≥ 3.0

• ** Mindestspanne:: ≥ 50 % bei Kompositprodukten

• Kontingent-Nutzung: > 70 % Konvertierung zur Pro-Stufe

🙏 Danksagungen

Erstellt von Keith (zwizzlesurp10-ctrl) als Teil des AI Agency Factory-Ökosystems. Inspiriert von Karpathys LLM-Wiki-Ansatz für Wissensorganisation und der x402-Micropayment-Revolution!

Besonderer Dank geht an:

• Coinbase-CDP-Team für den x402-Facilitator

• FastAPI- und FastMCP-Maintainer

• The entire open-source x402 community

📄 Lizenz

MIT – Frei für den kommerziellen Einsatz, AngabeWerkstellung erwünscht!