Purpose
Aiwen IP Location MCP Server is an IP location API server launched by Aiwen Technology that is fully compatible with the MCP protocol. It is aimed at application scenarios that need to obtain geographic location and related network attribution information through IP addresses, such as quickly querying IP geographic locations, verifying IP sources in network security and access control, data analysis and scientific research related to IP geographic locations, and applications for obtaining IP Whois information.
Main Capabilities
This MCP Server provides the following tools:
- IP Location (aiwen_ip_location): Obtains location based on an IP address, supports three levels of precision: city, district, and street, and returns information such as latitude and longitude, affiliated organization, carrier, and accuracy. The parameter is ip (supports IPv4 and IPv6). The output includes continent, country, owner, isp, zipcode, timezone, accuracy, areacode, asnumber, lat, lng, prov, city, district, address. Location precision is configured through environment variables.
- Get Current Network IP Address and Location Information (user_network_ip): No parameters; obtains the current network IP address and location information, supports IPv4 and IPv6, and the output is the same as above.
- IP Usage Scene (ip_usage_scene): Obtains the usage scene based on an IP address. The output includes reserved IP, unallocated IP, organization, mobile network, home broadband, data center, enterprise dedicated line, CDN, satellite communication, exchange center, Anycast, and other scenes. The output field is scene. The parameter supports IPv4 and IPv6.
- IP Whois (ip_whois_info): Queries Whois registration information based on an IP address to obtain information such as the IP's network segment range, affiliated organization name, technical contact, and administrator. The parameter supports IPv4, and the output includes netname, status, owner, techinfo, admininfo, etc.
- AS Whois (ip_as_mapping): Queries AS number information for an IP address. The parameter supports IPv4, and the output includes asname, asn, allocated, type, industry, etc.
- IP HostInformation (ip_host_info): Queries attribution attributes of an IP based on its address, such as AS Number, AS name, carrier, and affiliated organization. The parameter supports IPv4, and the output includes asname, asnumber, isp, owner, etc.
- IP Risk Portrait (ip_risk_portrait): Obtains a risk portrait based on an IP address, identifies high-risk behaviors such as VPN, proxy, dial-up switching, data center, Tor node, port scanning, and brute force cracking, and outputs risk score, grading results, IP location, and other information. The parameter supports IPv4, and the output includes tag, level, score, and location scene information such as continent, country, prov, city, scene, etc.
- IP Real or Fake Person (ip_identity_check): Determines based on an IP address whether the visitor is a real user or machine traffic, and returns the real person probability (real_person_rate), dial-up switching probability (mb_rate), etc. The parameter supports IPv4, and the output includes real_person_rate, mb_rate, asnumber, isp.
- IPv4 Industry (ip_industry_classify): Queries the industry classification of an IP address. The parameter supports IPv4, and the output is industry.
The detailed return data of the interfaces can be found in the official API documentation.
Usage
Before use, environment variables need to be configured:
- AIWEN_API_KEY: The product's API KEY.
- IPV4_ACCURACY: The default value is city, used to configure IPv4 location precision. Choose a value according to the purchased API version. Available options are city (city level), district (district level), and street (street level).
- IPV6_ACCURACY: The default value is city, used to configure IPv6 location precision. Choose a value according to the purchased API version. Available options are city (city level), district (district level), and street (street level).
The IP location product is divided into three location precisions, configured through the above environment variables: the maximum city-level location precision returns to the city city; the maximum district-level location precision returns to the district district; the maximum street-level location precision returns to the street address.
Applicable ScenJing
Applications that need to quickly query the geographic location of an IP address; network security and access control, verifying IP origin; data analysis and scientific research related to IP geolocation; applications that obtain IP Whois information.
Limitations
Some tools (ip_whois_info, ip_as_mapping, ip_host_info, ip_risk_portrait, ip_identity_check, ip_industry_classify) support only IPv4 for their parameters; aiwen_ip_location and user_network_ip support both IPv4 and IPv6. Positioning accuracy depends on the purchased API version, and the corresponding accuracy must be selected via an environment variable. Other information not provided is not yet available.
