Steward MCP

25 herramientas para el comercio de agentes x402: verificación de confianza, controles de gasto, directorio de comerciantes y endpoints de API de pago. Creado por Brian Booms.

GitHubPrueba este MCPPatrocinado

Documentación

Servidor Steward MCP

El riel de pago por llamada x402 de Steward como herramientas MCP. Cualquier agente compatible con MCP (Claude, Cursor, Windsurf, frameworks compatibles con MCP) obtiene el catálogo de Steward de forma nativa en su lista de herramientas — cada llamada de pago se liquida $0.01 USDC en Base, firmado por tu propia billetera.

Steward es la máquina que Brian Booms nombró: cotiza precios justos, verifica el pago criptográficamente, entrega los bienes y contabiliza cada centavo.

Herramientas (25 en total — un servidor canónico)

Llamadas de pago — USDC en Base cada una, liquidadas desde tu billetera

HerramientaQué hacePrecio
steward_weatherClima actual + pronóstico de 7 días para lat/lon$0.01
steward_jokeUn chiste original y limpio$0.01
steward_fortuneUna fortuna original y cálida + número de la suerte$0.01
steward_fxConversión de moneda fiduciaria a tasas de referencia$0.01
steward_timeHora local actual en cualquier zona horaria IANA$0.01
steward_wikiResumen conciso de Wikipedia para un tema$0.01
steward_iss_passPróximos sobrevuelos visibles de la ISS para lat/lon$0.01
steward_audio_matchRelaciona una emoción/momento con una pista de Brian Booms$0.01
steward_audio_restCarril de audio para relajarse$0.01
steward_audio_focusCarril de audio para concentración$0.01
steward_sleep_tipUn consejo genuino de higiene del sueño (sin afirmaciones médicas)$0.01
trust_verify_status¿Está un dominio Verificado por Steward? Estado + método + vencimiento$0.01
trust_agent_attestationSeñales de atestación para una billetera/identificador de agente$0.02
trust_screenEvaluación previa al pago de la contraparte (aprobar/revisar/rechazar, informativo)$0.02

Los tres carriles steward_audio_* están activos en el riel desde el worker V3.9.195-AUDIO. Las tres herramientas trust_* están activas en el riel desde el worker V3.9.203-STANDARD. Todas las herramientas de confianza son de solo lectura e informativas — la verificación nunca se puede comprar.

Descubrimiento de solo lectura — gratuito, nunca firma ni gasta

HerramientaQué haceFuente
steward_catalogCatálogo de compras en vivo: sku, nombre, precio en USD (29 productos)brianbooms-mcp
steward_productDetalles completos para un SKU: descripción, precio, entrega, URL de comprabrianbooms-mcp
steward_purchase_instructionsRequisitos exactos de pago x402 analizados en vivo desde el 402 del productobrianbooms-mcp
steward_rewardsCómo funcionan las Recompensas Booms (compradores + comerciantes + inscripción de agentes)brianbooms-mcp
steward_payment_formatGuía de construcción del encabezado X-PAYMENT byte exactobrianbooms-mcp
steward_cheapest_routeLa más barata de 6 rutas de transferencia de cripto para un monto (tarifas en vivo)boomie-fee-oracle
steward_route_feesTabla de tarifas clasificada completa para las 6 rutasboomie-fee-oracle
steward_receiptsRecibos públicos por billetera — cada centavo, a la vistabase build
steward_verifier_pubkeyClave pública Ed25519 del emisor Verificado por Steward — verifica firmas de registros sin conexiónV3.9.203-STANDARD
steward_directoryDirectorio estándar Steward de 57 comerciantes, clasificado por mérito (la clasificación nunca está en venta)V3.9.203-STANDARD
steward_spend_todayMedidor de gasto local de este servidor (gratuito, local)base build

Servidores reemplazados

Este es el único servidor MCP canónico. Los directorios a continuación se dejan en su lugar por historial, pero están reemplazados — no construyas sobre ellos:

DirectorioQué eraPor qué está reemplazado
ops/mcp/brianbooms-mcp/ (+ variantes -py, -github, -py-1.0.4-staged, -py-1.0.5-build; npm brianbooms-mcp v1.0.7)5 herramientas de descubrimiento de solo lecturaPortadas aquí como steward_catalog, steward_product, steward_purchase_instructions, steward_rewards, steward_payment_format
ops/x402/mcp-fee-oracle/2 herramientas de oráculo de tarifas (cheapest_route, route_fees)Portadas aquí como steward_cheapest_route, steward_route_fees
ops/mcp/synthetic-universe/Servidor solo de etapa; las herramientas duplican el conjunto de pagoDuplicados — las herramientas base aquí son las versiones capaces de pago
ops/su-store/mcp/Catálogo congelado de Stripe de 3 productos + herramientas de checkout/orden de StripeCatálogo deduplicado por el steward_catalog en vivo; las herramientas de checkout de Stripe reemplazadas por el flujo de compra x402

