MCPサーバー

IPinfo

io.github.ipinfo/mcp
地図・位置情報 セキュリティ 公開・接続可能 MCP 2025-11-25

このMCPでできること

Provides IP address geolocation, network ownership, privacy and proxy detection, and related usage information.

ipinfo_asn
Ipinfo Asn
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.
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'required': ['ips'], 'properties': {'ips': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Public IP addresses to query, IPv4 or IPv6, e.g. ["8.8.8.8", "2001:4860:4860::8888"]. Private, loopback, reserved, multicast, and bogon addresses are rejected: they are reported under validation_errors and left out of results.'}, 'page': {'type': 'integer', 'default': 1, 'description': 'Page of the result set to return, 1-based. Values below 1 are clamped to 1, and a page past the last one returns no results.'}, 'detailed': {'type': 'boolean', 'default': False, 'description': 'Which IPinfo endpoint to query. Leave false to use the Lite endpoint, which returns the ASN, name, and domain. Set to true to use the full lookup endpoint, which also returns the network type (isp, hosting, business, education) and when the AS record last changed; it requires a token whose plan includes that data, otherwise the call fails with ACCESS_DENIED.'}, 'page_size': {'type': 'integer', 'default': 25, 'description': 'How many IPs to resolve and return per page. Clamped to a maximum of 1000, the API batch limit. Only the IPs on the requested page are fetched, so a smaller page size consumes less quota per call.'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'required': ['result'], 'properties': {'result': {'anyOf': [{'type': 'object', 'required': ['_pagination', '_meta', 'results'], 'properties': {'_meta': {'type': 'object', 'required': ['api_calls_made', 'from_cache'], 'properties': {'from_cache': {'type': 'integer'}, 'api_calls_made': {'type': 'integer'}}}, 'errors': {'type': 'object', 'additionalProperties': {'type': 'object', 'properties': {'code': {'enum': ['ACCESS_DENIED', 'RATE_LIMITED', 'INVALID_TOKEN', 'NO_TOKEN', 'API_ERROR', 'UNKNOWN'], 'type': 'string'}, 'message': {'type': 'string'}, 'suggestion': {'type': 'string'}}}}, 'results': {'type': 'object', 'additionalProperties': {'type': 'object', 'required': ['ip', 'asn', 'name', 'domain'], 'properties': {'ip': {'type': 'string'}, 'asn': {'type': 'string'}, 'name': {'type': 'string'}, 'type': {'type': 'string'}, 'domain': {'type': 'string'}, 'last_changed': {'type': 'string'}}}}, '_pagination': {'type': 'object', 'required': ['total_results', 'page', 'page_size', 'total_pages', 'has_next', 'has_previous'], 'properties': {'page': {'type': 'integer'}, 'has_next': {'type': 'boolean'}, 'page_size': {'type': 'integer'}, 'total_pages': {'type': 'integer'}, 'has_previous': {'type': 'boolean'}, 'total_results': {'type': 'integer'}}}, 'validation_errors': {'type': 'object', 'additionalProperties': {'type': 'string'}}}}, {'type': 'object', 'properties': {'code': {'enum': ['ACCESS_DENIED', 'RATE_LIMITED', 'INVALID_TOKEN', 'NO_TOKEN', 'API_ERROR', 'UNKNOWN'], 'type': 'string'}, 'message': {'type': 'string'}, 'suggestion': {'type': 'string'}}}]}}, 'x-fastmcp-wrap-result': True}
ipinfo_check_privacy
Ipinfo Check Privacy
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 a paid API token. 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.
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'required': ['ips'], 'properties': {'ips': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Public IP addresses to query, IPv4 or IPv6, e.g. ["8.8.8.8", "2001:4860:4860::8888"]. Private, loopback, reserved, multicast, and bogon addresses are rejected: they are reported under validation_errors and left out of results.'}, 'page': {'type': 'integer', 'default': 1, 'description': 'Page of the result set to return, 1-based. Values below 1 are clamped to 1, and a page past the last one returns no results.'}, 'page_size': {'type': 'integer', 'default': 25, 'description': 'How many IPs to resolve and return per page. Clamped to a maximum of 1000, the API batch limit. Only the IPs on the requested page are fetched, so a smaller page size consumes less quota per call.'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'required': ['result'], 'properties': {'result': {'anyOf': [{'type': 'object', 'required': ['_pagination', '_meta', 'results'], 'properties': {'_meta': {'type': 'object', 'required': ['api_calls_made', 'from_cache'], 'properties': {'from_cache': {'type': 'integer'}, 'api_calls_made': {'type': 'integer'}}}, 'errors': {'type': 'object', 'additionalProperties': {'type': 'object', 'properties': {'code': {'enum': ['ACCESS_DENIED', 'RATE_LIMITED', 'INVALID_TOKEN', 'NO_TOKEN', 'API_ERROR', 'UNKNOWN'], 'type': 'string'}, 'message': {'type': 'string'}, 'suggestion': {'type': 'string'}}}}, 'results': {'type': 'object', 'additionalProperties': {'type': 'object', 'required': ['ip', 'is_anonymous', 'anonymous', 'is_anycast', 'is_hosting', 'is_mobile', 'is_satellite'], 'properties': {'ip': {'type': 'string'}, 'anonymous': {'type': 'object', 'required': ['is_proxy', 'is_relay', 'is_tor', 'is_vpn'], 'properties': {'name': {'type': 'string'}, 'is_tor': {'type': 'boolean'}, 'is_vpn': {'type': 'boolean'}, 'is_proxy': {'type': 'boolean'}, 'is_relay': {'type': 'boolean'}}}, 'is_mobile': {'type': 'boolean'}, 'is_anycast': {'type': 'boolean'}, 'is_hosting': {'type': 'boolean'}, 'is_anonymous': {'type': 'boolean'}, 'is_satellite': {'type': 'boolean'}}}}, '_pagination': {'type': 'object', 'required': ['total_results', 'page', 'page_size', 'total_pages', 'has_next', 'has_previous'], 'properties': {'page': {'type': 'integer'}, 'has_next': {'type': 'boolean'}, 'page_size': {'type': 'integer'}, 'total_pages': {'type': 'integer'}, 'has_previous': {'type': 'boolean'}, 'total_results': {'type': 'integer'}}}, 'validation_errors': {'type': 'object', 'additionalProperties': {'type': 'string'}}}}, {'type': 'object', 'properties': {'code': {'enum': ['ACCESS_DENIED', 'RATE_LIMITED', 'INVALID_TOKEN', 'NO_TOKEN', 'API_ERROR', 'UNKNOWN'], 'type': 'string'}, 'message': {'type': 'string'}, 'suggestion': {'type': 'string'}}}]}}, 'x-fastmcp-wrap-result': True}
ipinfo_check_residential_proxy
Ipinfo Check Residential Proxy
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 a paid API token 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.
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'required': ['ips'], 'properties': {'ips': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Public IP addresses to query, IPv4 or IPv6, e.g. ["8.8.8.8", "2001:4860:4860::8888"]. Private, loopback, reserved, multicast, and bogon addresses are rejected: they are reported under validation_errors and left out of results.'}, 'page': {'type': 'integer', 'default': 1, 'description': 'Page of the result set to return, 1-based. Values below 1 are clamped to 1, and a page past the last one returns no results.'}, 'page_size': {'type': 'integer', 'default': 25, 'description': 'How many IPs to resolve and return per page. Clamped to a maximum of 1000, the API batch limit. Only the IPs on the requested page are fetched, so a smaller page size consumes less quota per call.'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'required': ['result'], 'properties': {'result': {'anyOf': [{'type': 'object', 'required': ['_pagination', '_meta', 'results'], 'properties': {'_meta': {'type': 'object', 'required': ['api_calls_made', 'from_cache'], 'properties': {'from_cache': {'type': 'integer'}, 'api_calls_made': {'type': 'integer'}}}, 'errors': {'type': 'object', 'additionalProperties': {'type': 'object', 'properties': {'code': {'enum': ['ACCESS_DENIED', 'RATE_LIMITED', 'INVALID_TOKEN', 'NO_TOKEN', 'API_ERROR', 'UNKNOWN'], 'type': 'string'}, 'message': {'type': 'string'}, 'suggestion': {'type': 'string'}}}}, 'results': {'type': 'object', 'additionalProperties': {'type': 'object', 'required': ['ip', 'is_residential_proxy'], 'properties': {'ip': {'type': 'string'}, 'service': {'type': 'string'}, 'last_seen': {'type': 'string'}, 'percent_days_seen': {'type': 'integer'}, 'is_residential_proxy': {'type': 'boolean'}}}}, '_pagination': {'type': 'object', 'required': ['total_results', 'page', 'page_size', 'total_pages', 'has_next', 'has_previous'], 'properties': {'page': {'type': 'integer'}, 'has_next': {'type': 'boolean'}, 'page_size': {'type': 'integer'}, 'total_pages': {'type': 'integer'}, 'has_previous': {'type': 'boolean'}, 'total_results': {'type': 'integer'}}}, 'validation_errors': {'type': 'object', 'additionalProperties': {'type': 'string'}}}}, {'type': 'object', 'properties': {'code': {'enum': ['ACCESS_DENIED', 'RATE_LIMITED', 'INVALID_TOKEN', 'NO_TOKEN', 'API_ERROR', 'UNKNOWN'], 'type': 'string'}, 'message': {'type': 'string'}, 'suggestion': {'type': 'string'}}}]}}, 'x-fastmcp-wrap-result': True}
ipinfo_geolocate
Ipinfo Geolocate
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.
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'required': ['ips'], 'properties': {'ips': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Public IP addresses to query, IPv4 or IPv6, e.g. ["8.8.8.8", "2001:4860:4860::8888"]. Private, loopback, reserved, multicast, and bogon addresses are rejected: they are reported under validation_errors and left out of results.'}, 'page': {'type': 'integer', 'default': 1, 'description': 'Page of the result set to return, 1-based. Values below 1 are clamped to 1, and a page past the last one returns no results.'}, 'detailed': {'type': 'boolean', 'default': False, 'description': 'Which IPinfo endpoint to query. Leave false to use the Lite endpoint, which returns country and continent only. Set to true to use the full lookup endpoint, which also returns city, region, latitude and longitude, timezone, and postal code; it requires a token whose plan includes that data, otherwise the call fails with ACCESS_DENIED.'}, 'page_size': {'type': 'integer', 'default': 25, 'description': 'How many IPs to resolve and return per page. Clamped to a maximum of 1000, the API batch limit. Only the IPs on the requested page are fetched, so a smaller page size consumes less quota per call.'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'required': ['result'], 'properties': {'result': {'anyOf': [{'type': 'object', 'required': ['_pagination', '_meta', 'results'], 'properties': {'_meta': {'type': 'object', 'required': ['api_calls_made', 'from_cache'], 'properties': {'from_cache': {'type': 'integer'}, 'api_calls_made': {'type': 'integer'}}}, 'errors': {'type': 'object', 'additionalProperties': {'type': 'object', 'properties': {'code': {'enum': ['ACCESS_DENIED', 'RATE_LIMITED', 'INVALID_TOKEN', 'NO_TOKEN', 'API_ERROR', 'UNKNOWN'], 'type': 'string'}, 'message': {'type': 'string'}, 'suggestion': {'type': 'string'}}}}, 'results': {'type': 'object', 'additionalProperties': {'type': 'object', 'required': ['ip', 'country', 'country_code', 'continent', 'continent_code'], 'properties': {'ip': {'type': 'string'}, 'city': {'type': 'string'}, 'region': {'type': 'string'}, 'country': {'type': 'string'}, 'latitude': {'type': 'number'}, 'timezone': {'type': 'string'}, 'continent': {'type': 'string'}, 'longitude': {'type': 'number'}, 'postal_code': {'type': 'string'}, 'region_code': {'type': 'string'}, 'country_code': {'type': 'string'}, 'continent_code': {'type': 'string'}}}}, '_pagination': {'type': 'object', 'required': ['total_results', 'page', 'page_size', 'total_pages', 'has_next', 'has_previous'], 'properties': {'page': {'type': 'integer'}, 'has_next': {'type': 'boolean'}, 'page_size': {'type': 'integer'}, 'total_pages': {'type': 'integer'}, 'has_previous': {'type': 'boolean'}, 'total_results': {'type': 'integer'}}}, 'validation_errors': {'type': 'object', 'additionalProperties': {'type': 'string'}}}}, {'type': 'object', 'properties': {'code': {'enum': ['ACCESS_DENIED', 'RATE_LIMITED', 'INVALID_TOKEN', 'NO_TOKEN', 'API_ERROR', 'UNKNOWN'], 'type': 'string'}, 'message': {'type': 'string'}, 'suggestion': {'type': 'string'}}}]}}, 'x-fastmcp-wrap-result': True}
ipinfo_lookup
Ipinfo Lookup
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.
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'required': ['ips'], 'properties': {'ips': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Public IP addresses to query, IPv4 or IPv6, e.g. ["8.8.8.8", "2001:4860:4860::8888"]. Private, loopback, reserved, multicast, and bogon addresses are rejected: they are reported under validation_errors and left out of results.'}, 'page': {'type': 'integer', 'default': 1, 'description': 'Page of the result set to return, 1-based. Values below 1 are clamped to 1, and a page past the last one returns no results.'}, 'detailed': {'type': 'boolean', 'default': False, 'description': 'Which IPinfo endpoint to query. Leave false to use the Lite endpoint, which returns country, continent, and basic ASN. Set to true to use the full lookup endpoint, which also returns city-level geolocation, privacy flags (VPN, proxy, Tor, hosting, anycast), and richer AS data; it requires a token whose plan includes that data, otherwise the call fails with ACCESS_DENIED.'}, 'page_size': {'type': 'integer', 'default': 25, 'description': 'How many IPs to resolve and return per page. Clamped to a maximum of 1000, the API batch limit. Only the IPs on the requested page are fetched, so a smaller page size consumes less quota per call.'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'required': ['result'], 'properties': {'result': {'anyOf': [{'type': 'object', 'required': ['_pagination', '_meta', 'results'], 'properties': {'_meta': {'type': 'object', 'required': ['api_calls_made', 'from_cache'], 'properties': {'from_cache': {'type': 'integer'}, 'api_calls_made': {'type': 'integer'}}}, 'errors': {'type': 'object', 'additionalProperties': {'type': 'object', 'properties': {'code': {'enum': ['ACCESS_DENIED', 'RATE_LIMITED', 'INVALID_TOKEN', 'NO_TOKEN', 'API_ERROR', 'UNKNOWN'], 'type': 'string'}, 'message': {'type': 'string'}, 'suggestion': {'type': 'string'}}}}, 'results': {'type': 'object', 'additionalProperties': {'anyOf': [{'type': 'object', 'required': ['ip', 'asn', 'as_name', 'as_domain', 'country_code', 'country', 'continent_code', 'continent'], 'properties': {'ip': {'type': 'string'}, 'asn': {'type': 'string'}, 'as_name': {'type': 'string'}, 'country': {'type': 'string'}, 'hostname': {'type': 'string'}, 'as_domain': {'type': 'string'}, 'continent': {'type': 'string'}, 'country_code': {'type': 'string'}, 'continent_code': {'type': 'string'}}}, {'type': 'object', 'required': ['ip', 'geo'], 'properties': {'as': {'type': 'object', 'required': ['asn', 'name', 'domain', 'type'], 'properties': {'asn': {'type': 'string'}, 'name': {'type': 'string'}, 'type': {'type': 'string'}, 'domain': {'type': 'string'}, 'last_changed': {'type': 'string'}}}, 'ip': {'type': 'string'}, 'geo': {'type': 'object', 'required': ['city', 'region', 'region_code', 'country', 'country_code', 'continent', 'continent_code', 'latitude', 'longitude', 'timezone', 'postal_code'], 'properties': {'city': {'type': 'string'}, 'radius': {'type': 'integer'}, 'region': {'type': 'string'}, 'country': {'type': 'string'}, 'dma_code': {'type': 'string'}, 'latitude': {'type': 'number'}, 'timezone': {'type': 'string'}, 'continent': {'type': 'string'}, 'longitude': {'type': 'number'}, 'geoname_id': {'type': 'integer'}, 'postal_code': {'type': 'string'}, 'region_code': {'type': 'string'}, 'country_code': {'type': 'string'}, 'last_changed': {'type': 'string'}, 'continent_code': {'type': 'string'}}}, 'mobile': {'type': 'object', 'required': ['name', 'mcc', 'mnc'], 'properties': {'mcc': {'type': 'string'}, 'mnc': {'type': 'string'}, 'name': {'type': 'string'}}}, 'hostname': {'type': 'string'}, 'anonymous': {'type': 'object', 'required': ['is_proxy', 'is_relay', 'is_tor', 'is_vpn'], 'properties': {'name': {'type': 'string'}, 'is_tor': {'type': 'boolean'}, 'is_vpn': {'type': 'boolean'}, 'is_proxy': {'type': 'boolean'}, 'is_relay': {'type': 'boolean'}}}, 'is_mobile': {'type': 'boolean'}, 'is_anycast': {'type': 'boolean'}, 'is_hosting': {'type': 'boolean'}, 'is_anonymous': {'type': 'boolean'}, 'is_satellite': {'type': 'boolean'}}}, {'type': 'object', 'required': ['ip', 'service', 'last_seen', 'percent_days_seen'], 'properties': {'ip': {'type': 'string'}, 'service': {'type': 'string'}, 'last_seen': {'type': 'string'}, 'percent_days_seen': {'type': 'integer'}}}, {'type': 'object', 'additionalProperties': True}]}}, '_pagination': {'type': 'object', 'required': ['total_results', 'page', 'page_size', 'total_pages', 'has_next', 'has_previous'], 'properties': {'page': {'type': 'integer'}, 'has_next': {'type': 'boolean'}, 'page_size': {'type': 'integer'}, 'total_pages': {'type': 'integer'}, 'has_previous': {'type': 'boolean'}, 'total_results': {'type': 'integer'}}}, 'validation_errors': {'type': 'object', 'additionalProperties': {'type': 'string'}}}}, {'type': 'object', 'properties': {'code': {'enum': ['ACCESS_DENIED', 'RATE_LIMITED', 'INVALID_TOKEN', 'NO_TOKEN', 'API_ERROR', 'UNKNOWN'], 'type': 'string'}, 'message': {'type': 'string'}, 'suggestion': {'type': 'string'}}}]}}, 'x-fastmcp-wrap-result': True}
ipinfo_quota
Ipinfo Quota
Check your IPinfo API usage and remaining quota. Returns daily and monthly request counts, the plan limit, and how many requests remain.
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'properties': {}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'required': ['result'], 'properties': {'result': {'anyOf': [{'type': 'object', 'required': ['token', 'requests'], 'properties': {'token': {'type': 'string'}, 'features': {'type': 'object', 'additionalProperties': {'type': 'object', 'required': ['daily', 'monthly'], 'properties': {'daily': {'type': 'integer'}, 'monthly': {'type': 'integer'}, 'result_limit': {'type': 'integer'}, 'vpn_provider': {'type': 'boolean'}, 'firmographics': {'type': 'boolean'}, 'org_additional': {'type': 'boolean'}}}}, 'requests': {'type': 'object', 'required': ['day', 'month', 'limit', 'remaining'], 'properties': {'day': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'month': {'type': 'integer'}, 'remaining': {'type': 'integer'}}}}}, {'type': 'object', 'properties': {'code': {'enum': ['ACCESS_DENIED', 'RATE_LIMITED', 'INVALID_TOKEN', 'NO_TOKEN', 'API_ERROR', 'UNKNOWN'], 'type': 'string'}, 'message': {'type': 'string'}, 'suggestion': {'type': 'string'}}}]}}, 'x-fastmcp-wrap-result': True}
変更
ipinfo_quota
2026年9月25日2:52
変更
ipinfo_asn
2026年9月25日2:52
変更
ipinfo_geolocate
2026年9月25日2:52
変更
ipinfo_check_residential_proxy
2026年9月25日2:52
変更
ipinfo_check_privacy
2026年9月25日2:52
変更
ipinfo_lookup
2026年9月25日2:52
追加
ipinfo_quota
2026年9月17日12:42
追加
ipinfo_asn
2026年9月17日12:42
追加
ipinfo_geolocate
2026年9月17日12:42
追加
ipinfo_check_residential_proxy
2026年9月17日12:42
追加
ipinfo_check_privacy
2026年9月17日12:42
追加
ipinfo_lookup
2026年9月17日12:42