kinetic-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kinetic
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,97 @@
+# Solana Trading MCP Server
+
+An MCP (Model Context Protocol) server that connects to the Kinetic Solana trading platform, designed for Claude Desktop. It runs locally on your machine and lets you check balances and execute swaps through natural language conversation.
+
+## Quick Start
+
+Add this to your Claude Desktop config file (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS, `%APPDATA%\Claude\claude_desktop_config.json` on Windows):
+
+```json
+{
+  "mcpServers": {
+    "solana-trading": {
+      "command": "npx",
+      "args": ["-y", "kinetic-mcp"],
+      "env": {
+        "SOLANA_KEYPAIR_PATH": "/absolute/path/to/your/keypair.json"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop (fully quit and reopen). See the [getting started guide](docs/getting-started.md) for keypair setup and Phantom export instructions.
+
+## Usage
+
+- "What's my SOL balance?"
+- "Show me all my token holdings"
+- "Swap 0.01 SOL for USDC" — Claude shows a quote preview and asks for confirmation
+- "Swap 100 USDC for SOL with 1% slippage" — specify custom slippage
+
+Claude will ask for permission the first time it uses a tool. Click "Allow for This Chat" or "Allow Always".
+
+## Safety Guardrails
+
+- **Two-step confirmation** — swaps always show a quote preview first; you must confirm before execution
+- **Max trade size** — `MAX_TRADE_SOL` limits swap size in SOL-equivalent (default: 10 SOL)
+- **Slippage cap** — maximum 10% (1000 bps) enforced by input validation
+- **No private key exposure** — keypair is loaded from a local file only, never accepted as tool input
+
+## Available Tools
+
+| Tool                 | Description                            | Inputs                                                                   |
+| -------------------- | -------------------------------------- | ------------------------------------------------------------------------ |
+| `get_wallet_balance` | Get SOL balance and all token holdings | None                                                                     |
+| `swap_tokens`        | Swap one token for another             | `from_token`, `to_token`, `amount`, `slippage_bps` (optional), `confirm` |
+
+## Architecture
+
+- **Swap execution**: Kinetic API (quote → build transaction → send transaction)
+- **On-chain data**: Direct Solana RPC (balances, token accounts, mint info)
+- **Token resolution**: Well-known token table + on-chain mint lookup
+
+## Troubleshooting
+
+| Problem                           | Solution                                                                                                                        |
+| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| No hammer icon appears            | Check that the path in `claude_desktop_config.json` is correct and absolute. Run `npm run build`. Fully restart Claude Desktop. |
+| "Unable to connect to MCP server" | Check Claude Desktop logs for errors. Verify `npm run build` succeeds. Make sure `build/index.js` exists.                       |
+| Tools appear but return errors    | Check your env var values. Verify `SOLANA_KEYPAIR_PATH` points to a valid keypair file. Test network access.                    |
+| "Cannot find module" errors       | Run `npm install && npm run build`. Make sure you're using Node.js 20+.                                                         |
+| Import errors about ES modules    | Verify `"type": "module"` is in package.json. Rebuild with `npm run build`.                                                     |
+| Balance shows mint addresses      | Token not in well-known table. Use mint address for swaps with unknown tokens.                                                  |
+
+**Where to find Claude Desktop logs:**
+
+- **macOS**: `~/Library/Logs/Claude/`
+- **Windows**: `%APPDATA%\Claude\logs\`
+
+## Development
+
+```bash
+npm run dev          # Watch mode (recompile on change)
+npm run test         # Run tests
+npm run lint         # Run ESLint
+npm run format:check # Check Prettier formatting
+npm run typecheck    # Type-check without emitting
+npm run clean        # Remove build output
+```
+
+## Environment Variables
+
+| Variable                   | Required | Default                               | Description                          |
+| -------------------------- | -------- | ------------------------------------- | ------------------------------------ |
+| `SOLANA_KEYPAIR_PATH`      | Yes      | —                                     | Path to Solana keypair JSON file     |
+| `API_BASE_URL`             | No       | `https://api.kinetic.xyz`             | Kinetic API base URL                 |
+| `AUTH_BASE_URL`            | No       | `https://auth.kinetic.xyz`            | Kinetic auth base URL                |
+| `API_KEY`                  | No       | —                                     | Kinetic API key (higher rate limits) |
+| `SOLANA_RPC_URL`           | No       | `https://api.mainnet-beta.solana.com` | Solana RPC endpoint                  |
+| `MAX_TRADE_SOL`            | No       | `10`                                  | Max swap size in SOL-equivalent      |
+| `PRIORITY_FEE_LAMPORTS`    | No       | `400000`                              | Priority fee for transactions        |
+| `DYNAMIC_SLIPPAGE_MIN_BPS` | No       | `1`                                   | Minimum dynamic slippage (bps)       |
+| `DYNAMIC_SLIPPAGE_MAX_BPS` | No       | `300`                                 | Maximum dynamic slippage (bps)       |
+| `JITO_ENABLED`             | No       | `false`                               | Enable Jito MEV protection           |
+| `REQUEST_TIMEOUT_MS`       | No       | `30000`                               | API request timeout (ms)             |
+| `SEND_TX_TIMEOUT_MS`       | No       | `120000`                              | sendTransaction stream timeout (ms)  |
+| `LOG_LEVEL`                | No       | `info`                                | Log level (debug, info, warn, error) |

