chaink9-mcp 0.1.3 → 0.2.0

package/README.md

@@ -9,8 +9,8 @@ forks the chain and really buys and sells the token through its market (PancakeS
 Uniswap V2, V3 or V4, hooks included), then runs 70+ checks. A honeypot is caught by what it
 does, not by what its code looks like.
 
-Each successful call is paid automatically in **USDC on Base** with the
-[x402](https://x402.org) protocol, from a wallet you choose. There is no account and no API
+Each successful call is paid automatically in **USDC on Base** or **USDT on BNB Smart Chain**
+with the [x402](https://x402.org) protocol, from a wallet you choose. There is no account and no API
 key, and failed calls (bad input, not a token, no liquidity, engine busy) are free.
 
 ## Tools
@@ -42,6 +42,9 @@ Every tool takes `chain`: `bsc` (default), `eth`, `base` or `arc`. `trace` takes
 
 1. Make a **new wallet just for this** and put a few dollars of **USDC on Base** in it. It
    needs no ETH: x402 payments are signatures, and the payment service pays the gas.
+   To pay on BNB Smart Chain instead, put **USDT on BSC** in it plus about $0.01 of **BNB**, and
+   set `CHAINK9_PAY_NETWORK=bsc`. BSC's USDT is paid through Permit2: the first payment also
+   signs a one-time approval, which is the only thing that uses the BNB.
 2. Add the server to your MCP client with that wallet's private key.
 
 Claude Code:
@@ -80,12 +83,13 @@ clients can connect and use `verdict`; to pay from those, use the package above.
 
 | Variable | Default | Meaning |
 |---|---|---|
-| `CHAINK9_PRIVATE_KEY` | (required) | Private key of the dedicated Base wallet that pays. |
+| `CHAINK9_PRIVATE_KEY` | (required) | Private key of the dedicated wallet that pays. |
+| `CHAINK9_PAY_NETWORK` | `base` | `base` pays in USDC on Base, `bsc` in USDT on BNB Smart Chain. |
 | `CHAINK9_MAX_USD_PER_CALL` | `0.05` | Any single payment above this is refused. |
 | `CHAINK9_MAX_USD_PER_DAY` | `1` | Stops paying once this much was spent today (UTC). |
 
 The daily total is kept in `~/.chaink9-mcp/spend.json`. The wallet only ever signs payments
-on Base, and the key never leaves your machine.
+on the network you chose, and the key never leaves your machine.
 
 ## Disclaimer
 

package/index.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
-// chaink9-mcp: ChainK9's token risk checks as MCP tools, paid per call with x402 (USDC on Base).
+// chaink9-mcp: ChainK9's token risk checks as MCP tools, paid per call with x402 (USDC on Base,
+// or USDT on BNB Smart Chain).
 // Tools come from the live catalog (https://api.chaink9.com/openapi.json), so new products
 // appear without updating this package.
 
@@ -12,10 +13,27 @@ import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprot
 import { decodePaymentResponseHeader, wrapFetchWithPaymentFromConfig } from "@x402/fetch";
 import { ExactEvmScheme } from "@x402/evm";
 import { privateKeyToAccount } from "viem/accounts";
+import { parseUnits } from "viem";
 
 const VERSION = JSON.parse(readFileSync(new URL("./package.json", import.meta.url), "utf8")).version;
 const API = "https://api.chaink9.com";
-const BASE_MAINNET = "eip155:8453"; // ChainK9 is paid in USDC on Base only
+// Where the wallet pays. BSC's USDT has no EIP-3009, so it goes through Permit2: the first payment
+// also signs a one-time approval, which needs a little BNB for gas.
+const NETWORKS = {
+  base: { id: "eip155:8453", label: "USDC on Base", wallet: "a little USDC on Base (no ETH needed)" },
+  bsc: {
+    id: "eip155:56",
+    label: "USDT on BNB Smart Chain",
+    wallet: "a little USDT on BNB Smart Chain, plus about $0.01 of BNB for the one-time Permit2 approval",
+    usdt: "0x55d398326f99059fF775485246999027B3197955",
+    rpcUrl: "https://bsc-dataseed.bnbchain.org", // reads the Permit2 allowance, prices the approval
+  },
+};
+const PAY = NETWORKS[(process.env.CHAINK9_PAY_NETWORK || "base").trim().toLowerCase()];
+if (!PAY) {
+  console.error(`[chaink9] CHAINK9_PAY_NETWORK must be one of: ${Object.keys(NETWORKS).join(", ")}`);
+  process.exit(1);
+}
 const MAX_PER_CALL = Number(process.env.CHAINK9_MAX_USD_PER_CALL || 0.05);
 const MAX_PER_DAY = Number(process.env.CHAINK9_MAX_USD_PER_DAY || 1);
 const DIR = join(homedir(), ".chaink9-mcp");
@@ -40,7 +58,7 @@ async function loadCatalog() {
       price,
       tool: {
         name,
-        description: `${op.description || op.summary || name} Costs $${price} per successful call, paid automatically in USDC on Base; failed calls are free.`,
+        description: `${op.description || op.summary || name} Costs $${price} per successful call, paid automatically in ${PAY.label}; failed calls are free.`,
         inputSchema: op.requestBody?.content?.["application/json"]?.schema ?? { type: "object", properties: {} },
       },
     });
@@ -55,11 +73,16 @@ function payer() {
   if (payFetch) return payFetch;
   const key = process.env.CHAINK9_PRIVATE_KEY;
   if (!key) return null;
-  // The x402 client signs only Base payments and refuses any single one above the cap,
-  // whatever a server asks for.
+  // The x402 client signs payments on PAY's network only and refuses any single one above the cap,
+  // whatever a server asks for. x402 clients pay only in tokens they know by default; BSC's USDT
+  // isn't one, so it's opted in with the same cap in its 18 decimals.
+  const account = privateKeyToAccount(key);
   payFetch = wrapFetchWithPaymentFromConfig(fetch, {
-    schemes: [{ network: BASE_MAINNET, client: new ExactEvmScheme(privateKeyToAccount(key)) }],
-    spendControls: { maxAmountPerPayment: `$${MAX_PER_CALL}` },
+    schemes: [{ network: PAY.id, client: PAY.rpcUrl ? new ExactEvmScheme(account, { 56: { rpcUrl: PAY.rpcUrl } }) : new ExactEvmScheme(account) }],
+    spendControls: {
+      maxAmountPerPayment: `$${MAX_PER_CALL}`,
+      ...(PAY.usdt && { allowedAssets: [{ network: PAY.id, asset: PAY.usdt, maxAmountPerPayment: parseUnits(String(MAX_PER_CALL), 18).toString() }] }),
+    },
   });
   return payFetch;
 }
@@ -88,7 +111,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
   const entry = (await loadCatalog()).get(req.params.name);
   if (!entry) return fail(`Unknown tool ${req.params.name}.`);
   const pay = payer();
-  if (!pay) return fail("No wallet configured. Set CHAINK9_PRIVATE_KEY to the private key of a dedicated Base wallet holding a little USDC (no ETH needed); see https://api.chaink9.com.");
+  if (!pay) return fail(`No wallet configured. Set CHAINK9_PRIVATE_KEY to the private key of a dedicated wallet holding ${PAY.wallet}; see https://api.chaink9.com.`);
   if (!(entry.price <= MAX_PER_CALL)) return fail(`${req.params.name} costs $${entry.price}, above CHAINK9_MAX_USD_PER_CALL ($${MAX_PER_CALL}).`);
   if (spentToday() + entry.price > MAX_PER_DAY) return fail(`Daily limit reached: $${spentToday()} of CHAINK9_MAX_USD_PER_DAY ($${MAX_PER_DAY}) spent today.`);
 
@@ -116,4 +139,4 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
 });
 
 await server.connect(new StdioServerTransport());
