Mempool MCP Server

Instructions

Implementation Reference

• src/interface/controllers/MempoolToolsController.ts:16-25 (registration)

  Registers the 'get-mempool-info' tool on the MCP server with a handler that calls MempoolService to get info and returns formatted text content.

  private registerGetMempoolHandler(): void {
    this.server.tool(
      "get-mempool-info",
      "Returns mempool info",
      async () => {
        const text = await this.mempoolService.getMempoolInfo();
        return { content: [{ type: "text", text }] };
      }
    );
  }

• src/interface/controllers/MempoolToolsController.ts:20-23 (handler)

  Inline handler function for the 'get-mempool-info' tool that delegates to service and structures MCP response.

  async () => {
    const text = await this.mempoolService.getMempoolInfo();
    return { content: [{ type: "text", text }] };
  }

• src/domain/models/responses/mempool/IMempoolResponse.ts:1-5 (schema)

  TypeScript interface defining the structure of mempool info response data used by the tool.

  export interface IMempoolInfoResponse {
    count: number;
    vsize: number;
    total_fee: number;
  }

• src/application/services/MempoolService.ts:12-15 (helper)

  Application service method that fetches raw mempool info and formats it for the tool response.

  async getMempoolInfo(): Promise<string> {
    const data = await this.requestService.getMempoolInfo();
    return formatResponse<IMempoolInfoResponse>("Mempool Info", data);
  }

• src/infrastructure/services/requests/MempoolRequestService.ts:11-13 (helper)

  Infrastructure service method performing the HTTP request to the mempool API endpoint.

  async getMempoolInfo(): Promise<IMempoolInfoResponse | null> {
    return this.client.makeRequest<IMempoolInfoResponse>(`mempool`);
  }