Alpha Sentinel - Inteligencia de Mercado x402 MCP Server

⭐ ¡Agente de inteligencia predictiva ganando recompensas on-chain! ★

Un servicio de marketplace x402 de producción que ofrece monitorización del mercado de criptomonedas en tiempo real, alertas de volatilidad y análisis de sentimiento como herramientas MCP de pago para agentes de IA.

🎯 Misión

Entregar inteligencia de mercado accionable y en tiempo real con una latencia menor a 30 s a través de endpoints de API con micropagos y herramientas MCP. ¡Éxito = alertas accionables con ROI medible por llamada!

Related MCP server: Enterprise Crypto MCP Gateway

💰 Estrategia de precios

Según la investigación de mercado de x402 (mediana de $0.014, cerca del 90% por debajo de $0.10):

Nivel gratuito: 50 llamadas/mes, límite de 5/min
Nivel Pro: Cuota ilimitada, 120/min, liquidación prioritaria

🛠️ Herramientas MCP

Herramientas principales de inteligencia

1. fetch_price() ⭐ Incluido en el nivel gratuito

   • Obtén el precio actual de la API de CoinGecko

   • Admite: BTC, ETH y las 100 principales altcoins

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

2. analyze_volatility()

   • Detecta anomalías de precio mediante análisis estadístico con puntuación Z

   • Umbrales configurables (por defecto: 2σ)

   • Devuelve puntuaciones de anomalía y niveles de alerta

3. aggregate_sentiment()

   • Agregación de fuentes de X/Twitter, Reddit, Telegram

   • Puntuación de sentimiento basada en PLN (-1.0 a +1.0)

   • Detección de tendencias e indicadores de impulso

4. calculate_risk_score()

   • Evaluación de riesgo multifactorial (volatilidad, liquidez, correlación)

   • Nivel de riesgo: BAJO/MEDIO/ALTO/CRÍTICO

   • Incluye intervalos de confianza

5. generate_market_report()

   • Informes completos diarios/semanales/mensuales

   • Combina todas las fuentes de datos

   • Formatos de salida PDF + JSON

📦 Productos compuestos de pago

• Paquete de diligencia de alquiler en EE. UU. (mediante la integración de cumplimiento municipal): $1.50

  • Cruza referencias de licencias de alquiler, infracciones y derechos de los inquilinos

  • Procesamiento por lotes de múltiples propiedades

  • Uniones con datos municipales abiertos

• Informe Pulse: $0.05

  • Síntesis de la red base + métricas de mercado

  • Profundidad de muestra de 12 bloques

  • Integración de precios al contado en tiempo real

• Tarifa de decisión de transacción: $0.01

  • Capa económica residente en bucle para comprobaciones previas a la negociación

  • Retroalimentación inmediata antes de las transacciones en la cadena principal

🏗️ Arquitectura

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

🚀 Inicio rápido

Requisitos previos

• Python 3.12+

• Redis (opcional, para producción)

• Credenciales de vendedor x402 (separadas de las del comprador)

• Clave de API de CoinGecko (el nivel gratuito funciona)

Configuración

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

Variables de entorno

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

🔧 Desarrollo

Ejecución de pruebas

# 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

Cómo añadir nuevas herramientas MCP

Sigue el patrón en app/tools_registry.py:

1. Añade la especificación de la herramienta a la lista TOOL_SPECS

2. Implementa el controlador en el directorio app/intelligence/

3. Regístrate en app/mcp_server.py

4. Actualiza el README con la nueva fila de la tabla de herramientas

5. Ejecuta scripts/capture_goal_evidence.py para actualizar los artefactos de prueba

Recuerda: ¡El registro de herramientas es la ÚNICA FUENTE DE VERDAD! Si tocas algo, actualiza todos los archivos relacionados o el CI fallará.

Canal de CI/CD

GitHub Actions ejecuta:

• ✅ Pytest en Python 3.12

• ✅ Vitest en el panel de control

• ✅ Escaneos de seguridad (detección de secretos, SAST)

• ✅ Verificación de cobertura (>80 %)

• ✅ Compilación y publicación de Docker

📊 Observabilidad

