brianbooms-mcp

Servidor MCP que coloca o catálogo de produtos Brian Booms x402 dentro de agentes de IA como ferramentas acionáveis — pesquise e compre produtos digitais com micropagamentos USDC na Base. Somente leitura por design; nunca assina pagamentos.

GitHubExperimente este MCPPatrocinado

Documentação

Servidor MCP brianbooms

Coloca o catálogo de produtos x402 da Brian Booms dentro de agentes de IA como ferramentas chamáveis. Qualquer agente compatível com MCP pode pesquisar o catálogo, ler os termos de licença, buscar os requisitos de pagamento x402 em tempo real e concluir uma compra — sem abrir um navegador.

Feito com Suno (ética do catálogo: divulgar na primeira menção de como a música é feita).

Ferramentas

FerramentaO que faz
search_catalog(query, max_price?)Pesquisa 33 produtos digitais compráveis por agentes (licenças de música, pacotes de samples, comissões, papéis de parede; US$ 0,05–US$ 999 USDC)
get_product(sku)Detalhes completos: preço, URL de compra, entrega, resumo dos termos de licença
buy_product(sku, partner?)Busca o HTTP 402 ao vivo da URL de compra e retorna os requisitos de pagamento + instruções passo a passo de assinatura x402. O id opcional partner atribui a compra a um Parceiro Booms (participação de 20% na receita)
get_market()As 33 listagens do mercado AP2 (diretório legível por máquina)

Somente leitura por design. O servidor nunca assina, envia ou executa um pagamento. buy_product retorna o que assinar, não uma compra concluída. O catálogo em si exige autorização humana explícita, uma compra por solicitação.

Instalação

pip install mcp

Execução (stdio)

// Claude Desktop / claude-code MCP config
{
  "mcpServers": {
    "brianbooms": {
      "command": "python3",
      "args": ["/path/to/brianbooms-mcp/server.py"]
    }
  }
}

Ou com uvx / pipx quando publicado no npm/PyPI (ainda não publicado).

Como o pagamento funciona (x402 v1)

  1. O agente chama buy_product(sku) → obtém os requisitos do 402
  2. O humano autoriza explicitamente a compra
  3. O agente assina a autorização EIP-3009 off-chain (sem gás para o comprador; o facilitador envia on-chain)
  4. O agente reenvia para a URL de compra com o payload assinado
  5. A resposta de liquidação contém a URL de download/entrega

Rede: Base eip155:8453, ativo USDC. O catálogo carrega ao vivo de https://brianbooms.com/.well-known/purchase-catalog.json na inicialização, com uma cópia de fallback local (catalog-fallback.json).

Arquivos

  • server.py — o servidor MCP (stdio)
  • catalog-fallback.json — cópia local do catálogo usada se o hub estiver inacessível
  • package.json — metadados do wrapper npm (para publicação no registro)