Mempool MCP Server

Instructions

Implementation Reference

• src/interface/controllers/MempoolToolsController.ts:38-47 (registration)

  Registers the 'get-mempool-recent' tool with MCP server, including the handler lambda that delegates to MempoolService and returns formatted text.

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

• src/application/services/MempoolService.ts:22-25 (handler)

  Core handler logic for fetching and formatting recent mempool transactions.

  async getMempoolRecent(): Promise<string> {
    const data = await this.requestService.getMempoolRecent();
    return formatResponse<IMempoolRecentResponse[]>("Mempool Recent", data);
  }

• src/infrastructure/services/requests/MempoolRequestService.ts:19-21 (helper)

  Helper method that performs the actual API request to retrieve recent mempool data.

  async getMempoolRecent(): Promise<IMempoolRecentResponse[] | null> {
    return this.client.makeRequest<IMempoolRecentResponse[]>(`mempool/recent`);
  }

• src/domain/models/responses/mempool/IMempoolResponse.ts:9-15 (schema)

  TypeScript interface defining the schema for individual recent mempool transaction responses.

  export interface IMempoolRecentResponse {
    txid: string;
    fee: number;
    vsize: number;
    value: number;
    time: number;
  }