Mempool MCP Server

Instructions

Implementation Reference

• src/interface/controllers/AddressToolsController.ts:75-87 (registration)

  Registers the 'get-address-utxo' MCP tool with server, including input schema and execution handler.

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

• src/infrastructure/services/requests/AddressRequestService.ts:27-29 (handler)

  Core handler implementation: performs the API request to retrieve UTXOs for the address.

  async getAddressUtxo({ address }: { address: string }): Promise<IAddressUtxoResponse[] | null> {
    return this.client.makeRequest<IAddressUtxoResponse[]>(`address/${address}/utxo`);
  }

• src/application/services/AddressService.ts:39-42 (helper)

  Helper service method that fetches UTXOs and formats the response.

  async getAddressUtxo({ address }: IAddressParameter): Promise<string> {
    const data = await this.requestService.getAddressUtxo({ address });
    return formatResponse<IAddressUtxoResponse[]>("Address UTXOs", data);
  }

• src/domain/models/responses/address/IAddressResponse.ts:31-41 (schema)

  Type definition for the UTXO response structure used in the tool.

  export interface IAddressUtxoResponse {
    txid: string;
    vout: number;
    value: number;
    status: {
      confirmed: boolean;
      block_height?: number;
      block_hash?: string;
      block_time?: number;
    };
  }