IPLocate

Instructions

Implementation Reference

• src/index.ts:290-323 (handler)

  Handler function that validates the input IP address, fetches complete IP data from the API, extracts the company information, and returns it as formatted JSON or an error response.
  async ({ ip }) => { if (ip && !isValidIP(ip)) { return { content: [{ type: "text", text: `Error: "${ip}" is not a valid IPv4 or IPv6 address.` }], isError: true }; } try { const data = await fetchIPData(ip); const companyData = { ip: data.ip, company: data.company }; return { content: [{ type: "text", text: JSON.stringify(companyData, null, 2) }] }; } catch (error) { return { content: [{ type: "text", text: `Error: ${error instanceof Error ? error.message : String(error)}` }], isError: true }; } }
• src/index.ts:282-324 (registration)

  Registers the 'lookup_ip_address_company' MCP tool with the server, providing title, description, input schema, and the inline handler function.
  // Register tool: lookup_ip_address_company server.registerTool( "lookup_ip_address_company", { title: "Look up IP Address Company", description: "Get company/organization information for an IP address including the company name, domain, and type of organization. Can look up any IPv4 or IPv6 address, or your own IP if no address is provided.", inputSchema: IPAddressSchema }, async ({ ip }) => { if (ip && !isValidIP(ip)) { return { content: [{ type: "text", text: `Error: "${ip}" is not a valid IPv4 or IPv6 address.` }], isError: true }; } try { const data = await fetchIPData(ip); const companyData = { ip: data.ip, company: data.company }; return { content: [{ type: "text", text: JSON.stringify(companyData, null, 2) }] }; } catch (error) { return { content: [{ type: "text", text: `Error: ${error instanceof Error ? error.message : String(error)}` }], isError: true }; } } );
• src/index.ts:14-16 (schema)

  Zod-based input schema definition for the tool, defining optional 'ip' parameter.
  const IPAddressSchema = { ip: z.string().optional().describe("IPv4 or IPv6 address to look up. If not provided, returns information about the caller's IP address.") };
• src/index.ts:44-89 (helper)

  Core helper function that makes the HTTP request to iplocate.io API to fetch IP data, supports API key, handles errors, and returns typed IPLocateResponse.
  async function fetchIPData(ip?: string): Promise<IPLocateResponse> { const baseUrl = "https://iplocate.io/api/lookup"; const apiKey = process.env.IPLOCATE_API_KEY; let url = ip ? `${baseUrl}/${ip}` : `${baseUrl}/`; // Add API key if available if (apiKey) { url += `?apikey=${apiKey}`; } try { const response = await fetch(url, { headers: { 'User-Agent': `mcp-server-iplocate/${VERSION}` } }); if (!response.ok) { const errorText = await response.text(); let errorMessage = `API request failed with status ${response.status}`; try { const errorJson = JSON.parse(errorText); if (errorJson.error) { errorMessage = errorJson.error; } } catch { // If not JSON, use the raw text if (errorText) { errorMessage = errorText; } } throw new Error(errorMessage); } const data = await response.json() as IPLocateResponse; return data; } catch (error) { if (error instanceof Error) { throw error; } throw new Error(`Failed to fetch IP data: ${String(error)}`); } }
• src/models.ts:49-69 (schema)

  TypeScript interface defining the structure of the API response, including the 'company' field used by this tool.
  export interface IPLocateResponse { ip: string; country?: string | null; country_code?: string | null; is_eu?: boolean; city?: string | null; continent?: string | null; latitude?: number | null; longitude?: number | null; time_zone?: string | null; postal_code?: string | null; subdivision?: string | null; currency_code?: string | null; calling_code?: string | null; network?: string | null; asn?: ASNInfo | null; privacy?: PrivacyInfo; company?: CompanyInfo | null; hosting?: HostingInfo | null; abuse?: AbuseInfo | null; }