CryptoTwitter.Space x402 MCP Server

Proporciona acceso de pago por uso a informes premium de CryptoTwitter.Space con distribución automatizada de ingresos.

GitHubPrueba este MCPPatrocinado

Documentación

CryptoTwitter.Space x402 MCP Server

🚀 Entrada para el Hackathon "Agents in Action"

CryptoTwitter.Space x402 MCP Server es una entrada para el hackathon "Agents in Action", que muestra el poder del comercio autónomo en cadena utilizando x402pay y CDP Wallet con un MCP Server integrado con pagos x402.

✨ Resumen del Proyecto

Esta aplicación actúa como un servicio de micro-SaaS, proporcionando acceso restringido y de pago por uso a informes premium de CryptoTwitter.Space. Aprovecha x402pay para una monetización fluida y CDP Wallet Smart Accounts para dividir y distribuir automáticamente los ingresos entre múltiples partes interesadas (anfitrión, curador de contenido y plataforma).

La innovación radica en su capacidad para impulsar el comercio agéntico con pagos automatizados, demostrando un ciclo completo de generación de ingresos para un flujo de datos propietario. Además, se integra con MCP para permitir una interacción estructurada, permitiendo a los usuarios consultar y comprar informes de forma programática.

Actualmente con intervención humana, este sistema está diseñado para evolucionar hacia la autonomía total en futuras iteraciones, impulsado por un personaje de IA con una personalidad única, una narrativa rica y una historia convincente en plataformas como Virtuals o Eliza.

💡 Problema Resuelto

En cripto, la velocidad hacia la señal lo es todo—pero los traders humanos no pueden escuchar cada conversación en vivo, y las herramientas de IA carecen del contexto para saber qué es lo más importante en tiempo real.

Lo que falta es un agente copiloto: uno que entienda la intención del trader, escuche el audio en vivo, extraiga información crítica y la entregue en el momento exacto en que se necesita—antes de que el mercado reaccione.

Pero el problema más profundo es económico: las señales valiosas se comparten en foros públicos, pero no hay incentivo para que anfitriones, oradores o curadores saquen a la luz, estructuren y distribuyan esa información. El trader sufre porque el alfa de alta señal se pierde en el ruido, ya que el mercado no tiene mecanismo para recompensar a quienes la encuentran primero.

CryptoTwitter.Space x402 MCP Server resuelve el problema del trader convirtiendo la información en una clase de activo monetizable. Los Informes Alfa de Pago se comparten instantáneamente en ingresos mediante contratos inteligentes entre el anfitrión del Space, el curador del informe y la plataforma—creando una nueva economía de incentivos en torno al descubrimiento de señales. Esta es la base de InfoFi—una capa financiera para información en tiempo real.

⚙️ Caso de Uso: Búsqueda de Alfa de Bitcoin

Un trader de cripto se despierta ante un mercado en rápido movimiento y quiere ponerse al día con los acontecimientos de la noche.

En lugar de desplazarse sin fin por X o escuchar repeticiones de Twitter Spaces, interactúa con el CryptoTwitter.Space MCP Server e ingresa una consulta simple:

Búsqueda: "¿Qué está pasando con bitcoin?"

El MCP Server con pagos x402 devuelve instantáneamente una lista de informes curados con marcas de tiempo generados a partir de Twitter Spaces en vivo donde se discutió Bitcoin.

Cada informe incluye:

  • Citas clave y resúmenes de temas
  • Clasificaciones de sentimiento alcista o bajista
  • Enlaces al audio original para verificación
  • Desgloses de oradores y etiquetas de narrativas emergentes

Pagan una pequeña tarifa para desbloquear el informe completo. Instantáneamente:

  • El Anfitrión que dirigió el programa recibe el 50% del pago
  • El Curador que generó el informe recibe el 30%
  • La Plataforma retiene el 20%

Al final de la sesión, el trader tiene el contexto que otros se perdieron—y el ecosistema que sacó a la luz la señal recibe su recompensa. El volante de incentivos gira.

🌟 Características Clave

  • Acceso a Contenido de Pago por Uso (x402pay): Monetiza el acceso a informes premium de CryptoTwitter.Space por vista.
  • Distribución Automatizada de Ingresos (CDP Wallet Smart Account): Implementa un ciclo de pago completo donde los pagos entrantes de USDC se dividen y distribuyen automáticamente a:
    • Anfitrión (50%)
    • Curador (30%)
    • Plataforma (20%)
  • Lógica Componible y Modular: Diseñada para su reutilización, demostrando una clara separación de responsabilidades entre el manejo de pagos y la distribución.
  • Interacción Estructurada (MCP): Se integra con MCP Server con pagos x402 para proporcionar una interfaz programática para consultar y acceder a informes de pago.
  • Relevancia en el Mundo Real: Resuelve una necesidad tangible para creadores y plataformas que buscan monetizar activos digitales y gestionar pagos de manera eficiente en cadena.

📺 Demo

Ver la Demostración Completa

Watch the Full Demonstration

🛠️ Tecnologías Utilizadas

  • x402pay: Para una monetización fluida de pago por uso.
  • Coinbase Developer Platform (CDP) Wallet: Para cuentas inteligentes programables y seguras y flujos cripto automatizados.
  • Express.js: Servidor API backend (src/x402ExpressServer.ts).
  • TypeScript / Node.js
  • MCP Server con pagos x402: Para interacción estructurada y acceso programático a informes.
  • viem: Para utilidades de interacción con Ethereum.

