Metadata-Version: 2.5
Name: llama-index-tools-steward
Version: 0.1.0
Summary: Steward MCP tools for LlamaIndex — 25 tools for x402 agent commerce (trust verification, spend controls, merchant directory, paid API endpoints)
Project-URL: Homepage, https://brianbooms.com/steward/
Project-URL: Repository, https://github.com/brianbooms/steward-mcp
Project-URL: Issues, https://github.com/brianbooms/steward-mcp/issues
Author: Synthetic Universe LLC
License: MIT
Keywords: agents,llama-index,mcp,payments,trust,x402
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: llama-index-core>=0.10.0
Requires-Dist: llama-index-tools-mcp>=0.1.0
Description-Content-Type: text/markdown

# llama-index-tools-steward

Steward MCP tools for [LlamaIndex](https://www.llamaindex.ai/) — 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

```bash
pip install llama-index-tools-steward
```

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

## Usage

```python
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

```python
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.
