Skip to main content

zambo — the Zambo execution layer on your command line

The problem: AI models talk. Getting things done — checking a live price, auditing a site, running research, pulling data — means wiring up APIs, keys, and glue code for every single task.

The fix: one command. Describe the job, get it done, get a receipt.

pip install zambo
zambo "what's the price of BTC right now?"
BTC · $81,235.00 USD ...

🔗 receipt 89ccbddc-0b3b-4dbd-b424-4ee75119ef80 · audit: https://zambo.dev/run/89ccbddc-0b3b-4dbd-b424-4ee75119ef80
   verify: zambo verify 89ccbddc-0b3b-4dbd-b424-4ee75119ef80

No account. No API key. No config. Free: 20 calls per tool per day.

Quickstart

# One-command: describe any goal
zambo "audit example.com for AI discoverability"

# Call a specific tool directly
zambo call live_price '{"symbol":"BTC"}'
zambo call ghost_audit_site '{"url":"https://example.com"}'

# Search the 100+ tool catalog
zambo search 'generate QR code'

# List exposed tools
zambo list

# Verify any receipt
zambo verify 89ccbddc-0b3b-4dbd-b424-4ee75119ef80

# Teach your agents about Zambo (writes to AGENTS.md / CLAUDE.md / .muserules)
zambo init

Or use it from Python:

import zambo

out = zambo.call_tool("live_price", {"symbol": "BTC"})
print(out["text"], out["receipt"]["id"])

v = zambo.verify_receipt(out["receipt"]["id"])
print(v["verified"], v["sha256"])

What Zambo is

Zambo — Trust Layer for AI work. Give your AI hands. It's a cross-AI execution layer: an MCP server with 100+ native tools — live crypto prices, site audits, web research, content tools, lead and data tools, multi-step agent jobs — behind one plain JSON-RPC endpoint (https://zambo.dev/api/mcp). This package is a thin Python client for that endpoint (stdlib + requests only).

Don't know which tool fits? Skip the catalog — zambo "<goal>" routes through zambo_universal, which picks the right tools for the job. Pass --session <id> to keep a trail across calls.

Receipts: verifiable proof of execution

Every call returns a verifiable receipt: a UUID, a timestamp, and a sha256 of the result. It proves the call executed and binds the result bytes — so anyone can check that a claimed result is exactly what Zambo produced.

Honest scope: a receipt proves execution integrity, not correctness. It binds the result; it doesn't judge it.

Check any receipt in your browser or on the command line:

zambo verify <receipt-uuid>     # confirms zambo.dev serves the receipt,
                               # and shows sha256, source, timestamp, audit URL

Receipt pages are real web pages with Open Graph tags and canonical URLs — shareable, linkable, citable.

Try the Receipt Test: run a free call, get a receipt, verify it yourself.

Free tier, honestly

  • Free: 20 calls per tool per day. No account, no API key, no card.
  • Paid: a $1.49 Day Pass for agents (24h via agent/x402) or card/PayPal for humans, via zambo.dev. Never required for a first call.

No fake limits, no "contact sales to see a price."

Commands

Command What it does
zambo "<goal>" [--session <id>] Do the thing. Routes via zambo_universal.
zambo call <tool> '<json>' Call one tool directly.
zambo search '<query>' Search the 100+ tool catalog.
zambo list List exposed tools with one-line descriptions.
zambo verify <receipt-uuid> Verify a receipt on zambo.dev.
zambo init [--root <dir>] [--file <name>] [--force] Write the Zambo section into your project's agent instruction file.

Requirements & troubleshooting

  • Python 3.8 or newer. Only dependency: requests.
  • The upstream endpoint occasionally resets connections; the client retries transient transport failures automatically (up to 4 attempts). A received JSON-RPC error is never retried — it's shown to you as-is.
  • Timeouts: 60s per attempt.

License

MIT — see LICENSE (included in the package). Built by Zambo (Brennan Zambo, solo founder).

Metadata

Release files for zambo 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for zambo 1.0.0
File Size Uploaded Provenance Actions
zambo-1.0.0.tar.gz 11.4 kB Without provenance Details for zambo-1.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for zambo 1.0.0
File Interpreter ABI Platform Actions
zambo-1.0.0-py3-none-any.whl Python 3 none any Details for zambo-1.0.0-py3-none-any.whl

Total release size: 22.6 kB

Release files / zambo-1.0.0.tar.gz

Download URL zambo-1.0.0.tar.gz
Size 11.4 kB
Tags Source
SHA-256 checksum
How to use checksums
15324186ef270a3438069121fa4c23d77bbaec103e9202c99835bfd6c4fcd2c5
BLAKE2b-256 checksum
How to use checksums
83a4845dce129b02d97fa62af8c9fb5380f4d39d271834ff4e4a3a571b65ba3f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via zambo-pypi-upload/1.0.0

Release files / zambo-1.0.0-py3-none-any.whl

Download URL zambo-1.0.0-py3-none-any.whl
Size 11.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
dacd2ca18dd812fa474c9f817eb9d9beb1947aaee72450d82e78b2c71961d0a2
BLAKE2b-256 checksum
How to use checksums
ed5d355b3f8f296142aa8eea67af28d351984e7b30771604bd6dc7e365db5165
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via zambo-pypi-upload/1.0.0

Security for zambo 1.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page