-log(`chaink9-mcp ${VERSION} ready (limits: $${MAX_PER_CALL}/call, $${MAX_PER_DAY}/day)`);
+log(`chaink9-mcp ${VERSION} ready (pays in ${PAY.label}; limits: $${MAX_PER_CALL}/call, $${MAX_PER_DAY}/day)`);

package/manifest.json

@@ -2,12 +2,19 @@
   "manifest_version": "0.3",
   "name": "chaink9",
   "display_name": "ChainK9 token risk checks",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "icon": "icon.png",
-  "description": "Check a token on BNB Smart Chain, Ethereum, Base or Arc for honeypots, hidden taxes and owner traps before buying it. Paid per call in USDC on Base.",
-  "long_description": "ChainK9 checks a token by doing what a buyer would: it forks the chain and really buys and sells the token through its market (Uniswap or PancakeSwap V2, V3 or V4, hooks included), then runs 70+ checks: honeypot, buy and sell taxes and how they change, owner pause, blacklist, mint and confiscation powers, transfer and sell limits, liquidity, upgrade authority and more. Tools also simulate a trade for a given wallet, test exits, preview a transaction, read liquidity, follow new launches and follow the money out of a transaction. There is no account and no API key: each successful call is paid automatically in USDC on Base with the x402 protocol, from a wallet you choose; failed calls are free. Use a dedicated wallet holding a few dollars of USDC; the per-call and per-day limits below are a second safety net. Results are evidence from a private copy of the chain at one block, not a guarantee and not financial advice.",
-  "author": { "name": "ChainK9", "email": "hello@chaink9.com", "url": "https://chaink9.com" },
-  "repository": { "type": "git", "url": "https://github.com/ChainK9/chaink9-mcp" },
+  "description": "Check a token on BNB Smart Chain, Ethereum, Base or Arc for honeypots, hidden taxes and owner traps before buying it. Paid per call in USDC on Base or USDT on BNB Smart Chain.",
+  "long_description": "ChainK9 checks a token by doing what a buyer would: it forks the chain and really buys and sells the token through its market (Uniswap or PancakeSwap V2, V3 or V4, hooks included), then runs 70+ checks: honeypot, buy and sell taxes and how they change, owner pause, blacklist, mint and confiscation powers, transfer and sell limits, liquidity, upgrade authority and more. Tools also simulate a trade for a given wallet, test exits, preview a transaction, read liquidity, follow new launches and follow the money out of a transaction. There is no account and no API key: each successful call is paid automatically in USDC on Base or USDT on BNB Smart Chain with the x402 protocol, from a wallet you choose; failed calls are free. Use a dedicated wallet holding a few dollars of USDC on Base (or USDT plus a little BNB on BSC); the per-call and per-day limits below are a second safety net. Results are evidence from a private copy of the chain at one block, not a guarantee and not financial advice.",
+  "author": {
+    "name": "ChainK9",
+    "email": "hello@chaink9.com",
+    "url": "https://chaink9.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ChainK9/chaink9-mcp"
+  },
   "homepage": "https://chaink9.com",
   "support": "https://github.com/ChainK9/chaink9-mcp/issues",
   "server": {
@@ -15,26 +22,55 @@
     "entry_point": "index.js",
     "mcp_config": {
       "command": "node",
-      "args": ["${__dirname}/index.js"],
+      "args": [
+        "${__dirname}/index.js"
+      ],
       "env": {
         "CHAINK9_PRIVATE_KEY": "${user_config.private_key}",
         "CHAINK9_MAX_USD_PER_CALL": "${user_config.max_usd_per_call}",
-        "CHAINK9_MAX_USD_PER_DAY": "${user_config.max_usd_per_day}"
+        "CHAINK9_MAX_USD_PER_DAY": "${user_config.max_usd_per_day}",
+        "CHAINK9_PAY_NETWORK": "${user_config.pay_network}"
       }
     }
   },
   "tools_generated": true,
