Monetize Qualquer API de IA com Micropagamentos x402 e Protocolo MCP

A Oportunidade

A Baidu AI oferece capacidades poderosas — OCR, conversão de texto em fala, chat LLM, reconhecimento de imagem — mas monetizá-las para um público global é difícil. APIs de IA chinesas exigem um número de telefone chinês para registro. Gateways de pagamento internacionais não funcionam nativamente com fluxos de trabalho de agentes de IA.

E se você pudesse expor a Baidu AI para o mundo inteiro, cobrar por chamada e deixar os agentes de IA pagarem automaticamente?

É exatamente isso que GoldBean faz. Neste tutorial, vou mostrar a arquitetura e os padrões de código para monetizar qualquer API de IA com micropagamentos x402 e o protocolo MCP.

Pré-requisitos

• Node.js 20+
• Compreensão básica de APIs HTTP
• Uma conta Baidu AI (ou qualquer API de IA que você deseja monetizar)
• Opcional: uma carteira de criptomoedas com USDC na Base

Arquitetura: x402 + MCP + Baidu AI

Agente de IA (Claude/Cursor) → Protocolo MCP (SSE) → Servidor GoldBean → API Baidu AI
                                    ↓
                            Camada de Pagamento x402
                            (USDC na Base L2)

As três camadas trabalham juntas:

1. Camada MCP: Agentes de IA descobrem e chamam ferramentas via Protocolo de Contexto do Modelo
2. Camada x402: Cada chamada paga aciona um fluxo de pagamento HTTP 402 — o agente paga USDC, o servidor verifica na blockchain
3. Backend de IA: A Baidu AI processa a solicitação e retorna os resultados

Passo 1: Configurando o Servidor MCP

O servidor MCP expõe seus endpoints de IA como ferramentas que os agentes de IA podem descobrir:

import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';

const server = new McpServer({
  name: 'goldbean',
  version: '0.4.1',
});

// Registrar uma ferramenta paga
server.tool(
  'baidu_ocr',
  'Extrair texto de imagens usando Baidu OCR',
  { image_url: z.string().url() },
  async (params) => {
    // Verificar pagamento primeiro
    const paid = await checkPayment(request);
    if (!paid) return paymentRequiredResponse('baidu_ocr', 0.01);

    // Chamar Baidu OCR
    const result = await baiduOCR(params.image_url);
    return { content: [{ type: 'text', text: JSON.stringify(result) }] };
  }
);

Passo 2: Implementando o Fluxo de Pagamento x402

Quando um agente chama um endpoint pago sem créditos, retorne HTTP 402:

function paymentRequiredResponse(endpoint, priceUsd) {
  return {
    status: 402,
    body: {
      error: 'Pagamento Necessário',
      x402: {
        endpoint,
        price: priceUsd.toString(),
        currency: 'USDC',
        chain: 'base',
        contract: '0x833589fCD6e6D11208e4D76B3A0b2E9C0bE017E6',
        receiver: process.env.RECEIVER_WALLET,
        scheme: 'exato'
      }
    }
  };
}

Passo 3: Verificando Pagamentos On-Chain

Após o agente pagar, ele tenta novamente com um hash de transação. Verifique-o na Base:

const