🏆 Cómo Aborda los Criterios de Evaluación

Este proyecto aborda directamente los criterios de evaluación del hackathon:

  • Uso efectivo tanto de x402pay como de CDP Wallet: Demostramos x402pay para cobrar a los usuarios por informe y CDP Wallet para gestionar los flujos cripto posteriores, incluyendo la división y distribución automática de fondos a múltiples destinatarios.
  • Integridad del ciclo de pago: ingresos entrantes → pagos salientes: El sistema automatiza completamente el proceso desde que un usuario realiza un pago a través de x402 hasta la distribución posterior de fondos a las billeteras del anfitrión, curador y plataforma mediante CDP Wallet.
  • Relevancia en el mundo real: resuelve una necesidad o caso de uso real: Este proyecto brinda una ventaja tangible a los traders al sacar a la luz alfa en tiempo real de conversaciones de audio en vivo—información que de otro modo se perderían. Al mismo tiempo, crea una estructura de incentivos que recompensa a quienes sacan a la luz y estructuran información valiosa, incluidos anfitriones de Space, curadores de informes y la propia plataforma. Esto alinea los incentivos económicos en toda la cadena de suministro de información, convirtiendo el descubrimiento de señales en un mercado autosostenible.
  • Componibilidad: flujos reutilizables, plantillas o lógica modular: La lógica central de pago y distribución está encapsulada en src/smartDistribution.ts, lo que la hace reutilizable. El servidor Express proporciona un límite de API claro.
  • Creatividad: agentes novedosos o nuevos primitivos financieros: Al combinar el acceso de pago por uso con la distribución automatizada en cadena entre múltiples partes orquestada por el x402 Express Server, se crea un primitivo financiero novedoso para la monetización de APIs.
  • Ejecución técnica: código limpio y funcional con demo en video: El código base está bien estructurado, es funcional y se demuestra mediante un video completo.
  • Uso efectivo y creativo de MCP: El proyecto integra completamente MCP Server con pagos x402 para actuar como la interfaz principal para los usuarios, demostrando cómo la interacción estructurada puede orquestar flujos de trabajo financieros complejos en cadena.

💰 Pagos Verificables en Cadena

⚙️ Configuración Local (para Jueces)

Para ejecutar el servidor localmente:

  1. Clonar el repositorio: 
    git clone https://github.com/benschiller/cts-x402-mcp.git
cd cts-x402-mcp
  2. Instalar dependencias: 
    npm install
  3. Configurar Variables de Entorno: Copie el archivo de ejemplo para comenzar: 
    cp .env.example .env
    Luego abra .env y complételo con sus claves API y direcciones específicas: 
    # Example .env content - FILL IN YOUR ACTUAL VALUES
# x402 Express Server (Smart Account)
RECEIVING_WALLET_ADDRESS=0x...

# x402 User Agent
PRIVATE_KEY=...

# CDP Smart Account
CDP_API_KEY_ID=...
CDP_API_KEY_SECRET=...
CDP_WALLET_SECRET=...

# CDP Payouts
HOST_ADDRESS=0x...
CURATOR_ADDRESS=0x...
PLATFORM_ADDRESS=0x...
SMART_ACCOUNT_ADDRESS=0x...

# USDC on Base Sepolia
USDC_CONTRACT_ADDRESS=0x036CbD53842c5426634e7929541eC2318f3dCF7e

# Reports Base URL (do not change for hackathon)
REPORTS_API_BASE=https://cryptotwitter.space
  4. Ejecutar el servidor: 
    npm run start:express
    El servidor se iniciará en http://localhost:4021.

Configuración del Cliente MCP (por ejemplo, Claude o Cursor)

Para conectar un cliente MCP como Claude o Cursor al MCP Server with x402 Payments, siga estos pasos:

1. Configurar x402McpServer.json

Asegúrese de que su archivo src/x402McpServer.json contenga la siguiente configuración:

{
  "mcpServers": {
    "cts-reports-x402": {
      "autoApprove": [
        "search-reports",
        "browse-reports",
        "get-report-resource"
      ],
      "timeout": 60,
      "type": "stdio",
      "command": "node",
      "args": [
        "dist/x402McpServer.js"  // Path to your compiled server file
      ],
      "env": {
        "PRIVATE_KEY": "your_private_key_here"
      }
    }
  }
}

2. Ajustes Requeridos

  • Ruta al Archivo del Servidor:
    Actualice "dist/x402McpServer.js" para que apunte a su archivo de servidor compilado real (por ejemplo, "build/x402McpServer.js" si usa un directorio de compilación diferente).

  • Clave Privada:
    Reemplace "your_private_key_here" con la clave privada de la billetera que maneja los pagos x402.

3. Iniciar el MCP Server

Ejecute el servidor usando el comando configurado:

node dist/x402McpServer.js

4. Conectar Su Cliente MCP

Apunte su cliente MCP (por ejemplo, Claude o Cursor) a esta configuración para habilitar la interacción con el servidor. El cliente ahora debería poder:

  • Buscar informes (search-reports)
  • Explorar informes (browse-reports)
  • Recuperar contenido de pago (get-report-resource)

Notas

  • Asegúrese de que el servidor esté ejecutándose antes de conectar el cliente.