Mempool MCP Server

Instructions

Implementation Reference

• src/interface/controllers/StatsToolsController.ts:14-23 (registration)

  Registers the MCP tool 'get-stats-info'. The provided handler fetches formatted stats info from StatsService and returns it as structured text content.
  private registerGetStatsHandler(): void { this.server.tool( "get-stats-info", "Returns stats info", async () => { const text = await this.statsService.getStatsInfo(); return { content: [{ type: "text", text }] }; } ); }
• src/domain/models/responses/stats/IStatsResponse.ts:1-11 (schema)

  TypeScript interface defining the structure of the stats response data from the API.
  export interface IStatsResponse { average_fee: number; average_tx_size: number; block_count: number; mempool_size: number; mempool_txs: number; total_fees: number; total_output: number; total_size: number; total_weight: number; }
• src/application/services/StatsService.ts:8-11 (helper)

  Service method that retrieves raw stats data via StatsRequestService and formats it using formatResponse utility.
  async getStatsInfo(): Promise<string> { const data = await this.requestService.getStatsInfo(); return formatResponse<IStatsResponse>("Stats Info", data); }
• src/infrastructure/services/requests/StatsRequestService.ts:7-9 (helper)

  Core implementation that makes the HTTP request to the `/stats` API endpoint using IApiClient.
  async getStatsInfo(): Promise<IStatsResponse | null> { return this.client.makeRequest<IStatsResponse>(`stats`); }