Endpoints de métricas

• /stats — Estadísticas de uso en tiempo real

• /ledger/{name} — Historial de liquidaciones

• /quota/{agent_id} — Cuota restante

• /swarm/stats — Métricas de agencias autónomas

Flujo de eventos

Suscríbete a SSE en /events para ver en tiempo real:

• Registros de ejecución de herramientas

• Confirmaciones de liquidación

• Actualizaciones de cuota

• Transiciones de fase de Swarm

🔒 Seguridad

• ✅ No se han commitizado claves privadas (.env siempre se ignora)

• ✅ Protección SSRF en todos los sondeos de URL

• ✅ Límites de tasa por agent_id

• ✅ Claves de idempotencia para liquidaciones

• ✅ Soporte de rotación de claves mediante el punto de integración KEY_PROVIDER

• ✅ Nunca se exponen los internis de las excepciones

Vendedor frente a claves de comprador:

• Dirección de recepción: Cartera fría para ingresos (separator de la del comprador)

• Clave de comprador: Cartera caliente SOLO para pagar costes derivados (nunca para recibir)

• NUNCA pongas EVM_PRIVATE_KEY en Render — solo local!

🌐 Despliegue

Panel en vivo: https://alpha-sentinel-mcp.vercel.app/ (próximamente)

Despliegue rápido en Vercel

Haz clic a continuación o sigue los pasos de DEPLOYMENT.md:

Despliegue manual

# Install Vercel CLI
npm install -g vercel

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

El panel de control trasplosará automáticamente las llamadas a la API de tu servidor desplegado

Render (API)

Despliega mediante render.yaml: configuración automática de:

• Servicio web en el puerto 8403

• Instancia de Redis (auto-provisionado)

• Variables de entorno almacenadas de forma segura

• Endpoint de comprobación de estado: /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

🤝 Integración con Swarm Agency

Cuando SWARM_ENABLED=true, Alpha Sentinel puede:

1. Scout — descubrir fuentes de datos upstream de x402

2. Warden — hacer cumplir los límites de gasto según ledger/policy.json

3. Tesorería — pagar los datos de upstream (único rol con capacidad de gasto)

4. Archivo — componer los productos compuestos con precio

5. Soberano — reajustar para una LTV:CAC objetivo ≥ 3.0

6. Mercado — listar los productos compuestos

Ejemplo: Compra precios brutos de 3 fuentes → agrega → revende como "Presto Bundle" con x3 de margen.

📈 Descubrimiento en el Bazar

Publicado en CDP Bazaar con:

• Nombre del servicio: Alpha Sentinel Market Intelligence

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

• Prueba de propiedad: firmada con la dirección de recepción

• URL del catálogo: https://alpha-sentinel-mcp.onrender.com/.well-known/x402

🎓 Documentación

• Guía de usuario — Cómo usar las herramientas

• Instrucciones de configuración — Configuración local y de despliegue

• Operaciones de agente — Modos de operación optimizados en costos

• Cumplimiento normativo — Datos de cumplimiento entrecidades

🏆 Métricas de éxito

• Latencia de alertas: <30seg de extremo a extremo

• Éxito de liquidación: >95 % al primer intento

• LTV:CAC: Objetivo ≥ 3.0

• Margen mínimo: ≥ 50 % en productos compuestos

• Utilización de cuota: >70 % de conversión al nivel Pro

🙏 Créditos

Creado por Keith (kwizzlesurp10-ctrl) como parte del ecosistema AI Agency Factory. Inspirado en el enfoque de Karpathy en LLM Wiki para la organización del conocimiento y la revolución de los micropayments x402.

Agradecimientos especiales a:

• Equipo de CDP de Coinbase por el facilitador x402

• Mantenedores de FastAPI y FastMCP

• Toda la comunidad open-source de x402

📄 Licencia

MIT — Libre para uso comercial, se agradece la atribución. ★彡

¿Listo para monetizar la inteligencia de mercado? 👉 Desplegar ahora 👉 Leer la guía de usuario 👉 Ver el panel

(◕‿◕) ✨ ¡Inteligencia predictiva, impulsada por la economía on-chain! ♪