CryptoTwitter.Space x402 MCP Server

Fornece acesso por uso pago a relatórios premium do CryptoTwitter.Space com distribuição automatizada de receita.

GitHubExperimente este MCPPatrocinado

Documentação

CryptoTwitter.Space x402 MCP Server

🚀 Inscrição no Hackathon Agents in Action

CryptoTwitter.Space x402 MCP Server é uma inscrição para o hackathon "Agents in Action", demonstrando o poder do comércio autônomo on-chain usando x402pay e CDP Wallet com MCP Server integrado com pagamentos x402.

✨ Visão Geral do Projeto

Este aplicativo atua como um serviço de micro-SaaS, fornecendo acesso pago por uso a relatórios premium do CryptoTwitter.Space. Ele aproveita x402pay para monetização contínua e CDP Wallet Smart Accounts para dividir e distribuir automaticamente a receita entre múltiplas partes interessadas (anfitrião, curador de conteúdo e plataforma).

A inovação está na capacidade de capacitar comércio agêntico com pagamentos automatizados, demonstrando um ciclo completo de geração de receita para um fluxo de dados proprietário. Além disso, integra-se com MCP para permitir interação estruturada, permitindo que usuários consultem e comprem relatórios programaticamente.

Atualmente com intervenção humana (human-in-the-loop), este sistema foi projetado para evoluir em direção à autonomia total em iterações futuras, impulsionado por um personagem de IA com personalidade única, narrativa rica e história convincente em plataformas como Virtuals ou Eliza.

💡 Problema Resolvido

Em cripto, velocidade até o sinal é tudo—mas traders humanos não conseguem ouvir todas as conversas ao vivo, e ferramentas de IA não têm contexto para saber o que importa mais em tempo real.

O que falta é um agente copiloto: um que entenda a intenção do trader, ouça áudio ao vivo, extraia informações críticas e as entregue no momento exato em que são necessárias—antes que o mercado reaja.

Mas o problema mais profundo é econômico: sinais valiosos estão sendo compartilhados em fóruns públicos, mas não há incentivo para anfitriões, palestrantes ou curadores destacarem, estruturarem e distribuírem essa informação. O trader sofre porque o alpha de alto sinal se perde no ruído, pois o mercado não tem mecanismo para recompensar aqueles que o encontram primeiro.

CryptoTwitter.Space x402 MCP Server resolve o problema do trader transformando informação em uma classe de ativos monetizável. Relatórios Alpha pagos são imediatamente compartilhados em receita via contratos inteligentes entre o anfitrião do Space, o curador do relatório e a plataforma—criando uma nova economia de incentivos em torno da descoberta de sinais. Esta é a base do InfoFi—uma camada financeira para informações em tempo real.

⚙️ Caso de Uso: Buscando Alpha de Bitcoin

Um trader de cripto acorda em um mercado em movimento rápido e quer se atualizar sobre os desenvolvimentos da noite.

Em vez de rolar infinitamente pelo X ou ouvir replays de Twitter Spaces, ele interage com o CryptoTwitter.Space MCP Server e insere uma consulta simples:

Busca: "O que está acontecendo com o bitcoin?"

O MCP Server com pagamentos x402 retorna instantaneamente uma lista de relatórios com carimbo de data/hora, curados a partir de Twitter Spaces ao vivo onde Bitcoin foi discutido.

Cada relatório inclui:

  • Citações-chave e resumos de tópicos
  • Classificações de sentimento de alta (bullish) ou baixa (bearish)
  • Links para o áudio original para verificação
  • Detalhamento de palestrantes e tags de narrativas emergentes

Eles pagam uma pequena taxa para desbloquear o relatório completo. Instantaneamente:

  • O Anfitrião que conduziu o programa recebe 50% do pagamento
  • O Curador que gerou o relatório recebe 30%
  • A Plataforma retém 20%

Ao final da sessão, o trader tem contexto que outros perderam—e o ecossistema que trouxe o sinal à tona é recompensado. O volante de incentivos gira.

🌟 Principais Recursos

  • Acesso a Conteúdo Pago por Uso (x402pay): Monetiza o acesso a relatórios premium do CryptoTwitter.Space por visualização.
  • Distribuição Automatizada de Receita (CDP Wallet Smart Account): Implementa um ciclo completo de pagamento onde pagamentos USDC recebidos são automaticamente divididos e distribuídos para:
    • Anfitrião (50%)
    • Curador (30%)
    • Plataforma (20%)
  • Lógica Composável e Modular: Projetado para reutilização, demonstrando uma clara separação de responsabilidades entre tratamento de pagamento e distribuição.
  • Interação Estruturada (MCP): Integra-se com MCP Server com pagamentos x402 para fornecer uma interface programática para consultar e acessar relatórios pagos.
  • Relevância no Mundo Real: Resolve uma necessidade tangível para criadores e plataformas que buscam monetizar ativos digitais e gerenciar pagamentos de forma eficiente on-chain.

