MCP Helius

Instructions

Implementation Reference

• src/handlers/helius.ts:207-225 (handler)

  The handler function getSignaturesForAddressHandler that validates the address and calls helius.connection.getSignaturesForAddress with optional parameters.

  export const getSignaturesForAddressHandler = async (input: GetSignaturesForAddressInput): Promise<ToolResultSchema> => {
    const addressResult = validatePublicKey(input.address);
    if (!(addressResult instanceof PublicKey)) {
      return addressResult;
    }
    
    try {
      const options: any = {};
      if (input.limit) options.limit = input.limit;
      if (input.before) options.before = input.before;
      if (input.until) options.until = input.until;
      if (input.commitment) options.commitment = input.commitment;
      
      const signatures = await (helius as any as Helius).connection.getSignaturesForAddress(addressResult, options);
      return createSuccessResponse(`Signatures: ${JSON.stringify(signatures, null, 2)}`);
    } catch (error) {
      return createErrorResponse(`Error getting signatures: ${error instanceof Error ? error.message : String(error)}`);
    }
  }

• src/handlers/helius.types.ts:106-112 (schema)

  TypeScript type definition for the input parameters of the handler.

  export type GetSignaturesForAddressInput = {
    address: string;
    limit?: number;
    before?: string;
    until?: string;
    commitment?: "confirmed" | "finalized" | "processed";
  }

• src/tools.ts:162-176 (registration)

  MCP tool registration including name, description, and input schema definition.

  {
    name: "helius_get_signatures_for_address",
    description: "Get transaction signatures for a Solana address",
    inputSchema: {
      type: "object",
      properties: {
        address: { type: "string" },
        limit: { type: "number" },
        before: { type: "string" },
        until: { type: "string" },
        commitment: { type: "string", enum: ["confirmed", "finalized", "processed"] }
      },
      required: ["address"]
    }
  },

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

  Mapping of tool name to its handler function in the handlers dictionary.

  "helius_get_signatures_for_address": getSignaturesForAddressHandler,