@quackai/q402-mcp 0.3.9 → 0.3.10
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 +47 -5
- package/dist/index.js +1 -1
- package/package.json +7 -2
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# @quackai/q402-mcp
|
|
2
2
|
|
|
3
|
-
> MCP server for Q402 — gasless USDC, USDT, and RLUSD payments across 7 EVM chains, callable
|
|
3
|
+
> MCP server for Q402 — gasless USDC, USDT, and RLUSD payments across 7 EVM chains, callable from Claude (Desktop / Code), OpenAI Codex CLI, and any other Model Context Protocol client.
|
|
4
4
|
|
|
5
5
|
[](https://www.npmjs.com/package/@quackai/q402-mcp)
|
|
6
6
|
[](./LICENSE)
|
|
@@ -13,13 +13,17 @@ Claude can now reason about stablecoin payments end to end — quote a transfer
|
|
|
13
13
|
|
|
14
14
|
---
|
|
15
15
|
|
|
16
|
-
## Quick start
|
|
16
|
+
## Quick start
|
|
17
|
+
|
|
18
|
+
The server speaks stdio MCP, so any MCP-compatible client can use it. The two paths verified end-to-end today are **Claude (Desktop / Code)** and **OpenAI Codex CLI**.
|
|
19
|
+
|
|
20
|
+
### Claude Desktop / Claude Code
|
|
17
21
|
|
|
18
22
|
```bash
|
|
19
23
|
claude mcp add q402 -- npx -y @quackai/q402-mcp
|
|
20
24
|
```
|
|
21
25
|
|
|
22
|
-
Or
|
|
26
|
+
Or edit `claude_desktop_config.json` directly:
|
|
23
27
|
|
|
24
28
|
```json
|
|
25
29
|
{
|
|
@@ -36,7 +40,45 @@ Restart Claude Desktop and ask:
|
|
|
36
40
|
|
|
37
41
|
> *"Compare gas costs to send 50 USDC to vitalik.eth across all 7 Q402 chains."*
|
|
38
42
|
|
|
39
|
-
|
|
43
|
+
### OpenAI Codex CLI
|
|
44
|
+
|
|
45
|
+
One-liner using Codex's built-in registration command:
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
codex mcp add q402 -- npx -y @quackai/q402-mcp
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
Or edit `~/.codex/config.toml` directly (`.codex/config.toml` for per-project scope):
|
|
52
|
+
|
|
53
|
+
```toml
|
|
54
|
+
[mcp_servers.q402]
|
|
55
|
+
command = "npx"
|
|
56
|
+
args = ["-y", "@quackai/q402-mcp"]
|
|
57
|
+
startup_timeout_sec = 20.0
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
To enable real on-chain payments, pass the three live-mode env vars **explicitly** under `env` — Codex does **not** forward host env vars by default:
|
|
61
|
+
|
|
62
|
+
```toml
|
|
63
|
+
[mcp_servers.q402]
|
|
64
|
+
command = "npx"
|
|
65
|
+
args = ["-y", "@quackai/q402-mcp"]
|
|
66
|
+
startup_timeout_sec = 20.0
|
|
67
|
+
env = {
|
|
68
|
+
Q402_API_KEY = "q402_live_...",
|
|
69
|
+
Q402_PRIVATE_KEY = "0xabc...",
|
|
70
|
+
Q402_ENABLE_REAL_PAYMENTS = "1",
|
|
71
|
+
Q402_MAX_AMOUNT_PER_CALL = "5",
|
|
72
|
+
}
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
> If you'd rather not inline secrets in `config.toml`, use the `env_vars` allow-list form to forward specific names from your shell environment instead — see the [Codex config reference](https://developers.openai.com/codex/config-reference) for the full schema.
|
|
76
|
+
|
|
77
|
+
Then run `codex` and ask the same kind of question. The first call may take a few seconds while `npx` warms its cache; subsequent calls are instant.
|
|
78
|
+
|
|
79
|
+
### Any other MCP client
|
|
80
|
+
|
|
81
|
+
The server has no client-specific code. If your client speaks stdio MCP, point it at `npx -y @quackai/q402-mcp` and the four tools listed below will appear.
|
|
40
82
|
|
|
41
83
|
---
|
|
42
84
|
|
|
@@ -63,7 +105,7 @@ You'll get a ranked breakdown immediately — no API key, no signup, no funds at
|
|
|
63
105
|
|
|
64
106
|
## Sandbox vs live mode
|
|
65
107
|
|
|
66
|
-
By default the MCP server operates in **sandbox mode**: `q402_pay` returns a deterministic-looking fake transaction hash, no funds move, no gas-tank credit is consumed. That makes it safe to plug into any
|
|
108
|
+
By default the MCP server operates in **sandbox mode**: `q402_pay` returns a deterministic-looking fake transaction hash, no funds move, no gas-tank credit is consumed. That makes it safe to plug into any MCP client without worrying about an LLM hallucinating a payment.
|
|
67
109
|
|
|
68
110
|
To enable real on-chain transactions, **all three** environment variables must be set:
|
|
69
111
|
|
package/dist/index.js
CHANGED
|
@@ -1028,7 +1028,7 @@ var RECEIPT_TOOL = {
|
|
|
1028
1028
|
|
|
1029
1029
|
// src/index.ts
|
|
1030
1030
|
var PACKAGE_NAME = "@quackai/q402-mcp";
|
|
1031
|
-
var PACKAGE_VERSION = "0.3.
|
|
1031
|
+
var PACKAGE_VERSION = "0.3.10";
|
|
1032
1032
|
function jsonText(value) {
|
|
1033
1033
|
return { type: "text", text: JSON.stringify(value, null, 2) };
|
|
1034
1034
|
}
|
package/package.json
CHANGED
|
@@ -1,12 +1,17 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@quackai/q402-mcp",
|
|
3
|
-
"version": "0.3.
|
|
4
|
-
"description": "MCP server for Q402 — gasless USDC, USDT, and RLUSD payments across 7 EVM chains, callable
|
|
3
|
+
"version": "0.3.10",
|
|
4
|
+
"description": "MCP server for Q402 — gasless USDC, USDT, and RLUSD payments across 7 EVM chains, callable from Claude (Desktop / Code), OpenAI Codex CLI, and any other Model Context Protocol client.",
|
|
5
5
|
"mcpName": "io.github.bitgett/q402-mcp",
|
|
6
6
|
"keywords": [
|
|
7
7
|
"mcp",
|
|
8
8
|
"model-context-protocol",
|
|
9
9
|
"claude",
|
|
10
|
+
"claude-desktop",
|
|
11
|
+
"claude-code",
|
|
12
|
+
"codex",
|
|
13
|
+
"openai-codex",
|
|
14
|
+
"cline",
|
|
10
15
|
"q402",
|
|
11
16
|
"x402",
|
|
12
17
|
"stablecoin",
|