zambo-mcp 1.0.12 โ†’ 1.0.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +51 -20
  2. package/package.json +2 -2
  3. package/readme.diff +118 -0
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # zambo-mcp โ€” Zambo, the verifiable work layer for AI, on your command line
2
2
 
3
- **AER-1, the agent execution receipt standard: [zambo.dev/aer-1](https://zambo.dev/aer-1/) | Add Zambo to your AI: [zambo.dev/add](https://zambo.dev/add)**
3
+ **AER-1, the agent execution receipt standard: [zambo.dev/aer-1](https://zambo.dev/aer-1/) | Add Zambo to your AI: [zambo.dev/add/](https://zambo.dev/add/)**
4
4
 
5
5
  Zambo is the verifiable work layer for AI. Receipt format: AER-1, IETF Internet-Draft [draft-zambo-aer1-26](https://datatracker.ietf.org/doc/draft-zambo-aer1/26/).
6
6
 
@@ -13,42 +13,62 @@ npx zambo-mcp "what's the price of BTC right now?"
13
13
  ```
14
14
 
15
15
  ```text
16
- BTC is currently priced at $81,270.00 ...
16
+ BTC is currently priced at $76,975.00 ...
17
17
 
18
- ๐Ÿ”— receipt f410acad-e438-48c3-acae-f37871a764b1 ยท audit: https://zambo.dev/run/f410acad-e438-48c3-acae-f37871a764b1
19
- verify: zambo verify f410acad-e438-48c3-acae-f37871a764b1
18
+ ๐Ÿ”— receipt acdfbed9-ee40-441d-9230-4f44632ca713 ยท audit: https://zambo.dev/run/acdfbed9-ee40-441d-9230-4f44632ca713
19
+ verify: npx zambo-mcp verify acdfbed9-ee40-441d-9230-4f44632ca713
20
20
  ```
21
21
 
22
+ (Example output from a real call on 2026-11-02. Prices move; the receipt format does not.)
23
+
22
24
  No account. No API key. No config. Free: 20 calls + 1 wrap-up free every day; picking up in another AI is always free.
23
25
 
24
26
  ## Quickstart
25
27
 
28
+ Two ways to run it. Pick one first, because the command form depends on it.
29
+
30
+ **No install: npx.** Every command works through npx, nothing to install:
31
+
26
32
  ```bash
27
33
  # One-command: describe any goal
34
+ npx zambo-mcp "what's the price of BTC right now?"
28
35
  npx zambo-mcp "audit example.com for AI discoverability"
29
36
 
37
+ # Call a specific tool directly
38
+ npx zambo-mcp call live_price '{"symbol":"BTC"}'
39
+
40
+ # Verify any receipt
41
+ npx zambo-mcp verify acdfbed9-ee40-441d-9230-4f44632ca713
42
+ ```
43
+
44
+ **Global install: the short `zambo` command.**
45
+
46
+ ```bash
47
+ npm install -g zambo-mcp
48
+ ```
49
+
50
+ ```bash
51
+ # One-command: describe any goal
52
+ zambo "audit example.com for AI discoverability"
53
+
30
54
  # Call a specific tool directly
31
55
  zambo call live_price '{"symbol":"BTC"}'
32
56
  zambo call ghost_audit_site '{"url":"https://example.com"}'
33
57
 
34
- # Search the 153 tool catalog
58
+ # Search the tool catalog
35
59
  zambo search 'generate QR code'
36
60
 
37
61
  # List exposed tools
38
62
  zambo list
39
63
 
40
64
  # Verify any receipt
41
- zambo verify f410acad-e438-48c3-acae-f37871a764b1
65
+ zambo verify acdfbed9-ee40-441d-9230-4f44632ca713
42
66
 
43
67
  # Teach your agents about Zambo (writes to AGENTS.md / CLAUDE.md / .muserules)
44
68
  zambo init
45
69
  ```
46
70
 
47
- Install it globally for the short `zambo` command:
48
-
49
- ```bash
50
- npm install -g zambo-mcp
51
- ```
71
+ Installed locally only (`npm install zambo-mcp` inside a project)? Bare `zambo` is not on your PATH, so it will read as "command not found". Use the npx form above, or `./node_modules/.bin/zambo ...`. Every `zambo ...` command in the rest of this README assumes the global install; without it, prefix the same command with `npx zambo-mcp`.
52
72
 
53
73
  Or use it from Node:
54
74
 
@@ -64,7 +84,7 @@ console.log(v.verified, v.tool, v.sha256);
64
84
 
65
85
  ## What Zambo is
66
86
 
67
- [Zambo](https://zambo.dev) is the verifiable work layer for AI: an MCP server with 153 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/mcp`). This package is a thin, zero-dependency client for that endpoint.
87
+ [Zambo](https://zambo.dev) is the verifiable work layer for AI: an MCP server with native tools: live crypto prices, site audits, web research, content tools, lead and data tools, and multi-step agent jobs, behind one plain JSON-RPC endpoint (`https://zambo.dev/mcp`). This package is a thin, zero-dependency client for that endpoint.
68
88
 
69
89
  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.
70
90
 
@@ -74,19 +94,20 @@ Every call returns an **AI agent execution receipt** โ€” a **verifiable receipt*
74
94
 
75
95
  A real receipt from a live call:
76
96
 
77
- - Tool: `live_price` โ†’ BTC $86,175.00 USD (โ–ฒ 2.84% / 24h)
78
- - Receipt ID: `a71f243d-39e8-4eda-9c4b-2a31ae063ba9`
79
- - Time: 2026-09-22T08:49:53Z
80
- - Output hash: `sha256:ae5d2c1729fec0515dc05ea291d75f02860ce533bd3e87909cda899d93f4103f`
81
- - Inspect it yourself: https://zambo.dev/run/a71f243d-39e8-4eda-9c4b-2a31ae063ba9
97
+ - Tool: `live_price` โ†’ BTC $76,975.00 USD (โ–ผ 1.14% / 24h)
98
+ - Receipt ID: `acdfbed9-ee40-441d-9230-4f44632ca713`
99
+ - Time: 2026-11-02T18:42:26Z
100
+ - Output hash: `sha256:cc88b6a902be80fce61e0a110b8ee268b7a4ca72cf464d58d9e45b01ea521d4f`
101
+ - Inspect it yourself: https://zambo.dev/run/acdfbed9-ee40-441d-9230-4f44632ca713
82
102
 
83
103
  Honest scope: a receipt proves execution integrity, not correctness. It binds the result; it doesn't judge it.
84
104
 
85
105
  Check any receipt in your browser or on the command line:
86
106
 
87
107
  ```bash
88
- zambo verify <receipt-uuid> # confirms zambo.dev serves the receipt,
89
- # and shows tool, sha256, timestamp, audit URL
108
+ npx zambo-mcp verify <receipt-uuid>
109
+ # confirms zambo.dev serves the receipt, and shows tool, sha256, timestamp, audit URL
110
+ # (with the global install, the same command is: zambo verify <receipt-uuid>)
90
111
  ```
91
112
 
92
113
  Receipt pages are real web pages with structured data (JSON-LD), Open Graph tags, and canonical URLs โ€” shareable, linkable, citable.
@@ -104,7 +125,7 @@ No fake limits, no "contact sales to see a price."
104
125
  |---|---|
105
126
  | `zambo "<goal>" [--session <id>]` | Do the thing. Routes via `zambo_universal`. |
106
127
  | `zambo call <tool> '<json>'` | Call one tool directly. |
107
- | `zambo search '<query>'` | Search the 153 tool catalog. |
128
+ | `zambo search '<query>'` | Search the tool catalog. |
108
129
  | `zambo list` | List exposed tools with one-line descriptions. |
109
130
  | `zambo verify <receipt-uuid>` | Verify a receipt on zambo.dev. |
110
131
  | `zambo init [--root <dir>] [--file <name>] [--force]` | Write the Zambo section into your project's agent instruction file. |
@@ -127,3 +148,13 @@ MIT โ€” see [LICENSE](LICENSE). Created by Brennan Zambo โ€” https://zambo.dev/f
127
148
  - [What is cross-AI continuity?](https://zambo.dev/answers/what-is-cross-ai-continuity/)
128
149
  - [Install Zambo](https://zambo.dev/install/)
129
150
  - [Brennan Zambo โ€” founder](https://zambo.dev/founder/)
151
+
152
+ ## Where these receipts run live: Zambo
153
+
154
+ zambo-mcp connects MCP clients to the live Zambo server, every call returning a verifiable AER-1 receipt, and it has been downloaded 2,300+ times on npm (all-time). The live home of those receipts is Zambo, the verifiable work layer for AI. Connect any AI to the live endpoint at https://zambo.dev/mcp or add Zambo to your AI in one step at https://zambo.dev/add/
155
+
156
+ Free tier: 20 calls + 1 wrap-up free every day; picking up in another AI is always free. The Day Pass is $0.99 for 24 hours, unlimited.
157
+
158
+ Install:
159
+
160
+ npm install zambo-mcp
package/package.json CHANGED
@@ -7,7 +7,7 @@
7
7
  "bugs": {
8
8
  "url": "https://zambo.dev"
9
9
  },
10
- "description": "Zambo MCP server: 153 AI tools on one endpoint for crypto, audits, research. Every call returns a verifiable execution receipt (AER-1, IETF Internet-Draft draft-zambo-aer1-26). Free: 20 calls + 1 wrap-up free every day; picking up in another AI is always free. No account. zambo.dev",
10
+ "description": "Zambo MCP server: AI tools on one endpoint for crypto, audits, research. Every call returns a verifiable execution receipt (AER-1, IETF Internet-Draft draft-zambo-aer1-26). Free: 20 calls + 1 wrap-up free every day; picking up in another AI is always free. No account. zambo.dev",
11
11
  "engines": {
12
12
  "node": ">=18"
13
13
  },
@@ -41,5 +41,5 @@
41
41
  "main": "index.js",
42
42
  "name": "zambo-mcp",
43
43
  "repository": "https://zambo.dev",
44
- "version": "1.0.12"
44
+ "version": "1.0.14"
45
45
  }
package/readme.diff ADDED
@@ -0,0 +1,118 @@
1
+ --- /home/hatch/workspace/funnel-wave-2026-11-02/t5/npm-zambo-mcp/package/README.md 2026-11-02 13:48:42.019481927 +0000
2
+ +++ /home/hatch/workspace/zambo-mcp-fix-2026-11-02/README.md 2026-11-02 18:42:45.345005646 +0000
3
+ @@ -13,21 +13,45 @@
4
+ ```
5
+
6
+ ```text
7
+ -BTC is currently priced at $81,270.00 ...
8
+ +BTC is currently priced at $76,975.00 ...
9
+
10
+ -๐Ÿ”— receipt f410acad-e438-48c3-acae-f37871a764b1 ยท audit: https://zambo.dev/run/f410acad-e438-48c3-acae-f37871a764b1
11
+ - verify: zambo verify f410acad-e438-48c3-acae-f37871a764b1
12
+ +๐Ÿ”— receipt acdfbed9-ee40-441d-9230-4f44632ca713 ยท audit: https://zambo.dev/run/acdfbed9-ee40-441d-9230-4f44632ca713
13
+ + verify: npx zambo-mcp verify acdfbed9-ee40-441d-9230-4f44632ca713
14
+ ```
15
+
16
+ +(Example output from a real call on 2026-11-02. Prices move; the receipt format does not.)
17
+ +
18
+ No account. No API key. No config. Free: 20 calls + 1 wrap-up free every day; picking up in another AI is always free.
19
+
20
+ ## Quickstart
21
+
22
+ +Two ways to run it. Pick one first, because the command form depends on it.
23
+ +
24
+ +**No install: npx.** Every command works through npx, nothing to install:
25
+ +
26
+ ```bash
27
+ # One-command: describe any goal
28
+ +npx zambo-mcp "what's the price of BTC right now?"
29
+ npx zambo-mcp "audit example.com for AI discoverability"
30
+
31
+ # Call a specific tool directly
32
+ +npx zambo-mcp call live_price '{"symbol":"BTC"}'
33
+ +
34
+ +# Verify any receipt
35
+ +npx zambo-mcp verify acdfbed9-ee40-441d-9230-4f44632ca713
36
+ +```
37
+ +
38
+ +**Global install: the short `zambo` command.**
39
+ +
40
+ +```bash
41
+ +npm install -g zambo-mcp
42
+ +```
43
+ +
44
+ +```bash
45
+ +# One-command: describe any goal
46
+ +zambo "audit example.com for AI discoverability"
47
+ +
48
+ +# Call a specific tool directly
49
+ zambo call live_price '{"symbol":"BTC"}'
50
+ zambo call ghost_audit_site '{"url":"https://example.com"}'
51
+
52
+ @@ -38,17 +62,13 @@
53
+ zambo list
54
+
55
+ # Verify any receipt
56
+ -zambo verify f410acad-e438-48c3-acae-f37871a764b1
57
+ +zambo verify acdfbed9-ee40-441d-9230-4f44632ca713
58
+
59
+ # Teach your agents about Zambo (writes to AGENTS.md / CLAUDE.md / .muserules)
60
+ zambo init
61
+ ```
62
+
63
+ -Install it globally for the short `zambo` command:
64
+ -
65
+ -```bash
66
+ -npm install -g zambo-mcp
67
+ -```
68
+ +Installed locally only (`npm install zambo-mcp` inside a project)? Bare `zambo` is not on your PATH, so it will read as "command not found". Use the npx form above, or `./node_modules/.bin/zambo ...`. Every `zambo ...` command in the rest of this README assumes the global install; without it, prefix the same command with `npx zambo-mcp`.
69
+
70
+ Or use it from Node:
71
+
72
+ @@ -74,19 +94,20 @@
73
+
74
+ A real receipt from a live call:
75
+
76
+ -- Tool: `live_price` โ†’ BTC $86,175.00 USD (โ–ฒ 2.84% / 24h)
77
+ -- Receipt ID: `a71f243d-39e8-4eda-9c4b-2a31ae063ba9`
78
+ -- Time: 2026-09-22T08:49:53Z
79
+ -- Output hash: `sha256:ae5d2c1729fec0515dc05ea291d75f02860ce533bd3e87909cda899d93f4103f`
80
+ -- Inspect it yourself: https://zambo.dev/run/a71f243d-39e8-4eda-9c4b-2a31ae063ba9
81
+ +- Tool: `live_price` โ†’ BTC $76,975.00 USD (โ–ผ 1.14% / 24h)
82
+ +- Receipt ID: `acdfbed9-ee40-441d-9230-4f44632ca713`
83
+ +- Time: 2026-11-02T18:42:26Z
84
+ +- Output hash: `sha256:cc88b6a902be80fce61e0a110b8ee268b7a4ca72cf464d58d9e45b01ea521d4f`
85
+ +- Inspect it yourself: https://zambo.dev/run/acdfbed9-ee40-441d-9230-4f44632ca713
86
+
87
+ Honest scope: a receipt proves execution integrity, not correctness. It binds the result; it doesn't judge it.
88
+
89
+ Check any receipt in your browser or on the command line:
90
+
91
+ ```bash
92
+ -zambo verify <receipt-uuid> # confirms zambo.dev serves the receipt,
93
+ - # and shows tool, sha256, timestamp, audit URL
94
+ +npx zambo-mcp verify <receipt-uuid>
95
+ +# confirms zambo.dev serves the receipt, and shows tool, sha256, timestamp, audit URL
96
+ +# (with the global install, the same command is: zambo verify <receipt-uuid>)
97
+ ```
98
+
99
+ Receipt pages are real web pages with structured data (JSON-LD), Open Graph tags, and canonical URLs โ€” shareable, linkable, citable.
100
+ @@ -130,7 +151,7 @@
101
+
102
+ ## Where these receipts run live: Zambo
103
+
104
+ -zambo-mcp connects MCP clients to the live Zambo server, every call returning a verifiable AER-1 receipt, and it was downloaded 675 times on npm in the last month. The live home of those receipts is Zambo, the verifiable work layer for AI. Connect any AI to the live endpoint at https://zambo.dev/mcp or add Zambo to your AI in one step at https://zambo.dev/add/
105
+ +zambo-mcp connects MCP clients to the live Zambo server, every call returning a verifiable AER-1 receipt, and it has been downloaded 2,300+ times on npm (all-time). The live home of those receipts is Zambo, the verifiable work layer for AI. Connect any AI to the live endpoint at https://zambo.dev/mcp or add Zambo to your AI in one step at https://zambo.dev/add/
106
+
107
+ Free tier: 20 calls + 1 wrap-up free every day; picking up in another AI is always free. The Day Pass is $0.99 for 24 hours, unlimited.
108
+
109
+ --- /home/hatch/workspace/funnel-wave-2026-11-02/t5/npm-zambo-mcp/package/package.json 2026-11-02 13:48:42.015508652 +0000
110
+ +++ /home/hatch/workspace/zambo-mcp-fix-2026-11-02/package.json 2026-11-02 18:42:41.021005663 +0000
111
+ @@ -41,5 +41,5 @@
112
+ "main": "index.js",
113
+ "name": "zambo-mcp",
114
+ "repository": "https://zambo.dev",
115
+ - "version": "1.0.13"
116
+ + "version": "1.0.14"
117
+ }
118
+