MCP Helius

Instructions

Implementation Reference

• src/handlers/helius.ts:519-541 (handler)

  The main handler function that executes the Jupiter swap using Helius RPC, validates inputs, calls rpc.executeJupiterSwap, and handles responses/errors.
  export const executeJupiterSwapHandler = async (input: ExecuteJupiterSwapInput): Promise<ToolResultSchema> => { try { // Validate the signer is a valid public key format const signerPublicKey = validatePublicKey(input.signer); if (!(signerPublicKey instanceof PublicKey)) { return signerPublicKey; } const params = { inputMint: input.inputMint, outputMint: input.outputMint, amount: input.amount, maxDynamicSlippageBps: input.maxDynamicSlippageBps }; // The actual implementation expects a Signer object, but our mock likely accepts a string // We'll use the string and let the type casting handle it const result = await (helius as any as Helius).rpc.executeJupiterSwap(params, input.signer as any); return createSuccessResponse(`Jupiter swap executed: ${JSON.stringify(result, null, 2)}`); } catch (error) { return createErrorResponse(`Error executing Jupiter swap: ${error instanceof Error ? error.message : String(error)}`); } }
• src/tools.ts:516-530 (schema)

  Input schema definition for the 'helius_execute_jupiter_swap' tool, defining parameters like inputMint, outputMint, amount, slippage, and signer.
  { name: 'helius_execute_jupiter_swap', description: 'Execute a token swap using Jupiter', inputSchema: { type: 'object', properties: { inputMint: { type: 'string', description: 'The mint address of the input token' }, outputMint: { type: 'string', description: 'The mint address of the output token' }, amount: { type: 'number', description: 'The amount of input tokens to swap' }, maxDynamicSlippageBps: { type: 'number', description: 'Maximum slippage in basis points (optional)' }, signer: { type: 'string', description: 'The signer public key' } }, required: ['inputMint', 'outputMint', 'amount', 'signer'] } }
• src/tools.ts:590-590 (registration)

  Registration of the tool name to its handler function in the handlers dictionary.
  "helius_execute_jupiter_swap": executeJupiterSwapHandler
• src/handlers/helius.types.ts:275-281 (schema)

  TypeScript type definition for the ExecuteJupiterSwapInput used in the handler function signature.
  export type ExecuteJupiterSwapInput = { inputMint: string; outputMint: string; amount: number; maxDynamicSlippageBps?: number; signer: string; }