Mempool MCP Server

Instructions

Implementation Reference

• src/interface/controllers/BlockToolsController.ts:17-37 (registration)

  Registers the 'get-block' MCP tool, defining its schema (hash: string length 64), description, and handler function that delegates to BlockService.getBlock and returns formatted text content.
  private registerGetRecommendedFeesHandler(): void { this.server.tool( "get-block", "Returns details about a block from hash", { hash: z.string().length(64).describe("The hash info to get block"), }, async ({ hash }: IHashParameter) => { const text = await this.service.getBlock({ hash }); return { content: [ { type: "text", text: text, }, ], }; } ); }
• src/application/services/BlockService.ts:10-13 (handler)

  Handler in BlockService that fetches block data from BlockRequestService and formats the response using formatResponse.
  async getBlock({ hash }: IHashParameter): Promise<string> { const data = await this.requestService.getBlock({ hash }); return formatResponse<IBlockResponse>("Details about a block.", data); }
• src/infrastructure/services/requests/BlockRequestService.ts:9-11 (handler)

  Core handler in BlockRequestService that performs the API request to retrieve block details using the hash.
  async getBlock({ hash }: IHashParameter): Promise<IBlockResponse | null> { return this.client.makeRequest<IBlockResponse>(`block/${hash}`); }
• src/shared/parameters/IHashParameter.ts:1-3 (schema)

  TypeScript interface defining the input parameter structure for the get-block tool (hash: string). Note: Zod schema in controller adds length(64) validation.
  export interface IHashParameter { hash: string; }