IPinfo MCP Server
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| IPINFO_HOST | No | HTTP host (only for http transport) | 0.0.0.0 |
| IPINFO_PORT | No | HTTP port (only for http transport) | 8000 |
| IPINFO_TOKEN | Yes | API token. Get a free token at https://ipinfo.io/signup | |
| IPINFO_CACHE_TTL | No | Seconds a cached IP result stays fresh | 3600 |
| IPINFO_TRANSPORT | No | Transport type ('stdio' or 'http') | stdio |
| IPINFO_API_BASE_URL | No | Base URL for api.ipinfo.io endpoints | https://api.ipinfo.io |
| IPINFO_LEGACY_BASE_URL | No | Base URL for legacy ipinfo.io endpoints (e.g. /me) | https://ipinfo.io |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": true
} |
| resources | {
"subscribe": false,
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ipinfo_lookupA | Look up geolocation, network, and metadata for one or more IP addresses. By default queries the IPinfo Lite endpoint, which returns country, continent, and ASN info. Set detailed=True to query the full lookup endpoint, which adds city-level geolocation, privacy flags (VPN, proxy, Tor, hosting, anycast), and richer AS data. Results are paginated. Use page and page_size to control which slice is returned. If the API reports an error for specific IPs, those IPs are listed in errors with the reason and left out of results. Results are cached in memory for the session, so repeat lookups of the same IP are served from cache without consuming API quota. You do not need to maintain your own cache or deduplicate IPs before calling this tool. The _meta field reports api_calls_made and from_cache counts. |
| ipinfo_check_privacyA | Check whether IP addresses are using privacy or anonymity services. Returns privacy flags for each IP: whether it is anonymous, using a VPN, proxy, relay, or Tor, and whether it is an anycast, hosting, mobile, or satellite address. Requires an IPinfo plan that includes privacy detection. Results are paginated. If the API reports an error for specific IPs, those IPs are listed in errors with the reason and left out of results. Do not treat a missing result as "no privacy services detected": check errors. Results are cached in memory for the session, so repeat checks of the same IP are served from cache without consuming API quota. You do not need to maintain your own cache or deduplicate IPs before calling this tool. The _meta field reports api_calls_made and from_cache counts. |
| ipinfo_check_residential_proxyA | Check whether IP addresses are known residential proxies. Returns whether each IP is a residential proxy and, if so, the proxy service name, the date it was last seen, and the percentage of days the IP was observed as a proxy. Requires an IPinfo plan with residential proxy access. Results are paginated. If the API reports an error for specific IPs, those IPs are listed in errors with the reason and left out of results. Do not treat a missing result as "not a residential proxy": check errors. Results are cached in memory for the session, so repeat checks of the same IP are served from cache without consuming API quota. You do not need to maintain your own cache or deduplicate IPs before calling this tool. The _meta field reports api_calls_made and from_cache counts. |
| ipinfo_geolocateA | Get geographic location data for one or more IP addresses. By default queries the IPinfo Lite endpoint, which returns country and continent. Set detailed=True to query the full lookup endpoint, which adds city, region, coordinates, timezone, and postal code. Results are paginated. If the API reports an error for specific IPs, those IPs are listed in errors with the reason and left out of results. Results are cached in memory for the session, so repeat lookups of the same IP are served from cache without consuming API quota. You do not need to maintain your own cache or deduplicate IPs before calling this tool. The _meta field reports api_calls_made and from_cache counts. |
| ipinfo_asnA | Get autonomous system (network ownership) information for IP addresses. By default queries the IPinfo Lite endpoint, which returns ASN, name, and domain. Set detailed=True to query the full lookup endpoint, which also includes the network type (e.g. isp, hosting, business, education). Results are paginated. If the API reports an error for specific IPs, those IPs are listed in errors with the reason and left out of results. Results are cached in memory for the session, so repeat lookups of the same IP are served from cache without consuming API quota. You do not need to maintain your own cache or deduplicate IPs before calling this tool. The _meta field reports api_calls_made and from_cache counts. |
| ipinfo_quotaA | Check your IPinfo API usage and remaining quota. Returns daily and monthly request counts, the plan limit, and how many requests remain. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
ipinfo_lookup is an umbrella tool that returns geolocation, ASN, and (in detailed mode) privacy flags, overlapping heavily with ipinfo_geolocate, ipinfo_asn, and ipinfo_check_privacy. An agent could reasonably reach for either the broad lookup or the focused tool for the same data, creating misselection risk, though the descriptions do clarify the specialized scopes.
All tools share an ipinfo_ prefix with snake_case, giving a predictable namespace. There's minor inconsistency in verb style (lookup, check_privacy, geolocate vs bare nouns asn, quota), but overall readable and coherent.
Six tools is a well-scoped, digestible set for an IP intelligence server. The count is reasonable, though the presence of both an umbrella lookup and three specialized subset tools means a couple could arguably be merged.
The surface covers core IP intelligence: general lookup, geolocation, ASN, privacy, residential proxy, and quota. It's fairly complete for the domain, with minor gaps like company/carrier ownership data that IPinfo offers, but core workflows are covered.