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; }; }