zambo-ai 1.0.3__tar.gz

zambo-ai-1.0.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zambo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

zambo-ai-1.0.3/PKG-INFO

@@ -0,0 +1,91 @@
+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

zambo-ai-1.0.3/README.md

@@ -0,0 +1,72 @@
+# 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

zambo-ai-1.0.3/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "zambo-ai"
+version = "1.0.3"
+description = "Official Python SDK for Zambo (zambo.dev), 100+ MCP tools over plain JSON-RPC. No account, no API key. Free: 20 calls/tool/day."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "Zambo", email = "brennanzambo@zambo.dev" }]
+keywords = ["mcp", "ai-tools", "zambo", "agents", "crypto", "seo-audit"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://zambo.dev"
+Documentation = "https://zambo.dev"
+Source = "https://gitlab.com/rambozambodotdev/zambo"
+
+[tool.setuptools.packages.find]
+include = ["zambo_ai*"]

zambo-ai-1.0.3/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

zambo-ai-1.0.3/zambo_ai/__init__.py

@@ -0,0 +1,145 @@
+"""zambo-ai — official Python SDK for Zambo (https://zambo.dev).
+
+100+ MCP tools 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) you can check at https://zambo.dev/run/<id>.
+
+Zero dependencies — stdlib only.
+"""
+
+import http.client
+import json
+import time
+import urllib.request
+import urllib.error
+
+ENDPOINT = "https://zambo.dev/api/mcp"
+HEADERS = {
+    "Content-Type": "application/json",
+    "Accept": "application/json, text/event-stream",
+}
+
+# The upstream intermittently resets connections or sends headers with an
+# empty body (server-side flake). Retry transient transport failures; never
+# retry a received JSON-RPC error.
+_TRANSIENT = (
+    http.client.IncompleteRead,
+    http.client.RemoteDisconnected,
+    http.client.BadStatusLine,
+    ConnectionResetError,
+    BrokenPipeError,
+    TimeoutError,
+)
+
+
+class ZamboError(Exception):
+    """A JSON-RPC error returned by the Zambo server."""
+
+
+def _rpc_once(method, params, endpoint=ENDPOINT):
+    body = json.dumps({"jsonrpc": "2.0", "id": 1, "method": method, "params": params}).encode()
+    req = urllib.request.Request(endpoint, data=body, headers=HEADERS, method="POST")
+    with urllib.request.urlopen(req, timeout=60) as resp:
+        raw = resp.read().decode()
+    return raw
+
+
+def _parse_payload(raw):
+    text = raw.strip()
+    if text.startswith("{"):
+        return json.loads(text)
+    # Server may answer SSE: data: {...} lines
+    for line in text.splitlines():
+        if line.startswith("data:"):
+            try:
+                return json.loads(line[5:].strip())
+            except json.JSONDecodeError:
+                continue
+    raise ZamboError("Unparseable response from Zambo: " + raw[:200])
+
+
+def _rpc(method, params, endpoint=ENDPOINT, attempts=6):
+    last = None
+    for n in range(attempts):
+        try:
+            payload = _parse_payload(_rpc_once(method, params, endpoint))
+            break
+        except _TRANSIENT as e:
+            last = e
+            time.sleep(0.6 * (n + 1))
+    else:
+        raise ZamboError(
+            "Transport failed after %d attempts: %s: %s" % (attempts, type(last).__name__, last)
+        )
+    if "error" in payload:
+        raise ZamboError("Zambo error: " + json.dumps(payload["error"]))
+    return payload["result"]
+
+
+class ZamboResult:
+    """A shaped tool result: text, receipt, receipt_id, audit_url, raw."""
+
+    def __init__(self, result):
+        text = ""
+        for block in result.get("content", []):
+            if block.get("type") == "text":
+                text += block.get("text", "") + "\n"
+        self.text = text.strip()
+        self.receipt = result.get("_receipt") or {}
+        self.receipt_id = self.receipt.get("id")
+        # Per-receipt verification URL — this exact pattern appears in the
+        # live tool output (zambo.dev/run/<id> on every call).
+        self.audit_url = (
+            "https://zambo.dev/run/" + self.receipt_id
+            if self.receipt_id
+            else self.receipt.get("audit")
+        )
+        self.raw = result
+
+    def __repr__(self):
+        return "<ZamboResult receipt_id=%r>" % (self.receipt_id,)
+
+
+class Zambo:
+    """Client for the Zambo MCP endpoint."""
+
+    def __init__(self, endpoint=ENDPOINT):
+        self.endpoint = endpoint
+
+    def _call_raw(self, method, params):
+        return _rpc(method, params, self.endpoint)
+
+    def call(self, tool, args=None):
+        """Call any Zambo tool directly: z.call('live_price', {'coin': 'ETH'})"""
+        return ZamboResult(
+            self._call_raw("tools/call", {"name": tool, "arguments": args or {}})
+        )
+
+    def universal(self, goal, session=None):
+        """Describe the job in plain language — Zambo chains the right tools
+        automatically. Pass a stable session id to continue a trail across models."""
+        args = {"goal": goal}
+        if session:
+            args["_session_id"] = session
+        return ZamboResult(
+            self._call_raw("tools/call", {"name": "zambo_universal", "arguments": args})
+        )
+
+    def search(self, query):
+        """Search the 100+ tool catalog: z.search('generate QR code')"""
+        return ZamboResult(
+            self._call_raw(
+                "tools/call", {"name": "capability_search", "arguments": {"query": query}}
+            )
+        )
+
+    def price(self, coin):
+        """Live crypto price helper: z.price('ETH')"""
+        return self.call("live_price", {"coin": coin})
+
+    def list_tools(self):
+        """List the exposed tools with one-line descriptions."""
+        return self._call_raw("tools/list", {}).get("tools", [])
+
+
+__all__ = ["Zambo", "ZamboResult", "ZamboError", "ENDPOINT"]

zambo-ai-1.0.3/zambo_ai.egg-info/PKG-INFO

@@ -0,0 +1,91 @@
+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

zambo-ai-1.0.3/zambo_ai.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+LICENSE
+README.md
+pyproject.toml
+zambo_ai/__init__.py
+zambo_ai.egg-info/PKG-INFO
+zambo_ai.egg-info/SOURCES.txt
+zambo_ai.egg-info/dependency_links.txt
+zambo_ai.egg-info/top_level.txt

zambo-ai-1.0.3/zambo_ai.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

zambo-ai-1.0.3/zambo_ai.egg-info/top_level.txt

@@ -0,0 +1 @@
+zambo_ai