Ground Truth MCP

Permite que los agentes de IA validen sus propias afirmaciones con datos reales y en vivo de la web.

URL en vivo: https://ground-truth-mcp.anish632.workers.dev

🎯 ¿Qué es Ground Truth?

Ground Truth es un servidor MCP que proporciona a los agentes de IA herramientas de verificación de hechos e investigación de mercado. En lugar de alucinar o adivinar, los agentes pueden:

• ✅ Comprobar si un endpoint de API realmente existe

• 📊 Contar competidores reales del mercado

• 💰 Extraer precios reales de sitios web

• 🔍 Comparar paquetes lado a lado

• 🧪 Contrastar afirmaciones con fuentes en vivo

• ⚗️ Probar hipótesis con pruebas estructuradas

Todos los resultados provienen de datos en vivo obtenidos en tiempo real, con caché de 5 minutos para mejorar el rendimiento.

🚀 Inicio rápido

Nivel gratuito (sin registro)

Prueba la herramienta check_endpoint inmediatamente:

curl -X POST https://ground-truth-mcp.anish632.workers.dev/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "check_endpoint",
      "arguments": {"url": "https://api.github.com"}
    },
    "id": 1
  }'

Nivel Pro ($9/mes)

1. Visita la página de precios

2. Suscríbete a través de Stripe

3. Obtén tu clave de API: gt_live_...

4. Añádela a las solicitudes:

curl -X POST https://ground-truth-mcp.anish632.workers.dev/mcp \
  -H "X-API-Key: gt_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"estimate_market","arguments":{"query":"react","registry":"npm"}},"id":1}'

🛠️ Herramientas disponibles

Documentación completa de la API: API_USAGE.md

💰 Precios

Nivel gratuito

• check_endpoint - Ilimitado para siempre

Nivel Pro - $9/mes

• Las 5 herramientas premium - Uso ilimitado

• Caché de 5 minutos - Respuestas rápidas

• SLA de tiempo de actividad del 99.9%

• Cancela en cualquier momento - Sin preguntas

Suscríbete ahora →

🏗️ Stack tecnológico

• Runtime: Cloudflare Workers (computación en el borde)

• Almacenamiento: Durable Objects con SQLite (caché + registros de uso)

• Claves de API: Cloudflare KV (cifradas en reposo)

• Facturación: Stripe Checkout + Suscripciones

• Protocolo: Model Context Protocol (MCP)

• Lenguaje: TypeScript

📚 Documentación

• SETUP.md - Guía de despliegue y configuración

• API_USAGE.md - Referencia de API y ejemplos

• IMPLEMENTATION_SUMMARY.md - Detalles de implementación

🔧 Desarrollo

Requisitos previos

• Node.js 18+

• npm o pnpm

• Cuenta de Cloudflare

• Cuenta de Stripe

Configuración local

1. Clona el repositorio:

cd "/Users/anishdas/Apps/Ground Truth/ground-truth-mcp"

2. Instala las dependencias:

npm install

3. Crea el espacio de nombres KV:

npx wrangler kv namespace create API_KEYS

4. Actualiza wrangler.jsonc con el ID del espacio de nombres KV

5. Establece los secretos:

npx wrangler secret put STRIPE_SECRET_KEY
npx wrangler secret put STRIPE_WEBHOOK_SECRET

6. Ejecuta localmente:

npm start
# or
npx wrangler dev

7. Despliega:

npm run deploy
# or
npx wrangler deploy

Guía de configuración completa: SETUP.md

🧪 Pruebas

Probar nivel gratuito (sin autenticación)

curl -X POST http://localhost:8787/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "check_endpoint",
      "arguments": {"url": "https://example.com"}
    },
    "id": 1
  }'

Probar rechazo de autenticación

# Should return 402 (payment required)
curl -X POST http://localhost:8787/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "estimate_market",
      "arguments": {"query": "test", "registry": "npm"}
    },
    "id": 1
  }'

Probar Stripe Checkout

1. Visita http://localhost:8787/pricing

2. Haz clic en "Subscribe Now"

3. Usa la tarjeta de prueba: 4242 4242 4242 4242

4. Completa el pago

5. Verifica que la clave de API se muestre en la página de éxito

🔐 Seguridad

