tip.md x402 + CDP

Um servidor MCP para a plataforma tip.md que permite que agentes de IA facilitem gorjetas em criptomoedas usando cobrança de pagamento x402 e distribuição automática CDP.

GitHub

Experimente este MCPPatrocinado

Documentação

tip.md x402 + CDP MCP Server

🏆 Inscrição para Hackathon: Transforme qualquer agente de IA em um agente de gorjetas habilitado para pagamentos usando a coleta de pagamentos x402 com distribuição automática via CDP.

🌟 Sobre o tip.md

tip.md é uma plataforma que permite que desenvolvedores recebam gorjetas em criptomoedas diretamente em suas carteiras através de um botão simples incorporável em READMEs do GitHub, sites ou qualquer conteúdo markdown. Ela suporta:

Múltiplas Blockchains: Ethereum, Base, Solana e Bitcoin Lightning Network
Pagamentos Diretos para a Carteira: Gorjetas vão direto para sua carteira, sem custódia
Integração Simples: Um botão, funciona em qualquer lugar onde markdown é suportado
Taxa de 4% da Plataforma: Preços transparentes, só ganhamos se você ganhar
Segurança no Lado do Cliente: Todas as transações processadas com segurança no navegador

Este servidor MCP estende a funcionalidade do tip.md permitindo que qualquer agente de IA facilite gorjetas em criptomoedas através da inovadora integração x402 + CDP.

🚀 Demonstração Rápida (Sem Necessidade de Configuração)

Para Juízes e Avaliadores: Experimente o fluxo de gorjetas x402 + CDP instantaneamente:

git clone https://github.com/xR0am/tip-md-x402-mcp-server.git
cd tip-md-x402-mcp-server
npm install
NODE_ENV=demo npm start

⚠️ Importante: O servidor rodando sozinho mostra logs, mas para ver a funcionalidade de pagamento de demonstração, você precisa conectá-lo a um cliente MCP (veja Testando com Clientes MCP abaixo).

🎯 O Que Isso Faz

Inovação Central: QUALQUER agente de IA + este MCP = agente instantaneamente habilitado para pagamentos

Coleta de Pagamentos x402: Usuários pagam a partir de carteiras dedicadas usando o protocolo de pagamento x402 (Dinheiro ENTRANDO)
Distribuição Automática via CDP: O backend divide automaticamente os pagamentos (96% destinatário, 4% plataforma) via Coinbase Wallet API (Dinheiro SAINDO)
Integração de Ferramentas MCP: Funciona com Claude, ChatGPT, Cursor ou qualquer agente compatível com MCP
Composabilidade Real: Transforme fluxos de trabalho existentes de IA em experiências habilitadas para pagamentos

🔄 O Fluxo Completo

Usuário: "Verificar saldo" → Agente: "47,50 USDC disponíveis para gorjetas"
Usuário pede ao agente de IA: "Dar gorjeta de 5 USDC para @username"
Coleta de Pagamentos x402: O agente gera uma solicitação de pagamento, o usuário paga a partir da carteira dedicada
Distribuição Automática via CDP: O backend divide o pagamento e envia para o destinatário + plataforma
Confirmação da IA: "✅ Enviados 5 USDC para @username"

Arquitetura: Fluxo Real x402 → CDP

Fluxo de Pagamento do Usuário

User → Dedicated Tipping Wallet → x402 Payment Collection → CDP Agent Wallet → CDP Disburses to Recipient (96%) + Platform (4%)

📋 Ferramentas MCP Disponíveis

Este servidor MCP expõe 7 ferramentas que qualquer agente de IA pode usar:

💰 Ferramentas de Pagamento x402 + CDP (Inovação do Hackathon)

mcp_tip_md_tip_on_base: Enviar gorjetas em USDC na Base usando o protocolo de pagamento x402 com distribuição automática via CDP
mcp_tip_md_tip_on_solana: Enviar gorjetas em USDC na Solana usando o protocolo de pagamento x402
mcp_tip_md_check_tipping_balance: Verificar/criar o saldo e informações da sua carteira de gorjetas dedicada

🔧 Ferramentas de Gerenciamento de Carteira

mcp_tip_md_export_tipping_wallet: Exportar a chave privada da sua carteira de gorjetas (sensível à segurança)
mcp_tip_md_withdraw_tipping_funds: Retirar USDC da sua carteira de gorjetas para qualquer endereço

🔍 Ferramentas de Usuário e Rede