📺 Demonstração

Assista à Demonstração Completa

Watch the Full Demonstration

🛠️ Tecnologias Utilizadas

  • x402pay: Para monetização contínua paga por uso.
  • Coinbase Developer Platform (CDP) Wallet: Para contas inteligentes programáveis e seguras e fluxos cripto automatizados.
  • Express.js: Servidor de API backend (src/x402ExpressServer.ts).
  • TypeScript / Node.js
  • MCP Server com pagamentos x402: Para interação estruturada e acesso programático a relatórios.
  • viem: Para utilitários de interação com Ethereum.

🏆 Como Atende aos Critérios de Avaliação

Este projeto aborda diretamente os critérios de avaliação do hackathon:

  • Uso eficaz de x402pay e CDP Wallet: Demonstramos x402pay para cobrar usuários por relatório e CDP Wallet para gerenciar os fluxos cripto subsequentes, incluindo divisão e distribuição automática de fundos para múltiplos destinatários.
  • Completude do ciclo de pagamento: receita recebida → pagamento enviado: O sistema automatiza completamente o processo desde um usuário fazendo um pagamento via x402 até a distribuição subsequente de fundos para as carteiras do anfitrião, curador e plataforma via CDP Wallet.
  • Relevância no mundo real: resolve uma necessidade ou caso de uso real: Este projeto entrega uma vantagem tangível para traders ao trazer à tona alpha em tempo real de conversas de áudio ao vivo—insights que eles de outra forma perderiam. Ao mesmo tempo, cria uma estrutura de incentivos que recompensa aqueles que trazem à tona e estruturam informações valiosas, incluindo anfitriões de Space, curadores de relatórios e a própria plataforma. Isso alinha incentivos econômicos em toda a cadeia de suprimentos de informação, transformando a descoberta de sinais em um mercado autossustentável.
  • Composabilidade: fluxos reutilizáveis, templates ou lógica modular: A lógica central de pagamento e distribuição está encapsulada em src/smartDistribution.ts, tornando-a reutilizável. O servidor Express fornece um limite de API claro.
  • Criatividade: agentes inovadores ou novos primitivos financeiros: Ao combinar acesso pago por uso com distribuição on-chain automatizada para múltiplas partes orquestrada pelo x402 Express Server, cria um novo primitivo financeiro para monetização de APIs.
  • Execução técnica: código limpo e funcional com demonstração em vídeo: A base de código é bem estruturada, funcional e demonstrada por meio de um vídeo abrangente.
  • Uso eficaz e criativo de MCP: O projeto integra totalmente o MCP Server com pagamentos x402 para atuar como a interface principal para usuários, demonstrando como interação estruturada pode orquestrar fluxos de trabalho financeiros on-chain complexos.

💰 Pagamentos On-chain Verificáveis

⚙️ Configuração Local (para Juízes)

Para executar o servidor localmente:

  1. Clone o repositório: 
    git clone https://github.com/benschiller/cts-x402-mcp.git
cd cts-x402-mcp
  2. Instale as dependências: 
    npm install
  3. Configure as Variáveis de Ambiente: Copie o arquivo de exemplo para começar: 
    cp .env.example .env
    Em seguida, abra .env e preencha com suas chaves de API e endereços específicos: 
    # 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. Execute o servidor: 
    npm run start:express
    O servidor iniciará em http://localhost:4021.

Configurando o Cliente MCP (ex.: Claude ou Cursor)

Para conectar um cliente MCP como Claude ou Cursor ao MCP Server with x402 Payments, siga estes passos:

1. Configure x402McpServer.json

Certifique-se de que seu arquivo src/x402McpServer.json contenha a seguinte configuração:

{
  "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 Necessários

  • Caminho para o Arquivo do Servidor:
    Atualize "dist/x402McpServer.js" para apontar para o seu arquivo de servidor compilado real (ex.: "build/x402McpServer.js" se estiver usando um diretório de build diferente).

  • Chave Privada:
    Substitua "your_private_key_here" pela chave privada da carteira que gerencia os pagamentos x402.

3. Inicie o Servidor MCP

Execute o servidor usando o comando configurado:

node dist/x402McpServer.js

4. Conecte Seu Cliente MCP

Aponte seu cliente MCP (ex.: Claude ou Cursor) para esta configuração para habilitar a interação com o servidor. O cliente agora deve ser capaz de:

  • Buscar relatórios (search-reports)
  • Navegar por relatórios (browse-reports)
  • Recuperar conteúdo pago (get-report-resource)

Notas

  • Certifique-se de que o servidor esteja em execução antes de conectar o cliente.