MCP Helius

Instructions

Implementation Reference

• src/handlers/helius.ts:254-270 (handler)

  Main handler function implementing the tool logic: validates addresses, calls Helius RPC getInflationReward, and formats response.

  export const getInflationRewardHandler = async (input: GetInflationRewardInput): Promise<ToolResultSchema> => {
    try {
      const addresses = [];
      for (const addr of input.addresses) {
        const result = validatePublicKey(addr);
        if (!(result instanceof PublicKey)) {
          return result; // Return the error response if any address is invalid
        }
        addresses.push(result);
      }
      
      const rewards = await (helius as any as Helius).connection.getInflationReward(addresses, input.epoch, input.commitment);
      return createSuccessResponse(`Inflation rewards: ${JSON.stringify(rewards, null, 2)}`);
    } catch (error) {
      return createErrorResponse(`Error getting inflation rewards: ${error instanceof Error ? error.message : String(error)}`);
    }
  }

• src/tools.ts:204-219 (schema)

  MCP tool schema definition including input validation schema for the tool.

  {
    name: "helius_get_inflation_reward",
    description: "Get inflation rewards for a list of addresses",
    inputSchema: {
      type: "object",
      properties: {
        addresses: { 
          type: "array",
          items: { type: "string" }
        },
        epoch: { type: "number" },
        commitment: { type: "string", enum: ["confirmed", "finalized", "processed"] }
      },
      required: ["addresses"]
    }
  },

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

  Tool registration mapping the name to its handler function in the handlers dictionary.

  "helius_get_inflation_reward": getInflationRewardHandler,

• src/handlers/helius.types.ts:124-128 (schema)

  TypeScript interface defining the input shape for the handler, used for type safety.

  export type GetInflationRewardInput = {
    addresses: string[];
    epoch?: number;
    commitment?: "confirmed" | "finalized" | "processed";
  }

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

  Import of the handler function from handlers/helius.ts.

  getInflationRewardHandler,