• Claves de API: Almacenadas en Cloudflare KV (cifradas en reposo)

• Claves de Stripe: Almacenadas como secretos de Worker (cifradas)

• Validación de Webhook: Verificación de firma (simplificada para MVP)

• Revocación de claves: Claves inactivas marcadas al cancelar la suscripción

• Pista de auditoría: Las claves no se eliminan, solo se marcan como inactivas

🚦 Estado y monitoreo

• Página principal: https://ground-truth-mcp.anish632.workers.dev

• Estadísticas: https://ground-truth-mcp.anish632.workers.dev/stats

• Panel de Stripe: https://dashboard.stripe.com

• Panel de Cloudflare: https://dash.cloudflare.com

📊 Arquitectura

┌─────────────┐
│   User      │
└──────┬──────┘
       │
       ├─── Free Tier (no auth)
       │    └─► check_endpoint
       │
       ├─── Pro Tier (API key)
       │    ├─► X-API-Key header
       │    ├─► Validate against KV
       │    └─► estimate_market, check_pricing, etc.
       │
       └─── x402 (fallback)
            └─► Crypto payment for single call
       
┌─────────────────────────────────────┐
│   Cloudflare Worker                  │
├─────────────────────────────────────┤
│  ┌──────────────┐  ┌──────────────┐ │
│  │ Auth         │  │ Stripe       │ │
│  │ Middleware   │  │ Integration  │ │
│  └──────────────┘  └──────────────┘ │
│         │                 │          │
│  ┌──────▼──────┐  ┌──────▼────────┐ │
│  │ KV Store    │  │ Durable       │ │
│  │ (API Keys)  │  │ Objects       │ │
│  └─────────────┘  │ (Cache+Logs)  │ │
│                   └───────────────┘ │
└─────────────────────────────────────┘

🤝 Contribuciones

No se aceptan contribuciones externas en este momento (proyecto privado), pero siéntete libre de hacer un fork para tu propio uso.

📜 Licencia

Licencia MIT - consulta el archivo LICENSE para más detalles

🆘 Soporte

• Correo electrónico: anishdasmail@gmail.com

• Problemas: https://github.com/anish632/ground-truth-mcp/issues

• Twitter: @anish632

🎯 Casos de uso

Para agentes de IA

• Validar investigación de mercado antes de presentar hallazgos

• Verificar hechos contra fuentes en vivo

• Comparar competidores con datos reales

• Probar hipótesis con verificación estructurada

Para desarrolladores

• Pre-validar APIs antes de recomendarlas

• Comprobar precios sin scraping web manual

• Estimar recuentos de paquetes para dimensionar el mercado

• Verificación de hechos automatizada en CI/CD

Para investigadores

• Contrastar afirmaciones con datos en vivo

• Rastrear versiones de paquetes a lo largo del tiempo

• Monitorear cambios de precios

• Validar hipótesis académicas

🏆 ¿Qué hace diferente a Ground Truth?

✅ Datos en vivo: Sin bases de datos obsoletas, todos los resultados provienen de la obtención en tiempo real ✅ Caché: Caché de 5 minutos para rendimiento sin sacrificar frescura ✅ Nativo de MCP: Creado para agentes de IA desde el primer día ✅ Computación en el borde: Respuestas rápidas desde la red global de Cloudflare ✅ Nivel gratuito: No se requiere tarjeta de crédito para probarlo ✅ Precios transparentes: $9/mes, uso ilimitado, sin tarifas ocultas ✅ Respaldo x402: Pago por llamada con cripto si no deseas una suscripción

📈 Hoja de ruta

• [x] Herramientas principales de verificación de hechos

• [x] Integración de facturación con Stripe

• [x] Autenticación con clave de API

• [x] Nivel gratuito (check_endpoint)

• [x] Manejo de webhooks para suscripciones

• [ ] Panel de análisis de uso

• [ ] Notificaciones por correo electrónico

• [ ] Cuentas de equipo

• [ ] Nivel empresarial

• [ ] Integraciones personalizadas

🙏 Agradecimientos

• Creado con MCP SDK

• Impulsado por Cloudflare Workers

• Pagos por Stripe

• Integración x402 por @x402

Hecho con ❤️ por Anish Das

Última actualización: 20 de marzo de 2026