Instalación

Requiere Node 20+.

cd steward-mcp
npm install
npm run build

Configuración

cp .env.example .env
# edit .env:
VariableRequeridaPredeterminadoQué es
STEWARD_PAYER_KEYsí—Tu clave privada de billetera Base (0x...). Financia los pagos de $0.01/llamada.
STEWARD_MAX_SPEND_USDCno0.05Límite máximo por llamada individual. El servidor se niega a firmar por encima de esto.
STEWARD_MAX_SPEND_DAY_USDCno5.00Límite máximo por 24 horas móviles.
STEWARD_RAIL_URLnohttps://pay.brianbooms.comURL base del riel.

Tu clave nunca sale de tu máquina. El servidor la usa solo para firmar una autorización EIP-3009 por llamada ($0.01 USDC en Base, beneficiario verificado como la billetera de Steward 0xa98e8c6cbc64b7bb30fd0d2015ab24814c661839). Nunca se registra, almacena ni transmite a ningún otro lugar. Financia la billetera con unos pocos USDC en Base y cada llamada de herramienta gasta exactamente lo que el riel cotiza — nada más.

Añadir a Claude Code / Cursor / Windsurf

Claude Code (~/.claude.json o .mcp.json del proyecto):

{
  "mcpServers": {
    "steward": {
      "command": "node",
      "args": ["/absolute/path/to/steward-mcp/dist/index.js"],
      "env": {
        "STEWARD_PAYER_KEY": "0x...",
        "STEWARD_MAX_SPEND_USDC": "0.05",
        "STEWARD_MAX_SPEND_DAY_USDC": "5.00"
      }
    }
  }
}

Cursor (.cursor/mcp.json): misma forma bajo "mcpServers".

Luego npm run build una vez, reinicia el host, y las herramientas steward_* aparecen en la lista de herramientas del agente.

Integraciones con frameworks

Steward funciona de forma nativa con cada framework importante de agentes vía MCP. No se necesitan envoltorios — apunta el cliente MCP del framework a Steward y las herramientas aparecen.

LangChain

from langchain_mcp_adapters import MultiServerMCPClient

client = MultiServerMCPClient({
    "steward": {
        "command": "npx",
        "args": ["@brianbooms/steward-mcp"],
        "env": {"STEWARD_PAYER_KEY": "0x..."},
        "transport": "stdio",
    }
})
tools = await client.get_tools()  # steward_* tools as LangChain StructuredTools

LlamaIndex

from llama_index.tools.mcp import BasicMCPClient, McpToolSpec

mcp_client = BasicMCPClient(
    command_or_url="npx",
    args=["@brianbooms/steward-mcp"],
    env={"STEWARD_PAYER_KEY": "0x..."},
)
tool_spec = McpToolSpec(client=mcp_client)
tools = tool_spec.to_tool_list()

CrewAI

from crewai_tools import MCPServerAdapter

with MCPServerAdapter(
    command="npx",
    args=["@brianbooms/steward-mcp"],
    env={"STEWARD_PAYER_KEY": "0x..."},
) as tools:
    # tools = CrewAI-compatible steward_* tools
    agent = Agent(tools=tools, ...)

AutoGen / AG2

from autogen_ext.tools.mcp import StdioServerParams, mcp_server_tools

server_params = StdioServerParams(
    command="npx",
    args=["@brianbooms/steward-mcp"],
    env={"STEWARD_PAYER_KEY": "0x..."},
)
tools = await mcp_server_tools(server_params)

Vercel AI SDK

import { createMCPClient } from "@ai-sdk/mcp";

const mcpClient = await createMCPClient({
  transport: {
    type: "stdio",
    command: "npx",
    args: ["@brianbooms/steward-mcp"],
    env: { STEWARD_PAYER_KEY: "0x..." },
  },
});

const tools = await mcpClient.tools();
// use with generateText({ model, tools, prompt })

Cómo funciona el pago

  1. La herramienta llama al endpoint del riel sin pago.
  2. El riel responde HTTP 402 con una cotización x402 (precio, beneficiario, activo, tiempo de espera).
  3. El servidor verifica: esquema exact, red base, beneficiario es la billetera de Steward, activo es USDC en Base, precio razonable y dentro de tus límites.
  4. Firma una transferWithAuthorization EIP-3009 con tu clave y reenvía con el encabezado X-PAYMENT.
  5. El riel verifica a través de su facilitador y devuelve el resultado como salida de la herramienta.

Cualquier cosa inesperada — beneficiario incorrecto, activo incorrecto, precio sobre tu límite — y el servidor se niega a firmar. Sin gastos silenciosos, nunca.

Verificar sin pagar

npx tsx test/quotes.test.ts   # probes all 24 tools' live quotes, signs nothing
npx tsx test/smoke.test.ts    # boots the MCP server, lists tools over stdio

Confianza

Licencia

MIT — Synthetic Universe LLC.