helius_get_signatures_for_address
Retrieve transaction signatures for a Solana address using the MCP Helius server. Specify parameters like time range, limit, and commitment level to filter results.
Instructions
Get transaction signatures for a Solana address
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes | ||
| before | No | ||
| commitment | No | ||
| limit | No | ||
| until | No |
Input Schema (JSON Schema)
{
"properties": {
"address": {
"type": "string"
},
"before": {
"type": "string"
},
"commitment": {
"enum": [
"confirmed",
"finalized",
"processed"
],
"type": "string"
},
"limit": {
"type": "number"
},
"until": {
"type": "string"
}
},
"required": [
"address"
],
"type": "object"
}
Implementation Reference
- src/handlers/helius.ts:207-225 (handler)The main handler function implementing the tool logic: validates the address, constructs options, calls Helius SDK's connection.getSignaturesForAddress, formats response.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/tools.ts:162-176 (schema)The tool registration in the tools array, defining name, description, and input schema for MCP validation.{ 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)Registration of the tool name to its handler function in the handlers dictionary."helius_get_signatures_for_address": getSignaturesForAddressHandler,
- src/handlers/helius.types.ts:106-112 (schema)TypeScript type definition for the input parameters used by the handler.export type GetSignaturesForAddressInput = { address: string; limit?: number; before?: string; until?: string; commitment?: "confirmed" | "finalized" | "processed"; }