brianbooms-mcp

Servidor MCP que integra el catálogo de productos Brian Booms x402 en agentes de IA como herramientas invocables: busca y compra productos digitales con micropagos en USDC en Base. Solo lectura por diseño; nunca firma pagos.

GitHubPrueba este MCPPatrocinado

Documentación

Servidor MCP de brianbooms

Pone el catálogo de productos x402 de Brian Booms dentro de agentes de IA como herramientas invocables. Cualquier agente compatible con MCP puede buscar en el catálogo, leer los términos de licencia, obtener los requisitos de pago x402 en vivo y completar una compra — sin abrir un navegador.

Hecho con Suno (ética del catálogo: divulgar en la primera mención de cómo se hace la música).

Herramientas

Herramienta	Qué hace
`search_catalog(query, max_price?)`	Busca 33 productos digitales comprables por agentes (licencias de música, paquetes de muestras, comisiones, fondos de pantalla; $0.05–$999 USDC)
`get_product(sku)`	Detalles completos: precio, URL de compra, entrega, resumen de términos de licencia
`buy_product(sku, partner?)`	Obtiene el HTTP 402 en vivo desde la URL de compra y devuelve los requisitos de pago + instrucciones de firma x402 paso a paso. El id opcional `partner` atribuye la compra a un Socio de Booms (participación en ingresos del 20%)
`get_market()`	Los 33 listados del mercado AP2 (directorio legible por máquina)

Solo lectura por diseño. El servidor nunca firma, envía ni ejecuta un pago. buy_product devuelve qué firmar, no una compra completada. El catálogo en sí requiere autorización humana explícita, una compra por solicitud.

Instalación

pip install mcp

Ejecución (stdio)

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

O con uvx / pipx una vez publicado en npm/PyPI (aún no publicado).

Cómo funciona el pago (x402 v1)

El agente llama a buy_product(sku) → obtiene los requisitos del 402
El humano autoriza explícitamente la compra
El agente firma la autorización EIP-3009 fuera de la cadena (sin gas para el comprador; el facilitador la envía en la cadena)
El agente reenvía a la URL de compra con la carga útil firmada
La respuesta de liquidación contiene la URL de descarga/entrega

Red: Base eip155:8453, activo USDC. El catálogo se carga en vivo desde https://brianbooms.com/.well-known/purchase-catalog.json al inicio con una copia de respaldo local (catalog-fallback.json).

Archivos

server.py — el servidor MCP (stdio)
catalog-fallback.json — copia local del catálogo utilizada si el centro no está disponible
package.json — metadatos del envoltorio npm (para publicación en el registro)