Mempool MCP Server

Instructions

Implementation Reference

• src/interface/controllers/MempoolToolsController.ts:27-36 (registration)

  Registers the 'get-mempool-txids' MCP tool, which invokes MempoolService.getMempoolTxids() and returns the result as text content.
  private registerGetMempoolTxidsHandler(): void { this.server.tool( "get-mempool-txids", "Returns mempool txids", async () => { const text = await this.mempoolService.getMempoolTxids(); return { content: [{ type: "text", text }] }; } ); }
• src/infrastructure/services/requests/MempoolRequestService.ts:15-17 (handler)

  Executes the core tool logic by making an API request to the '/mempool/txids' endpoint via IApiClient.
  async getMempoolTxids(): Promise<IMempoolTxidResponse[] | null> { return this.client.makeRequest<IMempoolTxidResponse[]>(`mempool/txids`); }
• src/application/services/MempoolService.ts:17-20 (helper)

  Wrapper that fetches mempool txids from the request service and formats them into a string response using formatResponse.
  async getMempoolTxids(): Promise<string> { const data = await this.requestService.getMempoolTxids(); return formatResponse<IMempoolTxidResponse[]>("Mempool Txids", data); }
• src/domain/models/responses/mempool/IMempoolResponse.ts:1-15 (schema)

  Defines TypeScript interfaces and types for mempool API responses, including IMempoolTxidResponse as string for txids.
  export interface IMempoolInfoResponse { count: number; vsize: number; total_fee: number; } export type IMempoolTxidResponse = string; export interface IMempoolRecentResponse { txid: string; fee: number; vsize: number; value: number; time: number; }