whodis-mcp-server/dist/services/vendor.ip-api.com.service.d.ts

Whodis MCP Server for checking the availability of domain names using WHOIS lookups.

import { IPDetail, IPApiRequestOptions } from './vendor.ip-api.com.types.js';
/**
 * @namespace VendorIpApiService
 * @description Service layer for interacting directly with the ip-api.com vendor API.
 *              Responsible for constructing API requests based on provided parameters
 *              and handling the raw response from the `fetchIpApi` utility.
 */
/**
 * @function get
 * @description Fetches details for a specific IP address or the current device's IP from ip-api.com.
 *              It uses the `fetchIpApi` utility and handles the specific success/failure status returned by ip-api.com.
 * @memberof VendorIpApiService
 * @param {string} [ipAddress] - Optional IP address to look up. If omitted, fetches details for the current device's public IP.
 * @param {IPApiRequestOptions} [options={}] - Optional request options for the ip-api.com service, such as `useHttps`, `fields`, and `lang`.
 * @returns {Promise<IPDetail>} A promise that resolves to the detailed IP information if the API call is successful.
 * @throws {McpError} Throws an `McpError` (specifically `ApiError` or `UnexpectedError`) if:
 *  - The `fetchIpApi` call fails (network error, non-2xx response).
 *  - The ip-api.com response status is not 'success'.
 *  - An unexpected error occurs during processing.
 * @example
 * // Get basic details for 8.8.8.8
 * const details = await get('8.8.8.8');
 * // Get extended details using HTTPS
 * const extendedDetails = await get('1.1.1.1', { useHttps: true, fields: [...] });
 */
declare function get(ipAddress?: string, options?: IPApiRequestOptions): Promise<IPDetail>;
declare const _default: {
    get: typeof get;
};
export default _default;