Mempool MCP Server

Instructions

Implementation Reference

• src/interface/controllers/BlocksToolsController.ts:61-73 (registration)

  Registers the MCP tool 'get-block-status' with the server, defines the input schema using Zod for the block hash parameter, and implements the tool handler as an async function that fetches the status via BlocksService and returns formatted text content.
  private registerGetBlockStatusHandler(): void { this.server.tool( "get-block-status", "Returns status for a block", { hash: z.string().length(64).describe("The block hash to get status for"), }, async ({ hash }) => { const text = await this.blocksService.getBlockStatus({ hash }); return { content: [{ type: "text", text }] }; } ); }
• src/application/services/BlocksService.ts:29-32 (handler)

  Application service handler for getBlockStatus that retrieves raw data from the request service and formats it using formatResponse helper.
  async getBlockStatus({ hash }: IHashParameter): Promise<string> { const data = await this.requestService.getBlockStatus({ hash }); return formatResponse<IBlockStatusResponse>("Block Status", data); }
• src/infrastructure/services/requests/BlocksRequestService.ts:24-26 (helper)

  Infrastructure helper that performs the actual API request to fetch block status for the given hash.
  async getBlockStatus({ hash }: { hash: string }): Promise<IBlockStatusResponse | null> { return this.client.makeRequest<IBlockStatusResponse>(`block/${hash}/status`); }