-  "keywords": ["token security", "honeypot", "rug pull", "bsc", "ethereum", "base", "x402", "usdc"],
+  "keywords": [
+    "token security",
+    "honeypot",
+    "rug pull",
+    "bsc",
+    "ethereum",
+    "base",
+    "x402",
+    "usdc",
+    "usdt"
+  ],
   "license": "MIT",
-  "compatibility": { "platforms": ["darwin", "win32", "linux"], "runtimes": { "node": ">=20.0.0" } },
+  "compatibility": {
+    "platforms": [
+      "darwin",
+      "win32",
+      "linux"
+    ],
+    "runtimes": {
+      "node": ">=20.0.0"
+    }
+  },
   "user_config": {
     "private_key": {
       "type": "string",
-      "title": "Base wallet private key",
-      "description": "0x + 64 hex. A NEW, dedicated wallet holding a few dollars of USDC on Base (no ETH needed). Never your main wallet.",
+      "title": "Wallet private key",
+      "description": "0x + 64 hex. A NEW, dedicated wallet holding a few dollars of USDC on Base (no ETH needed), or USDT plus about $0.01 of BNB on BNB Smart Chain. Never your main wallet.",
       "sensitive": true,
       "required": true
     },
+    "pay_network": {
+      "type": "string",
+      "title": "Pay on",
+      "description": "base: USDC on Base. bsc: USDT on BNB Smart Chain.",
+      "default": "base",
+      "required": false
+    },
     "max_usd_per_call": {
       "type": "number",
       "title": "Max USD per call",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chaink9-mcp",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "description": "MCP server for ChainK9: token risk checks on BNB Smart Chain, Ethereum, Base and Arc. It buys and sells the token on a private fork of the chain to catch honeypots, hidden taxes and owner traps. Paid per call in USDC on Base with x402.",
   "mcpName": "com.chaink9/chaink9",
   "type": "module",