Steward MCP gives MCP-compatible agents Steward's x402 pay-per-call data and trust tools plus free read-only discovery, fee, receipt, and directory utilities, with automatic USDC settlement on Base and hard spend caps.
Paid calls ($0.01–$0.02 USDC on Base): weather and forecasts, jokes, fortunes, FX conversion, local time, Wikipedia summaries, ISS flyovers, Brian Booms audio matching/rest/focus lanes, sleep tips, domain verification status, agent attestations, and pre-payment counterparty screening.
Free read-only discovery: browse the product catalog, get product details, parse live x402 purchase/payment requirements, learn Booms Rewards, and read byte-exact X-PAYMENT header guidance.
Free utility tools: compare 6 crypto transfer routes and full fee tables, look up public per-wallet receipts, fetch the Steward Verified Ed25519 public key for offline verification, list the 57-merchant directory, and check this server's local spend meter.
Safety and integration: verifies quotes before signing (scheme, network, asset, payee, spend caps), keeps payer keys local, and works with MCP hosts/frameworks such as Claude, Cursor, Windsurf, LangChain, LlamaIndex, CrewAI, AutoGen/AG2, and Vercel AI SDK.
Provides a tool to fetch concise Wikipedia summaries for a given topic.
Steward's x402 pay-per-call rail as MCP tools. Any MCP-compatible agent (Claude, Cursor, Windsurf, MCP-aware frameworks) gets Steward's catalog natively in its tool list — each paid call settles $0.01–$0.02 USDC on Base, signed by your own wallet.
Current release: v0.3.1 — run it with npx -y @brianbooms/steward-mcp (25 tools: 14 paid + 11 free).
Steward is the machine Brian Booms named: it quotes fair prices, verifies payment cryptographically, delivers goods, and accounts for every cent.
Rail: https://pay.brianbooms.com · Build V3.9.203-STANDARD
Fair Dealing (the terms): https://brianbooms.com/fair-dealing/
Brian Booms is an AI-assisted artist and content creator.
Tool | What it does | Price |
| Current weather + 7-day forecast for lat/lon | $0.01 |
| One clean original joke | $0.01 |
| One warm original fortune + lucky number | $0.01 |
| Fiat currency conversion at reference rates | $0.01 |
| Current local time in any IANA time zone | $0.01 |
| Concise Wikipedia summary for a topic | $0.01 |
| Upcoming visible ISS flyovers for lat/lon | $0.01 |
| Match an emotion/moment to a Brian Booms track | $0.01 |
| Wind-down audio lane | $0.01 |
| Focus audio lane | $0.01 |
| One genuine sleep-hygiene tip (no medical claims) | $0.01 |
| Is a domain Steward Verified? Status + method + expiry | $0.01 |
| Attestation signals for an agent wallet/identifier | $0.02 |
| Pre-payment counterparty screen (approve/review/decline, advisory) | $0.02 |
The three
steward_audio_*lanes are live rail-side since worker V3.9.195-AUDIO. The threetrust_*tools are live rail-side since worker V3.9.203-STANDARD. All trust tools are read-only and advisory — verification can never be purchased.
Tool | What it does | Source |
| Live purchase catalog: sku, name, USD price (32 catalog SKUs) | brianbooms-mcp |
| Full details for one SKU: description, price, delivery, buy URL | brianbooms-mcp |
| Exact x402 payment requirements parsed live from the product's 402 | brianbooms-mcp |
| How Booms Rewards works (buyers + merchants + agent enrollment) | brianbooms-mcp |
| Byte-exact X-PAYMENT header construction guide | brianbooms-mcp |
| Cheapest of 6 crypto transfer routes for an amount (live fees) | boomie-fee-oracle |
| Full ranked fee table for all 6 routes | boomie-fee-oracle |
| Public per-wallet receipts — every cent, in the open | base build |
| Steward Verified issuer Ed25519 public key — verify record signatures offline | V3.9.203-STANDARD |
| Steward Standard 57-merchant directory, merit-ranked (ranking never for sale) | V3.9.203-STANDARD |
| This server's local spend meter (free, local) | base build |
Related MCP server: x402-mcp
This is the one canonical MCP server. The directories below are left in place for history but are superseded — do not build on them:
Directory | What it was | Why superseded |
| 5 read-only discovery tools | Ported here as |
| 2 fee-oracle tools ( | Ported here as |
| Stage-only server; tools duplicate the paid set | Duplicates — the base tools here are the payment-capable versions |
| Frozen 3-product Stripe catalog + Stripe checkout/order tools | Catalog deduped by the live |
Requires Node 20+. No install step — run the published package (v0.3.1):
npx -y @brianbooms/steward-mcpFrom source (this repo):
cd steward-mcp
npm install
npm run buildcp .env.example .env
# edit .env:Variable | Required | Default | What it is |
| yes | — | Your Base wallet private key ( |
| no |
| Hard ceiling per single call. The server refuses to sign above this. |
| no |
| Hard ceiling per rolling 24h. |
| no |
| Rail base URL. |
Your key never leaves your machine. The server uses it only to sign a
per-call EIP-3009 authorization ($0.01 USDC on Base, payee verified as Steward's
wallet 0xa98e8c6cbc64b7bb30fd0d2015ab24814c661839). It is never logged, stored,
or transmitted anywhere else. Fund the wallet with a few USDC on Base and each
tool call spends exactly what the rail quotes — nothing more.
Claude Code (~/.claude.json or project .mcp.json):
{
"mcpServers": {
"steward": {
"command": "npx",
"args": ["-y", "@brianbooms/steward-mcp"],
"env": {
"STEWARD_PAYER_KEY": "0x...",
"STEWARD_MAX_SPEND_USDC": "0.05",
"STEWARD_MAX_SPEND_DAY_USDC": "5.00"
}
}
}
}Cursor (.cursor/mcp.json): same shape under "mcpServers".
Restart the host, and the steward_* tools appear in the agent's tool list.
Ready-to-paste configs for Claude Desktop, Cursor, Windsurf, Cline, and Codex: https://github.com/brianbooms/steward-examples
Steward works natively with every major agent framework via MCP. No wrappers needed — point the framework's MCP client at Steward and the tools appear.
Worked examples: steward-examples (index + client configs) · LlamaIndex · CrewAI · ElizaOS plugin · eval kit
from langchain_mcp_adapters import MultiServerMCPClient
client = MultiServerMCPClient({
"steward": {
"command": "npx",
"args": ["-y", "@brianbooms/steward-mcp"],
"env": {"STEWARD_PAYER_KEY": "0x..."},
"transport": "stdio",
}
})
tools = await client.get_tools() # steward_* tools as LangChain StructuredToolsfrom llama_index.tools.mcp import BasicMCPClient, McpToolSpec
mcp_client = BasicMCPClient(
command_or_url="npx",
args=["-y", "@brianbooms/steward-mcp"],
env={"STEWARD_PAYER_KEY": "0x..."},
)
tool_spec = McpToolSpec(client=mcp_client)
tools = tool_spec.to_tool_list()from crewai_tools import MCPServerAdapter
with MCPServerAdapter(
command="npx",
args=["-y", "@brianbooms/steward-mcp"],
env={"STEWARD_PAYER_KEY": "0x..."},
) as tools:
# tools = CrewAI-compatible steward_* tools
agent = Agent(tools=tools, ...)from autogen_ext.tools.mcp import StdioServerParams, mcp_server_tools
server_params = StdioServerParams(
command="npx",
args=["-y", "@brianbooms/steward-mcp"],
env={"STEWARD_PAYER_KEY": "0x..."},
)
tools = await mcp_server_tools(server_params)import { createMCPClient } from "@ai-sdk/mcp";
const mcpClient = await createMCPClient({
transport: {
type: "stdio",
command: "npx",
args: ["-y", "@brianbooms/steward-mcp"],
env: { STEWARD_PAYER_KEY: "0x..." },
},
});
const tools = await mcpClient.tools();
// use with generateText({ model, tools, prompt })Tool calls the rail endpoint with no payment.
Rail answers HTTP 402 with an x402 quote (price, payee, asset, timeout).
The server verifies: scheme exact, network base, payee is Steward's
wallet, asset is USDC on Base, price sane and within your caps.
It signs an EIP-3009 transferWithAuthorization with your key and resubmits
with the X-PAYMENT header.
Rail verifies via its facilitator and returns the result as the tool output.
Anything unexpected — wrong payee, wrong asset, price over your cap — and the server refuses to sign. No silent spending, ever.
npx tsx test/quotes.test.ts # probes all 25 tools' live quotes, signs nothing
npx tsx test/smoke.test.ts # boots the MCP server, lists tools over stdioPrices are quoted by the rail per call; the server never invents a price.
Every settled call appears on steward_receipts — public, per wallet.
The terms: https://brianbooms.com/fair-dealing/ (the Fair Dealing page controls).
Machine-readable catalog: https://brianbooms.com/.well-known/purchase-catalog.json
MIT — Synthetic Universe LLC.
Focus audio lane — steady Brian Booms soundscapes for deep work and concentration. Choose this for working; choose steward_audio_rest for winding down, or steward_audio_match when you want a track picked for a specific mood. Optional length in minutes (1-120); omit for the rail default. Paid: $0.01 USDC on Base per call — the rail quotes each call via 402; this server verifies the quote (exact scheme, Base network, USDC, Steward payee) and settles from your wallet automatically, refusing quotes over your per-call or daily spend caps. Your payer key never leaves your machine.
Inputs: minutes.
Recommend the right Brian Booms track for an emotion, moment, or occasion — describe the feeling ('a quiet rainy evening', 'pre-workout energy') and get back a matching track recommendation. This is the discovery tool: use it when you don't know which track fits. For ready-made listening lanes use steward_audio_rest (wind-down) or steward_audio_focus (deep work) instead. Paid: $0.01 USDC on Base per call — the rail quotes each call via 402; this server verifies the quote (exact scheme, Base network, USDC, Steward payee) and settles from your wallet automatically, refusing quotes over your per-call or daily spend caps. Your payer key never leaves your machine.
Inputs: mood (required).
Wind-down audio lane — calm Brian Booms soundscapes for rest and recovery. Choose this for sleep and relaxation; choose steward_audio_focus for deep work, or steward_audio_match when you want a track picked for a specific mood. Optional length in minutes (1-120); omit for the rail default. Paid: $0.01 USDC on Base per call — the rail quotes each call via 402; this server verifies the quote (exact scheme, Base network, USDC, Steward payee) and settles from your wallet automatically, refusing quotes over your per-call or daily spend caps. Your payer key never leaves your machine.
Inputs: minutes.
List everything buyable from Brian Booms — 29 products: ambient music, ringtones, wallpapers, track leases, game licenses, commissions. Returns sku, name, and USD price per product. Start any purchase flow here, then use steward_product for details on one item or steward_purchase_instructions for its live payment requirements. This lists WHAT Brian Booms sells; for the merchant directory (who sells) see steward_directory. Free, read-only — never signs or spends.
Inputs: no named parameters.
Cheapest of 6 crypto transfer routes for a USD amount — USDC on Base, Solana, Polygon, Arbitrum, Avalanche C-chain, and BTC — ranked with live fee data. Returns the ranked list plus the single cheapest route. Use this for a quick answer; use steward_route_fees for the full fee table. Advisory only: neutral ranking, no wallet, no custody, moves nothing. Free, read-only.
Inputs: amount_usd (required), token.
The Steward Standard merchant directory: 57 x402 merchants ranked by public merit score — liveness, volume, docs, endpoints, breadth, trust. Ranking is never for sale: no pay-to-rank, no sponsored slots, no partner override. This lists WHO sells (merchants); for WHAT Brian Booms sells use steward_catalog. Returns the full machine-readable directory. Free, read-only — never signs or spends.
Inputs: no named parameters.
One warm, original fortune — a lucky number (1-99) plus a calm word from the Synthetic Universe. Computed on the rail, no third-party upstream. Fortunes, not jokes: for humor use steward_joke instead. Pass a session id to avoid repeats within a session. Paid: $0.01 USDC on Base per call — the rail quotes each call via 402; this server verifies the quote (exact scheme, Base network, USDC, Steward payee) and settles from your wallet automatically, refusing quotes over your per-call or daily spend caps. Your payer key never leaves your machine.
Inputs: session.
Fiat currency conversion at current reference rates — pricing, payouts, or multi-currency accounting. Reference rates only, not execution quotes; for crypto transfer fees use steward_cheapest_route instead. Paid: $0.01 USDC on Base per call — the rail quotes each call via 402; this server verifies the quote (exact scheme, Base network, USDC, Steward payee) and settles from your wallet automatically, refusing quotes over your per-call or daily spend caps. Your payer key never leaves your machine.
Inputs: to (required), from (required), amount (required).
Upcoming visible ISS flyover times for a location, computed from public CelesTrak orbital data — skywatching or satellite-aware scheduling. Location-only sibling of steward_weather: weather for conditions, this for flyovers. Paid: $0.01 USDC on Base per call — the rail quotes each call via 402; this server verifies the quote (exact scheme, Base network, USDC, Steward payee) and settles from your wallet automatically, refusing quotes over your per-call or daily spend caps. Your payer key never leaves your machine.
Inputs: lat (required), lon (required).
One clean, original, family-friendly joke from the Synthetic Universe — computed on the rail, no third-party upstream. Pass a session id to avoid repeats within a session; omit it for a one-off joke. Paid: $0.01 USDC on Base per call — the rail quotes each call via 402; this server verifies the quote (exact scheme, Base network, USDC, Steward payee) and settles from your wallet automatically, refusing quotes over your per-call or daily spend caps. Your payer key never leaves your machine.
Inputs: session.
Byte-exact guide to constructing a valid X-PAYMENT header for x402 v1 (EVM, USDC on Base). Call this BEFORE an agent's first self-paid purchase via steward_purchase_instructions — most failed payments are header-format errors this guide prevents. Free, read-only — never signs or spends.
Inputs: no named parameters.
Full details for one catalog product: description, USD price, delivery method, and buy URL. Use after steward_catalog to zoom in on a single sku; when ready to pay, call steward_purchase_instructions for the live x402 quote. Free, read-only — never signs or spends.
Inputs: sku (required).
Exact x402 payment requirements for buying a product: pay-to address, amount, asset, network, and facilitator — parsed live from the product's 402 response. Find the sku with steward_catalog first. Your agent pays with its own x402/EVM wallet, then downloads instantly. Free, read-only (reads the 402, never pays it). If the agent pays through this server's paid tools instead, no manual payment step is needed.
Inputs: sku (required).
Public per-wallet receipts for settled Steward calls — look up any EVM wallet and see every cent it paid, in the open. Use this to verify a payment actually settled. This is on-rail history and the source of truth for settled spend; for this server's own local meter see steward_spend_today. Free, read-only — never signs or spends.
Inputs: wallet (required).
How Booms Rewards works: earn rates for buyers, referral rates, and how a store joins free. Read this before buying through steward_purchase_instructions so you know the credit you'll earn, or before enrolling a store as a merchant. Free, read-only — never signs or spends.
Inputs: no named parameters.
Full ranked fee table for all 6 crypto transfer routes (USDC on Base, Solana, Polygon, Arbitrum, Avalanche C-chain, and BTC) for a USD amount. Each route carries fee_usd, total_usd, and fee_source (live or typical) verbatim from the API. Use this for the complete comparison; use steward_cheapest_route when you only need the winner. Advisory only: neutral ranking, no wallet, no custody, moves nothing. Free, read-only.
Inputs: amount_usd (required), token.
One genuine sleep-hygiene tip from Brian Booms' rotating collection of 12 — practical habits, never medical claims. Omit the index for today's rotating tip; pass 0-11 for a specific one. Paid: $0.01 USDC on Base per call — the rail quotes each call via 402; this server verifies the quote (exact scheme, Base network, USDC, Steward payee) and settles from your wallet automatically, refusing quotes over your per-call or daily spend caps. Your payer key never leaves your machine.
Inputs: index.
This server's local spend meter: USDC spent through this process today. In-memory and per-process (resets on restart) — a safety rail, not accounting; the rail's receipts (steward_receipts) are the source of truth for settled spend. Free, no rail call.
Inputs: no named parameters.
Current local time in any IANA time zone — scheduling, reminders, or market-window checks. Computed on the rail with no third-party upstream to fail. Paid: $0.01 USDC on Base per call — the rail quotes each call via 402; this server verifies the quote (exact scheme, Base network, USDC, Steward payee) and settles from your wallet automatically, refusing quotes over your per-call or daily spend caps. Your payer key never leaves your machine.
Inputs: tz (required).
Steward Verified issuer's Ed25519 public key (hex) — independently verify any Steward Verified record's signature offline: the signature covers the canonical record (sorted keys, no whitespace, UTF-8) with signing_pubkey blanked. Pair with trust_verify_status, which reports the status this key lets you verify yourself. Free, read-only — never signs or spends.
Inputs: no named parameters.
Current conditions plus a 7-day forecast for any latitude/longitude — trip planning, event scheduling, or location-aware task prep. Use this for weather; use steward_iss_pass for satellite flyovers at the same coordinates. Paid: $0.01 USDC on Base per call — the rail quotes each call via 402; this server verifies the quote (exact scheme, Base network, USDC, Steward payee) and settles from your wallet automatically, refusing quotes over your per-call or daily spend caps. Your payer key never leaves your machine.
Inputs: lat (required), lon (required).
Concise summary of a Wikipedia article — quick research context for agents. Pass the article title as-is; the rail resolves it. For buying Brian Booms products use steward_catalog, not this tool. Paid: $0.01 USDC on Base per call — the rail quotes each call via 402; this server verifies the quote (exact scheme, Base network, USDC, Steward payee) and settles from your wallet automatically, refusing quotes over your per-call or daily spend caps. Your payer key never leaves your machine.
Inputs: topic (required).
Attestation signals for an agent: operator verification status plus observed on-rail payment history for the given wallet or identifier. Read-only and advisory — signals only, never a guarantee of trustworthiness. For domains use trust_verify_status; for a pre-payment decision use trust_screen. Paid: $0.02 USDC on Base per attestation — the rail quotes each call via 402; this server verifies the quote (exact scheme, Base network, USDC, Steward payee) and settles from your wallet automatically, refusing quotes over your per-call or daily spend caps. Your payer key never leaves your machine.
Inputs: agent (required), operator_domain.
Pre-payment counterparty screen: deterministic approve / review / decline for an agent and a candidate USDC amount, derived from the agent's attestation. ADVISORY ONLY — never a guarantee; on lookup failure it fails open to 'review', never an automatic decline. For the full signal details behind a screen, call trust_agent_attestation. Paid: $0.02 USDC on Base per screen — the rail quotes each call via 402; this server verifies the quote (exact scheme, Base network, USDC, Steward payee) and settles from your wallet automatically, refusing quotes over your per-call or daily spend caps. Your payer key never leaves your machine.
Inputs: agent (required), amount_usdc (required), merchant_domain.
Check whether a domain is Steward Verified: returns verification status, method, issuance/expiry, and endpoint count. Read-only and advisory — it reports status; verification is never issued here and can never be purchased. Use before trusting a merchant domain; for agent counterparties use trust_agent_attestation; for a pay/no-pay decision use trust_screen. Paid: $0.01 USDC on Base per lookup — the rail quotes each call via 402; this server verifies the quote (exact scheme, Base network, USDC, Steward payee) and settles from your wallet automatically, refusing quotes over your per-call or daily spend caps. Your payer key never leaves your machine.
Inputs: domain (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 25 tools
Most tools target clearly distinct resources or actions, and descriptions explicitly differentiate overlapping pairs like audio lanes, route tools, and trust tools. However, several closely related tools (e.g., steward_audio_match vs audio_rest/focus, steward_cheapest_route vs route_fees) still require careful reading to avoid misselection.
Names consistently use snake_case with domain prefixes (steward_ or trust_), which is predictable. The main deviation is that they do not follow a uniform verb_noun pattern, and the steward_/trust_ prefix split is a minor inconsistency.
25 tools is at the heavy end of the range, and the server bundles many unrelated utility services (weather, ISS, audio, jokes, crypto routes, trust) under one MCP. Each tool covers a distinct service, but the overall count feels borderline heavy for the apparent scope.
The surface covers the main domains: catalog/purchase flow, trust verification, payment receipts, and a broad set of utility APIs. Minor gaps exist (e.g., no explicit post-payment download tool and limited audio discovery beyond mood match), but agents can work around them.
126 pay-per-call agent tools via x402: web, crypto safety, agent memory and inbox, API finder
54 AI agent tools: OSINT, intel feeds, DeFi, crypto, weather, DNS, proxies. x402 micropayments.
x402 paid API tools for AI agents on Base: EU/global registries, crypto, wallet & agent trust.
x402 toolkit for AI agents: paid web, AI, and Base chain tools per call in USDC. Free tools too.