mcp_tip_md_get_user_wallet_types: Verificar as criptomoedas suportadas e tipos de carteira do destinatário
mcp_tip_md_crypto_tipping: Informações manuais de gorjetas em criptomoedas para agentes com carteira para instruir (Ethereum, Base, Solana - sem fluxo x402/CDP)

🏥 Ferramentas do Sistema

mcp_tip_md_ping: Endpoint de verificação de saúde

🧪 Testando com Clientes MCP

Para ver a funcionalidade real de pagamento de demonstração, você precisa conectar o servidor MCP a um cliente compatível:

Configuração no Cursor IDE

Edite sua configuração MCP (~/.cursor/mcp.json):

{
  "mcpServers": {
    "tip-md-demo": {
      "command": "node",
      "args": ["dist/mcp-server/src/index.js"],
      "cwd": "/path/to/tip-md-x402-mcp-server",
      "env": {
        "NODE_ENV": "demo"
      }
    }
  }
}

Reinicie o Cursor e procure pelo ícone de ferramentas 🔨
Teste a demonstração:
- Digite: "Dar gorjeta de 5 USDC para o usuário johndoe usando a blockchain base"
- Observe a simulação x402 + CDP em ação!

Configuração no Claude Desktop

Instale o Supergateway (faz a ponte do nosso transporte HTTP para stdio):

npm install -g supergateway

Configure o Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "tip-md-demo": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--httpStream",
        "http://localhost:3000/mcp",
        "--outputTransport",
        "stdio"
      ]
    }
  }
}

Inicie o servidor MCP no modo de demonstração:

NODE_ENV=demo npm start

Reinicie o Claude Desktop e teste com: "Mostre-me as ferramentas tip.md disponíveis"

Outros Clientes MCP

Para clientes que suportam transporte HTTP-stream:

Endpoint: http://localhost:3000/mcp (quando rodando localmente)
Transporte: HTTP-stream
Ambiente: Defina NODE_ENV=demo para o modo de simulação

🛠️ Integração em Produção (Requer Configuração)

Para integração completa com a plataforma tip.md:

Variáveis de Ambiente

Crie um arquivo .env:

# Database Connection (Required for production)
MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/database

# Coinbase Developer Platform (Required for CDP disbursement)
CDP_API_KEY_ID=your_cdp_api_key_id
CDP_API_KEY_SECRET=your_cdp_api_key_secret

# x402 Configuration (Required for payment collection)
X402_WALLET_PRIVATE_KEY=your_x402_wallet_private_key

# Optional Configuration
PORT=3000
NODE_ENV=production
LOG_LEVEL=info

Implantação em Produção

npm install
npm run build
npm start

🏗️ Arquitetura Técnica

Coleta de Pagamentos x402

Carteiras Dedicadas: Cada usuário recebe uma carteira de pagamento única
Conformidade com o Protocolo: Implementação completa da especificação x402

Distribuição Automática via CDP

Divisão Inteligente: 96% para o destinatário, 4% para a plataforma
Liquidação Instantânea: Automatizada via Coinbase Developer Platform

Integração MCP

Compatibilidade Universal: Funciona com qualquer agente de IA compatível com MCP
Respostas Estruturadas: Respostas JSON ricas para integração perfeita
Tratamento de Erros: Fallbacks graciosos e mensagens de erro detalhadas

🎖️ Detalhes da Inscrição para o Hackathon

Desafio: Integração Coinbase x402 + CDP Inovação: Habilitação universal de pagamentos para agentes de IA Modo de Demonstração: NODE_ENV=demo npm start Repositório: https://github.com/xR0am/tip-md-x402-mcp-server

Principais Diferenciais

Integração Universal de Agentes: Qualquer cliente MCP se torna habilitado para pagamentos
Fluxo de Pagamento Completo: Coleta x402 + distribuição CDP em uma única solução
Demonstração Sem Configuração: Juízes podem avaliar imediatamente
Pronto para Produção: Já integrado à plataforma tip.md

📚 Saiba Mais

Plataforma tip.md: https://tip.md
Protocolo MCP: https://modelcontextprotocol.io
Especificação x402: https://docs.coinbase.com/x402
Coinbase CDP: https://docs.cdp.coinbase.com

🤝 Suporte

Para perguntas sobre esta inscrição no hackathon:

Problemas: Abra uma issue no GitHub
E-mail: support@tip.md
Problemas com a Demonstração: Certifique-se de estar testando através de um cliente MCP, não apenas pelos logs do servidor

Construído para o Hackathon Coinbase x402 + CDP 🏆