Mempool MCP Server

Instructions

Implementation Reference

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

  Registers the MCP tool 'get-block-status'. Defines input schema requiring a 64-character block hash, description, and handler that delegates to BlocksService.getBlockStatus, returning 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-31 (helper)

  BlocksService.getBlockStatus: Fetches block status from request service and formats the IBlockStatusResponse using formatResponse.

  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-25 (helper)

  Core implementation in BlocksRequestService.getBlockStatus: Makes an API request to the endpoint `block/${hash}/status` using IApiClient.makeRequest.

  async getBlockStatus({ hash }: { hash: string }): Promise<IBlockStatusResponse | null> {
    return this.client.makeRequest<IBlockStatusResponse>(`block/${hash}/status`);