MCP Helius

Instructions

Implementation Reference

• src/handlers/helius.ts:47-62 (handler)

  The getBalanceHandler function implements the core logic for the 'helius_get_balance' tool. It validates the public key, fetches the balance using the Helius connection, and formats the response.

  export const getBalanceHandler = async (input: GetBalanceInput): Promise<ToolResultSchema> => {
    try {
      // Validate the public key is a valid format
      const publicKey = validatePublicKey(input.publicKey);
      if (!(publicKey instanceof PublicKey)) {
        return publicKey;
      }
  
      // Remove the test mode check since we want to use the mock implementation
      
      const balance = await (helius as any as Helius).connection.getBalance(publicKey, input.commitment);
      return createSuccessResponse(`Balance: ${balance} lamports (${balance / LAMPORTS_PER_SOL} SOL)`);
    } catch (error) {
      return createErrorResponse(`Error getting balance: ${error instanceof Error ? error.message : String(error)}`);
    }
  }

• src/tools.ts:33-44 (schema)

  The input schema definition for the 'helius_get_balance' tool, specifying the expected parameters: publicKey (required) and optional commitment level.

  {
    name: "helius_get_balance",
    description: "Get the balance of a Solana address",
    inputSchema: {
      type: "object",
      properties: {
        publicKey: { type: "string" },
        commitment: { type: "string", enum: ["confirmed", "finalized", "processed"] }
      },
      required: ["publicKey"]
    }
  },

• src/tools.ts:550-550 (registration)

  Registration of the 'helius_get_balance' tool, mapping the tool name to its handler function getBalanceHandler in the handlers dictionary.

  "helius_get_balance": getBalanceHandler,