steward-mcp MCP Server

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…

Local serverstdioMIT

What is the steward-mcp Server?

steward-mcp is an MCP project maintained in the brianbooms/steward-mcp repository. The maintainer describes its purpose as “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…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using node. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares STEWARD_PAYER_KEY, STEWARD_MAX_SPEND_USDC, STEWARD_MAX_SPEND_DAY_USDC. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
steward_weatherCurrent weather + 7-day forecast for lat/lon
steward_jokeOne clean original joke
steward_fortuneOne warm original fortune + lucky number
steward_fxFiat currency conversion at reference rates
steward_timeCurrent local time in any IANA time zone
steward_wikiConcise Wikipedia summary for a topic
steward_iss_passUpcoming visible ISS flyovers for lat/lon
steward_audio_matchMatch an emotion/moment to a Brian Booms track
steward_audio_restWind-down audio lane
steward_audio_focusFocus audio lane
steward_sleep_tipOne genuine sleep-hygiene tip (no medical claims)
trust_verify_statusIs a domain Steward Verified? Status + method + expiry
trust_agent_attestationAttestation signals for an agent wallet/identifier
trust_screenPre-payment counterparty screen (approve/review/decline, advisory)
steward_catalogLive purchase catalog: sku, name, USD price (29 products)
steward_productFull details for one SKU: description, price, delivery, buy URL
steward_purchase_instructionsExact x402 payment requirements parsed live from the product's 402
steward_rewardsHow Booms Rewards works (buyers + merchants + agent enrollment)
steward_payment_formatByte-exact X-PAYMENT header construction guide
steward_cheapest_routeCheapest of 6 crypto transfer routes for an amount (live fees)
steward_route_feesFull ranked fee table for all 6 routes
steward_receiptsPublic per-wallet receipts — every cent, in the open
steward_verifier_pubkeySteward Verified issuer Ed25519 public key — verify record signatures offline
steward_directorySteward Standard 57-merchant directory, merit-ranked (ranking never for sale)
steward_spend_todayThis server's local spend meter (free, local)

How to install the steward-mcp Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
STEWARD_PAYER_KEYDeclared in the maintainer’s client configuration.Yes
STEWARD_MAX_SPEND_USDCDeclared in the maintainer’s client configuration.Optional
STEWARD_MAX_SPEND_DAY_USDCDeclared in the maintainer’s client configuration.Optional