toll402-mcp 0.2.1 → 0.3.0

package/README.md

@@ -1,10 +1,15 @@
 # toll402-mcp
 
-`npx -y toll402-mcp` — MCP (stdio) server exposing every tool at https://toll402.dev, paying per call in USDC via x402.
+MCP (stdio) server that exposes every tool at https://toll402.dev — web reading, PDF, email/fx, provenance (human vs synthetic), trusted lookup with citations, a verified business directory, community-forged tools and proxied x402 services — and **pays per call in USDC via x402**. No accounts, no API keys.
 
-Env: `TOLL402_URL` (default https://toll402.dev), `TOLL402_WALLET_KEY` (0x private key with USDC on Base; omit to use the free trial), `TOLL402_MAX_USD` (default 0.25).
+```bash
+npx -y toll402-mcp
+```
+
+Env: `TOLL402_URL` (default https://toll402.dev) · `TOLL402_WALLET_KEY` (0x private key holding a little USDC on Base; omit to use the free trial: 25 calls/day on cheap tools) · `TOLL402_MAX_USD` (cap per call, default 0.25).
 
-Claude Code / Cursor / Claude Desktop config:
+Claude Code / Cursor / Claude Desktop / OpenClaw:
 ```json
 { "mcpServers": { "toll402": { "command": "npx", "args": ["-y", "toll402-mcp"], "env": { "TOLL402_WALLET_KEY": "0x..." } } } }
 ```
+You are charged only when a call succeeds (2xx). Catalog and prices: https://toll402.dev/v1/catalog · Docs for agents: https://toll402.dev/llms.txt

package/dist/mcp.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+/**
+ * toll402-mcp — MCP (stdio) server that exposes every Toll402 tool to an agent and
+ * pays for calls automatically with x402 from a wallet you control.
+ *
+ * Env:
+ *   TOLL402_URL         base URL of the Toll402 server (default https://toll402.dev)
+ *   TOLL402_WALLET_KEY  0x-prefixed EVM private key holding USDC on Base (omit for free instances)
+ *   TOLL402_MAX_USD     max USD per single payment (default 0.25)
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
+import { ExactEvmScheme } from "@x402/evm/exact/client";
+import { privateKeyToAccount } from "viem/accounts";
+const BASE = (process.env.TOLL402_URL ?? "https://toll402.dev").replace(/\/$/, "");
+const KEY = process.env.TOLL402_WALLET_KEY;
+const MAX_USD = process.env.TOLL402_MAX_USD ?? "0.25";
+async function main() {
+    const res = await fetch(`${BASE}/v1/catalog`);
+    if (!res.ok)
+        throw new Error(`Could not load catalog from ${BASE}: HTTP ${res.status}`);
+    const catalog = (await res.json());
+    catalog.tools = catalog.tools.filter((t) => t.available !== false);
+    const byName = new Map(catalog.tools.map((t) => [t.name, t]));
+    let paidFetch = fetch;
+    if (KEY) {
+        const account = privateKeyToAccount(KEY);
+        paidFetch = wrapFetchWithPaymentFromConfig(fetch, {
+            schemes: [{ network: "eip155:*", client: new ExactEvmScheme(account) }],
+            spendControls: { maxAmountPerPayment: `$${MAX_USD}` },
+        });
+        console.error(`toll402-mcp: paying from ${account.address} on ${catalog.payment.networkName ?? "?"} (max $${MAX_USD}/call)`);
+    }
+    else {
+        console.error("toll402-mcp: TOLL402_WALLET_KEY not set — calls will fail with 402 unless the server is free");
+    }
+    const server = new Server({ name: "toll402", version: "0.1.0" }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: catalog.tools.map((t) => ({
+            name: t.name,
+            description: `[${t.kind ?? "tool"}] ${t.description} (costs ${t.price} per call, paid automatically in USDC via x402)`,
+            inputSchema: t.inputSchema,
+        })),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (req) => {
+        const t = byName.get(req.params.name);
+        if (!t)
+            return { isError: true, content: [{ type: "text", text: `Unknown tool ${req.params.name}` }] };
+        const r = await paidFetch(`${BASE}${t.path}`, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify(req.params.arguments ?? {}),
+        });
+        const text = await r.text();
+        if (!r.ok)
+            return { isError: true, content: [{ type: "text", text: `HTTP ${r.status}: ${text.slice(0, 2000)}` }] };
+        let out = text;
+        try {
+            const j = JSON.parse(text);
+            out = JSON.stringify(j.result ?? j, null, 2);
+        }
+        catch {
+            /* leave as-is */
+        }
+        const paid = r.headers.get("payment-response") ? `\n\n[paid ${t.price} via x402]` : "";
+        return { content: [{ type: "text", text: out + paid }] };
+    });
+    await server.connect(new StdioServerTransport());
+    console.error(`toll402-mcp: ${catalog.tools.length} tools from ${BASE} ready`);
+}
+main().catch((e) => {
+    console.error("toll402-mcp fatal:", e);
+    process.exit(1);
+});

package/package.json

@@ -1,13 +1,21 @@
 {
   "name": "toll402-mcp",
-  "version": "0.2.1",
-  "description": "MCP server for Toll402 (https://toll402.dev): every Toll402 tool as MCP tools, paid per call in USDC via x402. Thin launcher over the `toll402` package.",
+  "version": "0.3.0",
+  "description": "MCP server for Toll402 (https://toll402.dev): every Toll402 tool as MCP tools, paid per call in USDC via x402. No accounts, no API keys.",
   "type": "module",
-  "bin": { "toll402-mcp": "./bin.js" },
-  "files": ["bin.js", "README.md"],
-  "dependencies": { "toll402": "^0.2.1" },
+  "bin": { "toll402-mcp": "./dist/mcp.js" },
+  "files": ["dist", "README.md"],
+  "scripts": { "build": "tsc -p tsconfig.json", "prepublishOnly": "npm run build" },
+  "engines": { "node": ">=20" },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "@x402/evm": "~2.25.0",
+    "@x402/fetch": "~2.25.0",
+    "viem": "^2.56.3"
+  },
+  "devDependencies": { "@types/node": "^22", "typescript": "^5.7.0" },
   "license": "MIT",
   "homepage": "https://toll402.dev",
-  "repository": { "type": "git", "url": "https://gitlab.com/toll402/toll402" },
-  "keywords": ["mcp", "x402", "ai-agents", "usdc", "tools"]
+  "repository": { "type": "git", "url": "https://gitlab.com/toll402/toll402-sdk" },
+  "keywords": ["mcp", "x402", "ai-agents", "usdc", "base", "tools", "toll402"]
 }

package/bin.js

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-// Launcher: `npx -y toll402-mcp` → runs the MCP server shipped in the `toll402` package.
-import("toll402/dist/mcp.js").catch((e) => { console.error("toll402-mcp:", e.message); process.exit(1); });