Steward MCP

25 ferramentas para comércio de agentes x402 — verificação de confiança, controles de gastos, diretório de comerciantes e endpoints de API pagos. Criado por Brian Booms.

GitHubExperimente este MCPPatrocinado

Documentação

Servidor Steward MCP

O rail de pagamento por chamada x402 da Steward como ferramentas MCP. Qualquer agente compatível com MCP (Claude, Cursor, Windsurf, frameworks com suporte a MCP) obtém o catálogo da Steward nativamente em sua lista de ferramentas — cada chamada paga liquida $0,01 USDC na Base, assinada pela sua própria carteira.

Steward é a máquina que Brian Booms nomeou: ela cotação preços justos, verifica pagamento criptograficamente, entrega os produtos e presta contas de cada centavo.

Ferramentas (25 no total — um servidor canônico)

Chamadas pagas — USDC na Base cada, liquidadas a partir da sua carteira

FerramentaO que fazPreço
steward_weatherClima atual + previsão de 7 dias para lat/lon$0,01
steward_jokeUma piada original e limpa$0,01
steward_fortuneUma sorte original e calorosa + número da sorte$0,01
steward_fxConversão de moeda fiduciária a taxas de referência$0,01
steward_timeHora local atual em qualquer fuso horário IANA$0,01
steward_wikiResumo conciso da Wikipédia para um tópico$0,01
steward_iss_passPróximos sobrevoos visíveis da ISS para lat/lon$0,01
steward_audio_matchCombine uma emoção/momento com uma faixa de Brian Booms$0,01
steward_audio_restFaixa de áudio para relaxar$0,01
steward_audio_focusFaixa de áudio para foco$0,01
steward_sleep_tipUma dica genuína de higiene do sono (sem alegações médicas)$0,01
trust_verify_statusUm domínio é Steward Verified? Status + método + expiração$0,01
trust_agent_attestationSinais de atestado para uma carteira/identificador de agente$0,02
trust_screenTriagem de contraparte pré-pagamento (aprovar/revisar/recusar, consultivo)$0,02

As três faixas steward_audio_* estão ativas no rail desde o worker V3.9.195-AUDIO. As três ferramentas trust_* estão ativas no rail desde o worker V3.9.203-STANDARD. Todas as ferramentas de confiança são somente leitura e consultivas — a verificação nunca pode ser comprada.

Descoberta somente leitura — gratuita, nunca assina ou gasta

FerramentaO que fazFonte
steward_catalogCatálogo de compras ao vivo: sku, nome, preço em USD (29 produtos)brianbooms-mcp
steward_productDetalhes completos para um SKU: descrição, preço, entrega, URL de comprabrianbooms-mcp
steward_purchase_instructionsRequisitos exatos de pagamento x402 analisados ao vivo do 402 do produtobrianbooms-mcp
steward_rewardsComo funciona o Booms Rewards (compradores + comerciantes + inscrição de agentes)brianbooms-mcp
steward_payment_formatGuia de construção do cabeçalho X-PAYMENT byte-exatobrianbooms-mcp
steward_cheapest_routeMais barata das 6 rotas de transferência de cripto para um valor (taxas ao vivo)boomie-fee-oracle
steward_route_feesTabela de taxas classificada completa para todas as 6 rotasboomie-fee-oracle
steward_receiptsRecibos públicos por carteira — cada centavo, às clarasbase build
steward_verifier_pubkeyChave pública Ed25519 do emissor Steward Verified — verifique assinaturas de registros offlineV3.9.203-STANDARD
steward_directoryDiretório padrão Steward de 57 comerciantes, classificado por mérito (classificação nunca à venda)V3.9.203-STANDARD
steward_spend_todayMedidor de gastos local deste servidor (gratuito, local)base build

Servidores substituídos

Este é o único servidor MCP canônico. Os diretórios abaixo são mantidos por histórico, mas estão substituídos — não construa sobre eles:

DiretórioO que eraPor que foi substituído
ops/mcp/brianbooms-mcp/ (+ variantes -py, -github, -py-1.0.4-staged, -py-1.0.5-build; npm brianbooms-mcp v1.0.7)5 ferramentas de descoberta somente leituraPortado aqui como steward_catalog, steward_product, steward_purchase_instructions, steward_rewards, steward_payment_format
ops/x402/mcp-fee-oracle/2 ferramentas de oráculo de taxas (cheapest_route, route_fees)Portado aqui como steward_cheapest_route, steward_route_fees
ops/mcp/synthetic-universe/Servidor somente de estágio; ferramentas duplicam o conjunto pagoDuplicatas — as ferramentas base aqui são as versões com capacidade de pagamento
ops/su-store/mcp/Catálogo Stripe congelado de 3 produtos + ferramentas de checkout/pedido StripeCatálogo deduplicado pelo steward_catalog ao vivo; ferramentas de checkout Stripe substituídas pelo fluxo de compra x402

Instalação

Requer Node 20+.

cd steward-mcp
npm install
npm run build

Configuração

cp .env.example .env
# edit .env:
VariávelObrigatóriaPadrãoO que é
STEWARD_PAYER_KEYsim—Sua chave privada da carteira Base (0x...). Financia os pagamentos de $0,01/chamada.
STEWARD_MAX_SPEND_USDCnão0.05Limite máximo por chamada individual. O servidor se recusa a assinar acima disso.
STEWARD_MAX_SPEND_DAY_USDCnão5.00Limite máximo por janela contínua de 24h.
STEWARD_RAIL_URLnãohttps://pay.brianbooms.comURL base do rail.

Sua chave nunca sai da sua máquina. O servidor a usa apenas para assinar uma autorização EIP-3009 por chamada ($0,01 USDC na Base, beneficiário verificado como a carteira da Steward 0xa98e8c6cbc64b7bb30fd0d2015ab24814c661839). Ela nunca é registrada, armazenada ou transmitida para qualquer outro lugar. Financie a carteira com alguns USDC na Base e cada chamada de ferramenta gasta exatamente o que o rail cotar — nada mais.

Adicionar ao Claude Code / Cursor / Windsurf

Claude Code (~/.claude.json ou projeto .mcp.json):

{
  "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): mesma estrutura em "mcpServers".

Depois npm run build uma vez, reinicie o host, e as ferramentas steward_* aparecem na lista de ferramentas do agente.

Integrações com frameworks

A Steward funciona nativamente com todos os principais frameworks de agentes via MCP. Sem wrappers necessários — aponte o cliente MCP do framework para a Steward e as ferramentas aparecem.

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 })

Como o pagamento funciona

  1. A ferramenta chama o endpoint do rail sem pagamento.
  2. O rail responde HTTP 402 com uma cotação x402 (preço, beneficiário, ativo, tempo limite).
  3. O servidor verifica: esquema exact, rede base, beneficiário é a carteira da Steward, ativo é USDC na Base, preço razoável e dentro dos seus limites.
  4. Ele assina um transferWithAuthorization EIP-3009 com sua chave e reenvia com o cabeçalho X-PAYMENT.
  5. O rail verifica por meio de seu facilitador e retorna o resultado como saída da ferramenta.

Qualquer coisa inesperada — beneficiário errado, ativo errado, preço acima do seu limite — e o servidor se recusa a assinar. Sem gastos silenciosos, nunca.

Verificar sem 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

Confiança

Licença

MIT — Synthetic Universe LLC.