hookit-mcp 0.2.1 → 0.2.2

package/README.md

@@ -30,7 +30,7 @@ Optional env: `HOOKIT_API_URL` (default `https://www.hookit.fun`), `HOOKIT_RPC_U
 | `wallet_status` | The wallet's ETH and USDG, the hookit.fun coins it holds with their value, its open floor loans, and whether it can launch. |
 | `launch_token` | Launches in one call, with an optional `devBuyPct`. `dryRun: true` checks and simulates without signing. |
 | `claim_fees` | Collects the creator fees the wallet earned on coins it launched. |
-| `send_eth` | Sends ETH from the wallet, for example back to a Kraken deposit address on Ink. `dryRun: true` checks only. |
+| `send_eth` | Sends ETH from the wallet, for example back to a Kraken deposit address on Ink. Refuses less than 0.001 ETH, Kraken's minimum deposit (`belowKrakenMinimum: true` for an address that is not Kraken). `dryRun: true` checks only. |
 | `agent_pass_challenge` | Step 1 for AI-agents-only coins: five short tasks for the Hookit Agent Pass check (or "already a holder"). `{ agentId? }` for an ERC-8004 validation (below). |
 | `claim_agent_pass` | Step 2: `{ id, answers, agentId?, requestHash? }` within 30 seconds; signs the answers with the wallet and claims the pass on chain. With `agentId`, gets Hookit's ERC-8004 validation instead (below). |
 | `list_coins` | Coins to trade: newest, top market cap, volume or 24h gainers; filters for AI-agents-only, launched by agents, Backed Floor and Boss Raid coins, a pair, or a name. |

package/index.js

@@ -34,7 +34,7 @@ import { z } from "zod";
 const API = (process.env.HOOKIT_API_URL || "https://www.hookit.fun").replace(/\/$/, "");
 const RPC = process.env.HOOKIT_RPC_URL || "https://rpc-gel.inkonchain.com";
 const KEY = process.env.HOOKIT_PRIVATE_KEY?.trim();
-const VERSION = "0.2.1";
+const VERSION = "0.2.2";
 const EXPLORER = "https://explorer.inkonchain.com";
 /**
  * The Ink deployments this server signs against. Pinned here, never taken from hookit.fun's catalog: a compromised
@@ -95,6 +95,8 @@ const SWAP_MIN_GAS = 650_000n;
 /** FloorLoanPlugin durations (days) and their upfront fee (bps of the loan). */
 const LOAN_FEES_BPS = { 7: 100, 14: 175, 30: 300, 60: 500, 90: 700 };
 const ETH = { address: zeroAddress, symbol: "ETH", decimals: 18 };
+/** Kraken's minimum ETH deposit on Ink: smaller deposits are marked failed and lost. */
+const KRAKEN_MIN_DEPOSIT_WEI = parseEther("0.001");
 
 const ink = defineChain({
   id: 57073,
@@ -1719,14 +1721,18 @@ server.registerTool(
   "send_eth",
   {
     description:
-      "Sends ETH from this wallet on Ink, for example to cash out to the user's Kraken ETH deposit address on the Ink network (get it with the Kraken MCP deposit addresses tool for the \"ETH - Ink\" method only). Kraken's minimum ETH deposit on Ink is 0.001 ETH; smaller deposits fail and the funds are lost, so never send less. Run it with dryRun first and repeat the address and amount to the user before sending.",
+      "Sends ETH from this wallet on Ink, for example to cash out to the user's Kraken ETH deposit address on the Ink network (get it with the Kraken MCP deposit addresses tool for the \"ETH - Ink\" method only). Kraken's minimum ETH deposit on Ink is 0.001 ETH; smaller deposits fail and the funds are lost, so it refuses to send less unless belowKrakenMinimum is set for an address that is not Kraken. Run it with dryRun first and repeat the address and amount to the user before sending.",
     inputSchema: {
       to: z.string().describe("Destination address on Ink."),
-      amountEth: z.string().describe('Amount in ETH, or "max" to send everything except gas.'),
+      amountEth: z.string().describe('Amount in ETH, or "max" to send everything except gas. At least 0.001 ETH.'),
+      belowKrakenMinimum: z
+        .boolean()
+        .optional()
+        .describe("Allows less than 0.001 ETH. Only for an address that is not a Kraken deposit address: Kraken loses smaller deposits."),
       dryRun: z.boolean().optional().describe("Check only. Signs nothing."),
     },
   },
-  serialized(async ({ to, amountEth, dryRun }) => {
+  serialized(async ({ to, amountEth, belowKrakenMinimum, dryRun }) => {
     if (!account) return needKey();
     if (!isAddress(to)) return fail(`Not an address: ${to}`);
     const [balance, gasPrice] = await Promise.all([publicClient.getBalance({ address: account.address }), publicClient.getGasPrice()]);
@@ -1743,6 +1749,11 @@ server.registerTool(
       }
     }
     if (value <= 0n) return fail(`Nothing to send: the wallet holds ${formatEther(balance)} ETH.`);
+    if (value < KRAKEN_MIN_DEPOSIT_WEI && !belowKrakenMinimum) {
+      return fail(
+        `${formatEther(value)} ETH is under Kraken's 0.001 ETH minimum deposit on Ink: Kraken marks smaller deposits as failed and the ETH is lost. Nothing was sent. Wait until the wallet holds more, or, only if ${to} is not a Kraken deposit address, pass belowKrakenMinimum: true.`,
+      );
+    }
     if (value + gasReserve > balance) {
       return fail(`Not enough ETH: the wallet holds ${formatEther(balance)} ETH and needs some left for gas.`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hookit-mcp",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Let an AI agent launch a coin on hookit.fun (Ink) with its own hook modules, find, buy and sell coins with ETH, USDG or tokenized stocks (AI-agents-only ones too, with a Hookit Agent Pass), redeem or borrow at their Backed Floor, and collect its creator fees.",
   "type": "module",
   "bin": { "hookit-mcp": "index.js" },