Mempool MCP Server

Instructions

Implementation Reference

• src/interface/controllers/AddressToolsController.ts:61-73 (registration)

  Registers the MCP tool 'get-address-txs-mempool' including input schema (address: string) and a thin handler that calls AddressService.getAddressTxsMempool and returns formatted text content.

  private registerGetAddressTxsMempoolHandler(): void {
    this.server.tool(
      "get-address-txs-mempool",
      "Returns mempool transactions for an address",
      {
        address: z.string().describe("The address to get mempool txs for"),
      },
      async ({ address }) => {
        const text = await this.addressService.getAddressTxsMempool({ address });
        return { content: [{ type: "text", text }] };
      }
    );
  }

• src/application/services/AddressService.ts:31-37 (handler)

  Executes the core logic for retrieving and formatting mempool transactions for the given address using the request service.

  async getAddressTxsMempool({ address }: IAddressParameter): Promise<string> {
    const data = await this.requestService.getAddressTxsMempool({ address });
    return formatResponse<IAddressTxResponse[]>(
      "Address Mempool Transactions",
      data
    );
  }

• src/infrastructure/services/requests/AddressRequestService.ts:23-25 (helper)

  Performs the actual API request to fetch mempool transactions from the backend endpoint `/address/{address}/txs/mempool`.

  async getAddressTxsMempool({ address }: { address: string }): Promise<IAddressTxResponse[] | null> {
    return this.client.makeRequest<IAddressTxResponse[]>(`address/${address}/txs/mempool`);
  }