Metadata-Version: 2.1
Name: zambo-ai
Version: 1.0.3
Summary: Official Python SDK for Zambo (zambo.dev), 100+ MCP tools over plain JSON-RPC. No account, no API key. Free: 20 calls/tool/day.
Author-email: Zambo <brennanzambo@zambo.dev>
License: MIT
Project-URL: Homepage, https://zambo.dev
Project-URL: Documentation, https://zambo.dev
Project-URL: Source, https://gitlab.com/rambozambodotdev/zambo
Keywords: mcp,ai-tools,zambo,agents,crypto,seo-audit
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE

# zambo-ai

Official Python SDK for [Zambo](https://zambo.dev), 100+ MCP tools for AI agents and apps over plain JSON-RPC 2.0. **No account, no API key.** Free: 20 calls/tool/day.

Every call returns a **verifiable receipt** (UUID + timestamp + SHA-256). Check any receipt at `https://zambo.dev/run/<id>`.

## Install

```bash
pip install zambo-ai
```

Zero dependencies, stdlib only. Python 3.8+.

## Quickstart

```python
from zambo_ai import Zambo

z = Zambo()

# Live crypto price
btc = z.price("BTC")
print(btc.text)
# BTC · $75,704.00 USD ...   (live value at publish time)

# Describe any job in plain language — Zambo chains the right tools
job = z.universal("audit https://example.com for AI discoverability", session="my-session-1")
print(job.text)
print("receipt:", job.receipt_id)  # verify at https://zambo.dev/run/<id>

# Call any tool directly
r = z.call("live_price", {"coin": "ETH"})

# Search the 100+ tool catalog
found = z.search("generate QR code")

# List exposed tools
tools = z.list_tools()
```

## API

| Method | Description |
|---|---|
| `z.price(coin)` | Live crypto price (`"BTC"`, `"ETH"`, …) |
| `z.universal(goal, session=None)` | Plain-language job → Zambo routes and executes tools. Pass a stable `session` id to continue a trail across models. |
| `z.call(tool, args)` | Direct tool call, e.g. `z.call("live_price", {"coin": "ETH"})` |
| `z.search(query)` | Search the full 100+ tool catalog |
| `z.list_tools()` | List exposed tools with descriptions |

Every result: `text`, `receipt`, `receipt_id`, `audit_url`, `raw`. JSON-RPC failures raise `zambo_ai.ZamboError`.

## Pricing

- **Free:** 20 calls/tool/day, no account
- **Day pass:** $0.99 / 24 hours (USDC on Base)
- **Monthly:** $29
- **Annual:** $290
- **$ZAMBO holder:** $19/month

(From [zambo.dev/pricing](https://zambo.dev/pricing).)

## Links

- Zambo: https://zambo.dev
- Full tool catalog: https://zambo.dev/api/mcp?full=true
- MCP endpoint: `https://zambo.dev/api/mcp`

## License

MIT
