llama-index-tools-steward

Steward MCP tools for LlamaIndex — 25 tools for x402 agent commerce: trust verification, spend controls, merchant directory, and paid API endpoints.

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
• Fair Dealing (the terms): https://brianbooms.com/fair-dealing/
• MCP server: https://github.com/brianbooms/steward-mcp
• npm: @brianbooms/steward-mcp

Install

pip install llama-index-tools-steward

Requires Node 20+ (the MCP server runs via npx).

Usage

from llama_index.tools.steward import StewardToolSpec
from llama_index.agent import ReActAgent

spec = StewardToolSpec(payer_key="0x...")  # your Base wallet private key
tools = spec.to_tool_list()

agent = ReActAgent.from_tools(tools)
response = agent.chat("Is pay.brianbooms.com Steward Verified?")
print(response)

Spend caps

spec = StewardToolSpec(
    payer_key="0x...",
    max_spend_usdc="0.05",       # hard ceiling per single call
    max_spend_day_usdc="5.00",   # hard ceiling per rolling 24h
)

Your key never leaves your machine. The MCP server uses it only to sign a per-call EIP-3009 authorization ($0.01 USDC on Base, payee verified as Steward's wallet). It is never logged, stored, or transmitted anywhere else.

Tools (25)

Paid calls ($0.01 USDC on Base each): steward_weather, steward_joke, steward_fortune, steward_fx, steward_time, steward_wiki, steward_iss_pass, steward_audio_match, steward_audio_rest, steward_audio_focus, steward_sleep_tip, trust_verify_status, trust_agent_attestation, trust_screen.

Free read-only discovery: steward_catalog, steward_product, steward_purchase_instructions, steward_rewards, steward_payment_format, steward_cheapest_route, steward_route_fees, steward_receipts, steward_verifier_pubkey, steward_directory, steward_spend_today.

License

MIT — Synthetic Universe LLC.