Marinade Finance MCP Server

Instructions

Implementation Reference

• src/tools.ts:480-597 (handler)

  The handler function that implements the core logic of the 'send_msol' tool: validates inputs, checks balances, handles associated token accounts, performs the SPL token transfer, and returns transaction details or errors.
  callback: async ({ recipientAddress, amount }: { recipientAddress: string; amount: number }) => { try { const amountLamports = MarinadeUtils.solToLamports(amount); const { wallet, connection } = createSolanaConfig() const config = new MarinadeConfig({ connection, publicKey: wallet.publicKey, }) const marinade = new Marinade(config) const marinadeState = await marinade.getMarinadeState(); const mSolMint = marinadeState.mSolMintAddress; let recipientPublicKey: PublicKey; try { recipientPublicKey = new PublicKey(recipientAddress); } catch (err) { return { content: [ { type: "text", text: JSON.stringify({ error: "Invalid recipient address", reason: "The provided recipient address is not a valid Solana public key" }, null, 2), }, ], }; } const senderTokenAccount = await getOrCreateAssociatedTokenAccount( connection, wallet, mSolMint, wallet.publicKey ); const senderBalance = Number(senderTokenAccount.amount); if (senderBalance < amountLamports) { return { content: [ { type: "text", text: JSON.stringify({ error: "Insufficient mSOL balance", reason: `Required: ${amount} mSOL (${amountLamports} lamports), Available: ${senderBalance / LAMPORTS_PER_SOL} mSOL (${senderBalance} lamports)` }, null, 2), }, ], }; } const recipientTokenAccount = await getOrCreateAssociatedTokenAccount( connection, wallet, mSolMint, recipientPublicKey, false ); const accountCreated = recipientTokenAccount.amount === BigInt(0) && senderTokenAccount.address.toString() !== recipientTokenAccount.address.toString(); const signature = await transfer( connection, wallet, senderTokenAccount.address, recipientTokenAccount.address, wallet.publicKey, amountLamports ); return { content: [ { type: "text", text: JSON.stringify({ success: true, signature, recipient: recipientAddress, recipientTokenAccount: recipientTokenAccount.address.toString(), accountCreated: accountCreated ? "A new token account was created for the recipient" : "Used existing token account", amountSent: amount, amountSentLamports: amountLamports.toString(), explorerUrl: `https://solscan.io/tx/${signature}${process.env.ENVIRONMENT === 'MAINNET' ? '' : '?cluster=devnet'}` }, null, 2), }, ], }; } catch (err) { const isAbort = (err as Error)?.name === "AbortError"; const isTimeout = (err as Error)?.message?.includes("timeout"); McpLogger.error("Error in send_msol tool:", String(err)); return { content: [ { type: "text", text: JSON.stringify( { error: isAbort || isTimeout ? "Request timed out" : "Failed to send mSOL", reason: String((err as Error)?.message ?? err), suggestion: isAbort || isTimeout ? "The transaction may still be processing. Check your wallet or try again with a different RPC endpoint." : "Please check the recipient address, your mSOL balance, and network connection." }, null, 2 ), }, ], }; } }
• src/tools.ts:476-479 (schema)

  Zod input schema for the 'send_msol' tool, defining parameters: recipientAddress (string) and amount (number >= 0).
  inputSchema: { recipientAddress: z.string().describe("The Solana wallet address of the recipient"), amount: z.number().min(0).describe("The amount of mSOL to send"), },
• src/server.ts:25-43 (registration)

  The registration code that loops over all tools (including 'send_msol') and registers them on the MCP server using server.registerTool, passing the tool's name, metadata/schema, and a wrapper around the tool's callback function.
  for (const t of marinadeFinanceTools) { server.registerTool( t.name, { title: t.title, description: t.description, inputSchema: t.inputSchema }, async (args) => { const result = await t.callback(args); return { content: result.content.map(item => ({ ...item, type: "text" as const })) }; } ); }