x402node-mcp 0.1.0 → 0.1.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.
- package/README.md +27 -16
- package/package.json +2 -1
package/README.md
CHANGED
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
<!-- mcp-name: io.github.x402node/x402-mcp -->
|
|
2
|
+
|
|
1
3
|
# x402-mcp
|
|
2
4
|
|
|
3
5
|
MCP server bringing 100+ x402-paid APIs to AI agents (Claude, Cursor, MCP-aware clients). Auto-discovers tools from CDP Bazaar; handles USDC micropayments on Base.
|
|
@@ -10,18 +12,7 @@ MCP server bringing 100+ x402-paid APIs to AI agents (Claude, Cursor, MCP-aware
|
|
|
10
12
|
- Handles HTTP 402 + USDC payment automatically
|
|
11
13
|
- Multi-chain ready via x402 protocol (Base today; Solana, Polygon, BNB, EVM expansion)
|
|
12
14
|
|
|
13
|
-
## Install
|
|
14
|
-
|
|
15
|
-
```bash
|
|
16
|
-
git clone https://github.com/x402node/x402-mcp
|
|
17
|
-
cd x402-mcp
|
|
18
|
-
npm install
|
|
19
|
-
cp .env.example .env
|
|
20
|
-
```
|
|
21
|
-
|
|
22
|
-
Edit `.env`: set `X402_PRIVATE_KEY` to a Base EOA with USDC.
|
|
23
|
-
|
|
24
|
-
## Use with Claude Desktop
|
|
15
|
+
## Install (Claude Desktop)
|
|
25
16
|
|
|
26
17
|
Add to `claude_desktop_config.json`:
|
|
27
18
|
|
|
@@ -29,23 +20,43 @@ Add to `claude_desktop_config.json`:
|
|
|
29
20
|
{
|
|
30
21
|
"mcpServers": {
|
|
31
22
|
"x402-mcp": {
|
|
32
|
-
"command": "
|
|
33
|
-
"args": ["
|
|
34
|
-
"env": { "X402_PRIVATE_KEY": "
|
|
23
|
+
"command": "npx",
|
|
24
|
+
"args": ["-y", "x402node-mcp"],
|
|
25
|
+
"env": { "X402_PRIVATE_KEY": "0xYOUR_BASE_PRIVATE_KEY" }
|
|
35
26
|
}
|
|
36
27
|
}
|
|
37
28
|
}
|
|
38
29
|
```
|
|
39
30
|
|
|
31
|
+
Set `X402_PRIVATE_KEY` to a Base EOA private key (hex, 0x-prefixed) with USDC on Base mainnet. Restart Claude Desktop. The server auto-discovers ~117 tools on first run.
|
|
32
|
+
|
|
33
|
+
## Cost Safety
|
|
34
|
+
|
|
35
|
+
- Each tool call costs $0.0001-$0.10 USDC depending on endpoint
|
|
36
|
+
- Hard cap: `MAX_PRICE_USD` env var (default $0.10/call); calls above are blocked
|
|
37
|
+
- Use a fresh burner wallet, not your main wallet
|
|
38
|
+
|
|
40
39
|
## How it works
|
|
41
40
|
|
|
42
|
-
Agent calls tool
|
|
41
|
+
Agent calls tool -> HTTP 402 -> x402-fetch signs EIP-3009 -> CDP Facilitator settles on Base -> response returned. Buyer pays no gas.
|
|
42
|
+
|
|
43
|
+
## Development
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
git clone https://github.com/x402node/x402-mcp
|
|
47
|
+
cd x402-mcp
|
|
48
|
+
npm install
|
|
49
|
+
cp .env.example .env # edit X402_PRIVATE_KEY
|
|
50
|
+
node mcp-server.js
|
|
51
|
+
```
|
|
43
52
|
|
|
44
53
|
## Links
|
|
45
54
|
|
|
46
55
|
- x402 protocol: https://x402.org
|
|
47
56
|
- CDP Bazaar: https://docs.cdp.coinbase.com/x402/bazaar
|
|
48
57
|
- MCP: https://modelcontextprotocol.io
|
|
58
|
+
- npm: https://www.npmjs.com/package/x402node-mcp
|
|
59
|
+
- Glama: https://glama.ai/mcp/servers/x402node/x402-mcp
|
|
49
60
|
|
|
50
61
|
## License
|
|
51
62
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "x402node-mcp",
|
|
3
|
-
"
|
|
3
|
+
"mcpName": "io.github.x402node/x402-mcp",
|
|
4
|
+
"version": "0.1.1",
|
|
4
5
|
"description": "MCP server that exposes x402 paid APIs as Model Context Protocol tools. Auto-discovers endpoints from the Coinbase Bazaar registry and handles USDC payments on Base mainnet transparently.",
|
|
5
6
|
"type": "module",
|
|
6
7
|
"main": "mcp-server.js",
|