package/build/config.js

@@ -0,0 +1,48 @@
+import { z } from "zod";
+const httpsUrl = z
+    .string()
+    .url()
+    .refine((u) => u.startsWith("https://"), {
+    message: "URL must use HTTPS",
+});
+const configSchema = z.object({
+    solanaKeypairPath: z.string().min(1, "SOLANA_KEYPAIR_PATH is required"),
+    apiBaseUrl: httpsUrl.default("https://api.kinetic.xyz"),
+    authBaseUrl: httpsUrl.default("https://auth.kinetic.xyz"),
+    apiKey: z.string().optional(),
+    maxTradeSol: z.coerce.number().positive().default(10),
+    solanaRpcUrl: httpsUrl.default("https://api.mainnet-beta.solana.com"),
+    requestTimeoutMs: z.coerce.number().int().positive().default(30_000),
+    sendTxTimeoutMs: z.coerce.number().int().positive().default(120_000),
+    priorityFeeLamports: z.coerce.number().int().nonnegative().default(400_000),
+    dynamicSlippageMinBps: z.coerce.number().int().nonnegative().default(1),
+    dynamicSlippageMaxBps: z.coerce.number().int().positive().default(300),
+    jitoEnabled: z
+        .enum(["true", "false", "1", "0", ""])
+        .default("false")
+        .transform((v) => v === "true" || v === "1"),
+    logLevel: z.enum(["debug", "info", "warn", "error"]).default("info"),
+});
+export function loadConfig() {
+    const result = configSchema.safeParse({
+        solanaKeypairPath: process.env.SOLANA_KEYPAIR_PATH,
+        apiBaseUrl: process.env.API_BASE_URL || undefined,
+        authBaseUrl: process.env.AUTH_BASE_URL || undefined,
+        apiKey: process.env.API_KEY || undefined,
+        maxTradeSol: process.env.MAX_TRADE_SOL || undefined,
+        solanaRpcUrl: process.env.SOLANA_RPC_URL || undefined,
+        requestTimeoutMs: process.env.REQUEST_TIMEOUT_MS || undefined,
+        sendTxTimeoutMs: process.env.SEND_TX_TIMEOUT_MS || undefined,
+        priorityFeeLamports: process.env.PRIORITY_FEE_LAMPORTS || undefined,
+        dynamicSlippageMinBps: process.env.DYNAMIC_SLIPPAGE_MIN_BPS || undefined,
+        dynamicSlippageMaxBps: process.env.DYNAMIC_SLIPPAGE_MAX_BPS || undefined,
+        jitoEnabled: process.env.JITO_ENABLED || undefined,
+        logLevel: process.env.LOG_LEVEL || undefined,
+    });
+    if (!result.success) {
+        const errors = result.error.issues.map((i) => `  ${i.path.join(".")}: ${i.message}`);
+        throw new Error(`Invalid configuration:\n${errors.join("\n")}`);
+    }
+    return result.data;
+}
+//# sourceMappingURL=config.js.map

