@clawbank/mcp-server 1.0.0 → 1.0.1

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 (2) hide show
  1. package/README.md +56 -21
  2. package/package.json +4 -2
package/README.md CHANGED
@@ -2,7 +2,9 @@
2
2
 
3
3
  MCP (Model Context Protocol) server for [ClawBank](https://clawbank.vercel.app) — programmable AI agent wallets on Solana.
4
4
 
5
- Gives Claude (and any MCP-compatible AI client) three tools:
5
+ Works with **Claude Desktop**, **Cursor**, **OpenAI Codex CLI**, and any other MCP-compatible client.
6
+
7
+ Gives your AI three tools:
6
8
 
7
9
  | Tool | Description |
8
10
  |------|-------------|
@@ -12,15 +14,43 @@ Gives Claude (and any MCP-compatible AI client) three tools:
12
14
 
13
15
  ---
14
16
 
15
- ## Setup
16
-
17
- ### 1. Create an agent
17
+ ## Step 1 — Create an agent
18
18
 
19
19
  Sign up at [clawbank.vercel.app](https://clawbank.vercel.app), create an agent from the dashboard, and copy your **API key** (`cb_...`).
20
20
 
21
- ### 2. Add to Claude Desktop
21
+ ---
22
+
23
+ ## Step 2 — Add to your AI client
24
+
25
+ ### Claude Desktop
26
+
27
+ Config file:
28
+ - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
29
+ - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
30
+
31
+ ```json
32
+ {
33
+ "mcpServers": {
34
+ "clawbank": {
35
+ "command": "npx",
36
+ "args": ["-y", "@clawbank/mcp-server"],
37
+ "env": {
38
+ "CLAWBANK_API_KEY": "cb_your_api_key_here"
39
+ }
40
+ }
41
+ }
42
+ }
43
+ ```
44
+
45
+ Restart Claude Desktop. ClawBank tools appear in the tool picker.
46
+
47
+ ---
48
+
49
+ ### Cursor
22
50
 
23
- Open `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows) and add:
51
+ Config file:
52
+ - Global: `~/.cursor/mcp.json`
53
+ - Project-only: `.cursor/mcp.json` (in repo root)
24
54
 
25
55
  ```json
26
56
  {
@@ -36,11 +66,28 @@ Open `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) o
36
66
  }
37
67
  ```
38
68
 
39
- Restart Claude Desktop. You'll see ClawBank tools appear in the tool picker.
69
+ Or via Cursor settings: **Settings → MCP → Add new MCP server** and paste the block above.
40
70
 
41
- ### 3. Use it
71
+ ---
72
+
73
+ ### OpenAI Codex CLI
74
+
75
+ Config file: `~/.codex/config.toml`
42
76
 
43
- Ask Claude:
77
+ ```toml
78
+ [mcp_servers.clawbank]
79
+ command = "npx"
80
+ args = ["-y", "@clawbank/mcp-server"]
81
+
82
+ [mcp_servers.clawbank.env]
83
+ CLAWBANK_API_KEY = "cb_your_api_key_here"
84
+ ```
85
+
86
+ ---
87
+
88
+ ## Step 3 — Use it
89
+
90
+ Ask your AI:
44
91
  - _"What's my ClawBank balance?"_
45
92
  - _"Send 0.01 SOL to `<address>` with memo 'invoice 42'"_
46
93
  - _"Is ClawBank healthy?"_
@@ -56,18 +103,6 @@ Ask Claude:
56
103
 
57
104
  ---
58
105
 
59
- ## Local development
60
-
61
- ```bash
62
- git clone https://github.com/clawbank/clawbank
63
- cd artifacts/mcp-server
64
- pnpm install
65
- pnpm build
66
- CLAWBANK_API_KEY=cb_xxx node dist/index.js
67
- ```
68
-
69
- ---
70
-
71
106
  ## How it works
72
107
 
73
108
  Each API call uses your agent's API key (`Authorization: Bearer <key>`). ClawBank verifies it against the stored hash, then executes the action on the agent's dedicated Solana wallet.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@clawbank/mcp-server",
3
- "version": "1.0.0",
3
+ "version": "1.0.1",
4
4
  "description": "MCP server for ClawBank — programmable AI agent wallets on Solana",
5
5
  "type": "module",
6
6
  "bin": {
@@ -25,7 +25,9 @@
25
25
  "ai-agent",
26
26
  "wallet",
27
27
  "clawbank",
28
- "web3"
28
+ "web3",
29
+ "cursor",
30
+ "codex"
29
31
  ],
30
32
  "author": "ClawBank",
31
33
  "license": "MIT",