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;
  }