mcp -ipinfo

This MCP server provides IP geolocation capabilities by delegating to the IPInfo API. It exposes tools to fetch detailed information about one or more IP addresses, determine whether an IP is associated with a residential proxy, and generate a map URL for visualizing IP locations. You can run the server using uvx and the provided command args, ensuring you supply an IPInfo API token for access to premium features. When querying IP details, you can pass a list of IPs to analyze; if omitted, the server will use the requester’s IP. The available tools are get_ip_details, get_residential_proxy_info, and get_map_url, each returning structured data such as location, ISP, timezone, residential proxy status, and a map URL for visualization.

Prerequisites:

• Python installed on your system
• Access to the Internet to fetch the uvx package
• An IPInfo API token (signup at ipinfo.io/signup) for premium features if needed

Install and run steps:

1. Install uvx (if not already installed) and ensure it is accessible in your PATH. You can install the server package from its source as described in the repository, or use the URL provided in the README.

2. Acquire an IPInfo API token and set it in the environment before running the server:

   • On Unix-like systems: export IPINFO_API_TOKEN="<YOUR TOKEN>"
   • On Windows (PowerShell): $Env:IPINFO_API_TOKEN = "<YOUR TOKEN>"

3. Run the MCP server using uvx with the specified command and arguments:

   uvx mcp-server-ipinfo

Optional: If you want to use the latest development version from GitHub, append the --from argument as shown:

uvx --from git+https://github.com/briandconnelly/mcp-server-ipinfo mcp-server-ipinfo

4. If you want to enable or override the cache TTL for IPInfo responses, set IPINFO_CACHE_TTL in seconds prior to starting the server, e.g. export IPINFO_CACHE_TTL=3600.

Tips and considerations:

• The IPInfo API requires a token for premium features like residential proxy checks and advanced location data. Ensure IPINFO_API_TOKEN is set in the environment where you run the server.
• The get_ip_details tool supports batch lookups; supply multiple IPs for concurrent analysis (limited by IPInfo plan).
• The get_map_url tool can generate a visualization URL for large sets of IPs (up to the documented limit).
• If you encounter authentication errors, double-check that the token is correct and has required scopes for the requested features.
• The IPINFO_CACHE_TTL env var helps reduce API calls by caching results; adjust as needed for your latency/budget requirements.