package/build/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/build/index.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+import { createRequire } from "node:module";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { loadConfig } from "./config.js";
+import { createLogger } from "./logger.js";
+import { initSolana, loadKeypair, getWalletAddress } from "./utils/solana.js";
+import { initApiClient } from "./utils/api-client.js";
+import { initTokenResolver } from "./utils/token-resolver.js";
+import { initSwap, swapTokens } from "./tools/swap.js";
+import { getWalletBalance } from "./tools/balance.js";
+const require = createRequire(import.meta.url);
+const { version } = require("../package.json");
+async function main() {
+    // Load and validate config
+    const config = loadConfig();
+    const logger = createLogger(config);
+    // Initialize modules with config + logger
+    initSolana(config, logger);
+    initApiClient(config, logger);
+    initTokenResolver(logger);
+    initSwap(config);
+    // Validate keypair at startup
+    try {
+        loadKeypair(config.solanaKeypairPath);
+    }
+    catch (err) {
+        logger.fatal({ err }, "Invalid keypair file");
+        process.exit(1);
+    }
+    // Log config
+    const walletAddress = getWalletAddress();
+    logger.info({
+        wallet: walletAddress,
+        apiBaseUrl: config.apiBaseUrl,
+        rpcUrl: config.solanaRpcUrl,
+        hasApiKey: !!config.apiKey,
+        maxTradeSol: config.maxTradeSol,
+        version,
+    }, "Solana Trading MCP Server starting");
+    const server = new McpServer({
+        name: "kinetic-mcp",
+        version,
+    });
+    // --- Tool: get_wallet_balance ---
+    server.tool("get_wallet_balance", "Get SOL balance and all token balances for the connected wallet", {}, async () => {
+        return getWalletBalance();
+    });
+    // --- Tool: swap_tokens ---
+    server.tool("swap_tokens", "Swap one Solana token for another. IMPORTANT: Always call first with confirm=false to preview the quote, then call again with confirm=true and identical parameters to execute. Never set confirm=true without previewing first.", {
+        from_token: z.string().describe("Token to sell — symbol (e.g. 'SOL') or mint address"),
+        to_token: z.string().describe("Token to buy — symbol (e.g. 'BONK') or mint address"),
+        amount: z
+            .number()
+            .positive()
+            .describe("Amount of from_token to swap, in human units (e.g. 1.5 for 1.5 SOL)"),
+        slippage_bps: z
+            .number()
+            .int()
+            .min(1)
+            .max(1000)
+            .optional()
+            .describe("Slippage tolerance in basis points. Default 200 (2%). Max 1000 (10%)."),
+        confirm: z
+            .boolean()
+            .default(false)
+            .describe("false = preview quote only (always do this first); true = execute the swap with same parameters"),
+    }, async (params) => {
+        return swapTokens(params);
+    });
+    logger.info({ tools: ["get_wallet_balance", "swap_tokens"] }, "Tools registered");
+    // Graceful shutdown
+    const shutdown = () => {
+        logger.info("Shutting down...");
+        server.close();
+        process.exit(0);
+    };
+    process.on("SIGTERM", shutdown);
+    process.on("SIGINT", shutdown);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info("Server started");
+}
+main().catch((err) => {
+    // Can't use logger here — config may not have loaded
+    console.error("FATAL:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/build/logger.js

@@ -0,0 +1,8 @@
+import pino from "pino";
+export function createLogger(config) {
+    return pino({
+        level: config.logLevel,
+        redact: ["apiKey", "*.apiKey", "keypairPath", "*.keypairPath"],
+    }, pino.destination(2));
+}
+//# sourceMappingURL=logger.js.map

package/build/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,MAAM,UAAU,YAAY,CAAC,MAAgC;IAC3D,OAAO,IAAI,CACT;QACE,KAAK,EAAE,MAAM,CAAC,QAAQ;QACtB,MAAM,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,CAAC;KAC/D,EACD,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CACpB,CAAC;AACJ,CAAC"}

package/build/tools/balance.js

@@ -0,0 +1,105 @@
+import { PublicKey } from "@solana/web3.js";
+import { TOKEN_PROGRAM_ID, TOKEN_2022_PROGRAM_ID } from "@solana/spl-token";
+import { getConnection, getWalletAddress } from "../utils/solana.js";
+import { resolveTokenByMint } from "../utils/token-resolver.js";
+import { formatError } from "../utils/errors.js";
+async function fetchTokenAccounts(publicKey, programId) {
+    const connection = getConnection();
+    const result = await connection.getParsedTokenAccountsByOwner(publicKey, {
+        programId,
+    });
+    const accounts = [];
+    for (const item of result.value) {
+        const info = item.account.data.parsed.info;
+        const uiAmount = info.tokenAmount.uiAmount;
+        if (uiAmount && uiAmount > 0) {
+            accounts.push({
+                mint: info.mint,
+                amount: uiAmount,
+                decimals: info.tokenAmount.decimals,
+            });
+        }
+    }
+    return accounts;
+}
+export async function getWalletBalance() {
+    try {
+        const address = getWalletAddress();
+        const publicKey = new PublicKey(address);
+        const connection = getConnection();
+        // Fetch SOL balance
+        const lamports = await connection.getBalance(publicKey);
+        const solBalance = lamports / 1e9;
+        // Fetch SPL token accounts (both programs in parallel)
+        const [splAccounts, token2022Accounts] = await Promise.all([
+            fetchTokenAccounts(publicKey, TOKEN_PROGRAM_ID),
+            fetchTokenAccounts(publicKey, TOKEN_2022_PROGRAM_ID),
+        ]);
+        const allAccounts = [...splAccounts, ...token2022Accounts];
+        // Resolve token info
+        const tokens = [];
+        let unverifiedCount = 0;
+        for (const account of allAccounts) {
+            const tokenInfo = resolveTokenByMint(account.mint);
+            if (tokenInfo) {
+                tokens.push({
+                    symbol: tokenInfo.symbol,
+                    mint: account.mint,
+                    amount: account.amount,
+                    decimals: account.decimals,
+                });
+            }
+            else {
+                tokens.push({
+                    symbol: account.mint.slice(0, 6) + "...",
+                    mint: account.mint,
+                    amount: account.amount,
+                    decimals: account.decimals,
+                });
+                unverifiedCount++;
+            }
+        }
+        // Sort by amount (highest first)
+        tokens.sort((a, b) => b.amount - a.amount);
+        // Format output
+        const lines = [];
+        lines.push(`SOL: ${solBalance.toFixed(4)}`);
+        if (tokens.length === 0 && solBalance === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Wallet: ${address}\n\nYour wallet has 0 SOL and no token holdings.`,
+                    },
+                ],
+            };
+        }
+        if (tokens.length > 0) {
+            lines.push("");
+            lines.push("Tokens:");
+            for (const token of tokens) {
+                const amountStr = token.amount >= 1
+                    ? token.amount.toLocaleString("en-US", {
+                        maximumFractionDigits: 4,
+                    })
+                    : token.amount.toPrecision(4);
+                lines.push(`  ${token.symbol}: ${amountStr}`);
+            }
+        }
+        if (unverifiedCount > 0) {
+            lines.push(`\n  ...and ${unverifiedCount} unverified token${unverifiedCount === 1 ? "" : "s"} with small balances`);
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Wallet: ${address}\n\n${lines.join("\n")}`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return formatError(error, "get_wallet_balance");
+    }
+}
+//# sourceMappingURL=balance.js.map

package/build/tools/balance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance.js","sourceRoot":"","sources":["../../src/tools/balance.ts"],"names":[],"mappings":"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"}

package/build/tools/swap.js

@@ -0,0 +1,154 @@
+import { VersionedTransaction } from "@solana/web3.js";
+import { resolveToken } from "../utils/token-resolver.js";
+import { loadKeypair, SOL_MINT } from "../utils/solana.js";
+import { toBaseUnits } from "../utils/math.js";
+import { getQuote, buildSwapTransaction, sendTransaction } from "../utils/api-client.js";
+import { formatError } from "../utils/errors.js";
+let cfg;
+export function initSwap(config) {
+    cfg = config;
+}
+async function checkTradeSize(amount, fromMint, fromSymbol, fromDecimals) {
+    if (fromMint === SOL_MINT) {
+        if (amount > cfg.maxTradeSol) {
+            return `Trade size (${amount} SOL) exceeds maximum of ${cfg.maxTradeSol} SOL.`;
+        }
+        return null;
+    }
+    // Use a Kinetic quote to convert token amount to SOL-equivalent
+    const baseUnits = Number(toBaseUnits(amount, fromDecimals));
+    try {
+        const quote = await getQuote({
+            inputToken: fromMint,
+            outputToken: SOL_MINT,
+            amount: baseUnits,
+        });
+        const solOutRaw = parseInt(quote.outAmount, 10);
+        if (Number.isNaN(solOutRaw)) {
+            return `Cannot verify trade size for ${fromSymbol}: invalid quote response. Trade blocked for safety.`;
+        }
+        const solEquiv = solOutRaw / 1e9; // SOL has 9 decimals
+        if (solEquiv > cfg.maxTradeSol) {
+            return `Trade size (${amount} ${fromSymbol} ≈ ${solEquiv.toFixed(2)} SOL) exceeds maximum of ${cfg.maxTradeSol} SOL.`;
+        }
+    }
+    catch (err) {
+        return `Cannot verify trade size for ${fromSymbol}: ${err instanceof Error ? err.message : "quote failed"}. Trade blocked for safety.`;
+    }
+    return null;
+}
+function formatStreamEvents(events) {
+    const lines = [];
+    for (const event of events) {
+        if ("error" in event) {
+            lines.push(`Error: ${event.error}`);
+        }
+        else if ("txHash" in event) {
+            lines.push(`Transaction: ${event.txHash}`);
+            lines.push(`Solscan: https://solscan.io/tx/${event.txHash}`);
+        }
+        else if ("walletTransactionInfo" in event) {
+            lines.push("Status: finalized");
+        }
+        else if ("status" in event) {
+            lines.push(`Status: ${event.status}`);
+        }
+    }
+    return lines.join("\n");
+}
+export async function swapTokens(params) {
+    try {
+        const { from_token, to_token, amount, confirm } = params;
+        const slippageBps = params.slippage_bps ?? 200;
+        // Resolve tokens
+        const fromToken = await resolveToken(from_token);
+        const toToken = await resolveToken(to_token);
+        // Safety check: trade size
+        const tradeSizeError = await checkTradeSize(amount, fromToken.mint, fromToken.symbol, fromToken.decimals);
+        if (tradeSizeError) {
+            return {
+                content: [{ type: "text", text: tradeSizeError }],
+                isError: true,
+            };
+        }
+        // Convert to base units (string-based to avoid floating-point precision loss)
+        const baseUnits = Number(toBaseUnits(amount, fromToken.decimals));
+        // Get quote from Kinetic
+        const quote = await getQuote({
+            inputToken: fromToken.mint,
+            outputToken: toToken.mint,
+            amount: baseUnits,
+            slippageBps,
+        });
+        // Calculate human-readable amounts
+        const outAmountRaw = parseInt(quote.outAmount, 10);
+        const minReceivedRaw = parseInt(quote.otherAmountThreshold, 10);
+        if (Number.isNaN(outAmountRaw) || Number.isNaN(minReceivedRaw)) {
+            throw new Error("Quote returned invalid amount values.");
+        }
+        const outAmount = outAmountRaw / Math.pow(10, toToken.decimals);
+        const minReceived = minReceivedRaw / Math.pow(10, toToken.decimals);
+        // Route description
+        const route = quote.routePlan.map((r) => r.swapInfo.label).join(" → ");
+        if (!confirm) {
+            const preview = [
+                "Swap Quote Preview",
+                "─".repeat(30),
+                `Input: ${amount} ${fromToken.symbol}`,
+                `Expected output: ${outAmount.toLocaleString("en-US", { maximumFractionDigits: 6 })} ${toToken.symbol}`,
+                `Minimum received (after slippage): ${minReceived.toLocaleString("en-US", { maximumFractionDigits: 6 })} ${toToken.symbol}`,
+                `Price impact: ${quote.priceImpactPct}%`,
+                `Route: ${route}`,
+                `Slippage tolerance: ${slippageBps} bps (${slippageBps / 100}%)`,
+                "",
+                "To execute this swap, call again with confirm=true and the same parameters.",
+            ].join("\n");
+            return { content: [{ type: "text", text: preview }] };
+        }
+        // Execute swap via Kinetic
+        const keypair = loadKeypair(cfg.solanaKeypairPath);
+        const walletAddress = keypair.publicKey.toBase58();
+        // Build swap transaction from the quote (pass user's slippage as dynamicSlippage.maxBps)
+        const { swapTransaction } = await buildSwapTransaction(walletAddress, quote, slippageBps);
+        // Deserialize and sign
+        const txBytes = Buffer.from(swapTransaction, "base64");
+        const transaction = VersionedTransaction.deserialize(txBytes);
+        transaction.sign([keypair]);
+        const signedBase64 = Buffer.from(transaction.serialize()).toString("base64");
+        // Send transaction via Kinetic
+        const events = await sendTransaction({
+            unsignedBase64: swapTransaction,
+            signedBase64,
+            walletAddress,
+            fromTokenAddress: fromToken.mint,
+            fromTokenAmount: baseUnits.toString(),
+            toTokenAddress: toToken.mint,
+        });
+        // Check for errors in stream
+        const errors = events.filter((e) => "error" in e);
+        if (errors.length > 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Swap failed:\n${errors.map((e) => e.error).join("\n")}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const result = [
+            "Swap Executed",
+            "─".repeat(30),
+            `Swapped: ${amount} ${fromToken.symbol} → ${outAmount.toLocaleString("en-US", { maximumFractionDigits: 6 })} ${toToken.symbol} (expected)`,
+            `Route: ${route}`,
+            "",
+            formatStreamEvents(events),
+        ].join("\n");
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (error) {
+        return formatError(error, "swap_tokens");
+    }
+}
+//# sourceMappingURL=swap.js.map

package/build/tools/swap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swap.js","sourceRoot":"","sources":["../../src/tools/swap.ts"],"names":[],"mappings":"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"}

package/build/types/api.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+export const quoteResponseSchema = z.object({
+    inputMint: z.string(),
+    inAmount: z.string(),
+    outputMint: z.string(),
+    outAmount: z.string(),
+    otherAmountThreshold: z.string(),
+    swapMode: z.string().optional(),
+    slippageBps: z.number().optional(),
+    priceImpactPct: z.union([z.string(), z.number()]),
+    routePlan: z.array(z.object({
+        swapInfo: z.object({
+            ammKey: z.string(),
+            label: z.string().optional(),
+            inputMint: z.string(),
+            outputMint: z.string(),
+            inAmount: z.string(),
+            outAmount: z.string(),
+            feeAmount: z.string().optional(),
+            feeMint: z.string().optional(),
+        }),
+        percent: z.number(),
+    })),
+    apiVersion: z.string().optional(),
+});
+//# sourceMappingURL=api.js.map

package/build/types/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACjD,SAAS,EAAE,CAAC,CAAC,KAAK,CAChB,CAAC,CAAC,MAAM,CAAC;QACP,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;YACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;YAClB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;YACrB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;YACtB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;YACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;YACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC/B,CAAC;QACF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;KACpB,CAAC,CACH;IACD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC"}