Yapay zeka asistanlarının coğrafi konum, ağ sahipliği ve gizlilik tespiti dahil olmak üzere IP istihbaratı sorguları yapmasını sağlayın.
Ayrıca bilinen adı ipinfo/mcp, mcp, ipinfo-mcp-server
- Yıldızlar
- 2
- Araçlar
- 6
- İndirmeler, 30 gün
- 1.367
- En son sürüm
- 0.3.2
- Son commit
- 13 Kas 2026
- Lisans
- Apache-2.0
IPinfo MCP nedir?
Yapay zeka asistanlarının coğrafi konum, ağ sahipliği ve gizlilik tespiti dahil olmak üzere IP istihbaratı sorguları yapmasını sağlayın. 6 araç sunar; örneğin ipinfo_lookup, ipinfo_check_privacy, ipinfo_check_residential_proxy.
Özet, projenin README dosyasından oluşturuldu
IPinfo MCP sunucusu hakkında
IPinfo MCP server, yapay zeka asistanlarına detaylı IP istihbaratı sorguları yapma yeteneği kazandırır. Kullanıcıların coğrafi konum verilerini, ağ sahipliğini ve VPN veya Tor kullanımı gibi gizlilik göstergelerini sorgulamasına olanak tanır. Bu sunucu, Claude Desktop gibi MCP uyumlu istemcileri kullanan geliştiriciler için tasarlanmıştır; stdio kullanarak PyPI üzerinden yerel bir sunucu olarak veya HTTP üzerinden uzak bir barındırılan sunucu olarak konuşlandırılabilir.
Kullanıcılar; Lite, Core, Plus ve Residential Proxy katmanları dahil olmak üzere IPinfo hesap planlarına bağlı olarak farklı veri seviyelerine erişebilirler. Sunucu; tam meta veriler için ipinfo_lookup, coğrafi ayrıntılar için ipinfo_geolocate ve anonim bağlantıları tespit etmek için ipinfo_check_privacy gibi özel araçlar içerir. Yerel kurulumlar için kimlik doğrulama IPINFO_TOKEN ortam değişkeni ile yönetilirken, barındırılan sürüm güvenli erişim için OAuth kullanır.
Neler yapabilirsiniz
- 1IP coğrafi konumunu tanımlamaAsistana belirli bir IP adresiyle ilişkili şehri, bölgeyi veya koordinatları bulmasını söyleyin.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
IPinfo MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleIPinfo MCP'yi Claude Code içine yükleyin
$ claude mcp add --env 'IPINFO_TOKEN=<YOUR_IPINFO_TOKEN>' mcp -- uvx ipinfo-mcp-serverIPinfo MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "uvx",
"args": [
"ipinfo-mcp-server"
],
"env": {
"IPINFO_TOKEN": "<YOUR_IPINFO_TOKEN>"
}
}
}
}IPinfo MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"ipinfo-mcp-server"
],
"env": {
"IPINFO_TOKEN": "<YOUR_IPINFO_TOKEN>"
}
}
}
}IPinfo MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"uvx","args":["ipinfo-mcp-server"],"env":{"IPINFO_TOKEN":"<YOUR_IPINFO_TOKEN>"}}'IPinfo MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "uvx",
"args": [
"ipinfo-mcp-server"
],
"env": {
"IPINFO_TOKEN": "<YOUR_IPINFO_TOKEN>"
}
}
}
}IPinfo MCP'yi Codex içine yükleyin
$ codex mcp add mcp --env 'IPINFO_TOKEN=<YOUR_IPINFO_TOKEN>' -- uvx ipinfo-mcp-serverIPinfo MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.mcp] command = "uvx" args = ["ipinfo-mcp-server"] [mcp_servers.mcp.env] IPINFO_TOKEN = "<YOUR_IPINFO_TOKEN>"
IPinfo MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user -e 'IPINFO_TOKEN=<YOUR_IPINFO_TOKEN>' mcp uvx -- ipinfo-mcp-serverIPinfo MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "uvx",
"args": [
"ipinfo-mcp-server"
],
"env": {
"IPINFO_TOKEN": "<YOUR_IPINFO_TOKEN>"
}
}
}
}HostedMCP tarafından 16 Kas 2026 tarihinde başlatıldı
Bu komutu ipinfo-mcp-server 0.3.2 için ağsız ve anahtarsız, yalıtılmış bir konteynerde çalıştırdık. Yanıt verdi ve 6 araç listeledi.
IPinfo MCP araçları 6
Sunucudan tools/list ile okunduipinfo_lookupSalt okunurLook 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_privacySalt okunurCheck 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_proxySalt okunurCheck 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_geolocateSalt okunurGet 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_asnSalt okunurGet 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_quotaSalt okunurCheck your IPinfo API usage and remaining quota. Returns daily and monthly request counts, the plan limit, and how many requests remain.
| 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. | Salt okunur |
| 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 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. | Salt okunur |
| 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 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. | Salt okunur |
| 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. | Salt okunur |
| 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. | Salt okunur |
| ipinfo_quota | Check your IPinfo API usage and remaining quota. Returns daily and monthly request counts, the plan limit, and how many requests remain. | Salt okunur |
Yapılandırma
IPINFO_TOKENGerekliGizliYour IPinfo API token. Get a free one at https://ipinfo.io/signup
IPINFO_TRANSPORT
| Ad | Açıklama | Sunucu |
|---|---|---|
| IPINFO_TOKEN | Your IPinfo API token. Get a free one at https://ipinfo.io/signup | GerekliGizli |
| IPINFO_TRANSPORT | — |
Otomatik kontroller
Çalıştırıldı 12 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirGeçti
- Açık kaynak lisansı (OSI)Geçti
- Son bir yıl içinde commit veya sürüm mevcutGeçti
- Paket adı popüler bir pakete yakın değilGeçti
- Uzak uç nokta HTTPS kullanıyorGeçti
- Yıkıcı araçlar etiketlenmişGeçti
- Modele yönelik gizli talimat yokGeçti
- Pakette veya bağımlılıklarında kritik uyarı yokGeçti
IPinfo MCP Server
The official IPinfo MCP Server lets AI assistants such as Claude answer questions about IP addresses. Ask where an IP is located, which company or network it belongs to, or whether it's a VPN, proxy, Tor exit node, or residential proxy, and the assistant looks it up with IPinfo data.
It implements the Model Context Protocol (MCP), the open standard AI assistants use to connect to external tools, so it works with any MCP-compatible client. It supports the IPinfo Lite, Core, Plus, and Residential Proxy plans.
For the full guide, see the official documentation.
Installation
You need an IPinfo account. Sign up for free at ipinfo.io/signup.
Hosted server
Point your MCP client at https://mcp.ipinfo.io/ (Streamable HTTP). The first time it connects, it asks you to sign in with your IPinfo account through OAuth.
Local server (PyPI)
The server is published on PyPI as ipinfo-mcp-server and runs over stdio, authenticating with your API token. With uv installed, add it to your MCP client configuration:
{
"mcpServers": {
"ipinfo": {
"command": "uvx",
"args": ["ipinfo-mcp-server"],
"env": {
"IPINFO_TOKEN": "<your-ipinfo-token>"
}
}
}
}
Claude Desktop extension
Download mcp.mcpb from the latest GitHub release and open it with Claude Desktop. You'll be asked for your API token during installation.
MCP Registry
The server is listed in the MCP Registry as io.github.ipinfo/mcp.
The server is also listed on LightNow.
Tools
| Tool | Description | Plan requirement |
|---|---|---|
ipinfo_lookup |
Full IP data: geolocation, network, and metadata | Any; detailed: true needs Core/Plus |
ipinfo_geolocate |
Geographic location | Any; detailed: true needs Core/Plus |
ipinfo_asn |
Autonomous system (network ownership) | Any; detailed: true needs Core/Plus |
ipinfo_check_privacy |
VPN, proxy, relay, Tor, hosting, anycast, mobile, satellite flags | Paid plan |
ipinfo_check_residential_proxy |
Residential proxy detection | Residential Proxy access |
ipinfo_quota |
API usage and remaining quota | Any |
ipinfo_lite_lookup |
Lite IP data, for agents without an account | None; only offered to AAuth agents |
Tools that lack access for the token's plan return an ACCESS_DENIED error.
Common parameters
All tools except ipinfo_quota take a list of IPs and are paginated:
| Parameter | Type | Default | Description |
|---|---|---|---|
ips |
string[] |
required | Public IPv4 or IPv6 addresses. Private, loopback, reserved, multicast, and bogon addresses are rejected and reported in validation_errors. |
page |
integer |
1 |
1-based page of the result set. Values below 1 are clamped to 1. |
page_size |
integer |
25 |
IPs resolved per page, up to 1000. Only IPs on the requested page are fetched, so smaller pages consume less quota per call. |
ipinfo_lookup, ipinfo_geolocate, and ipinfo_asn also take:
| Parameter | Type | Default | Description |
|---|---|---|---|
detailed |
boolean |
false |
false queries the Lite endpoint. true queries the full lookup endpoint, which returns more fields. |
Common output
IP-based tools return:
| Field | Description |
|---|---|
results |
Object keyed by IP with the tool-specific data below. |
errors |
Object keyed by IP for IPs the API returned an error for. These IPs are left out of results. |
validation_errors |
Object keyed by input for values that aren't valid public IPs. Only present when there are any. |
_pagination |
total_results, page, page_size, total_pages, has_next, has_previous. |
_meta |
api_calls_made and from_cache. Results are cached in memory, so repeat lookups don't consume API quota. |
If the whole request fails (for example a missing or invalid token), the tool returns an error object instead, with code (ACCESS_DENIED, RATE_LIMITED, INVALID_TOKEN, NO_TOKEN, API_ERROR, or UNKNOWN), message, and suggestion.
ipinfo_lookup
Returns the raw IPinfo API response for each IP.
detailed: false(Lite):ip,asn,as_name,as_domain,country,country_code,continent,continent_code.detailed: true(full lookup):ip,hostname,geo(city, region, country, continent, coordinates, timezone, postal code),as(ASN, name, domain, type),anonymous(proxy, relay, Tor, VPN),mobile, and theis_anonymous,is_anycast,is_hosting,is_mobile,is_satelliteflags. Some fields are only available on Plus.
ipinfo_geolocate
Returns, per IP: ip, country, country_code, continent, continent_code. With detailed: true, also city, region, region_code, latitude, longitude, timezone, postal_code.
ipinfo_asn
Returns, per IP: ip, asn, name, domain. With detailed: true, also type (isp, hosting, business, education) and last_changed.
ipinfo_check_privacy
Returns, per IP: ip, is_anonymous, anonymous (is_proxy, is_relay, is_tor, is_vpn), is_anycast, is_hosting, is_mobile, is_satellite.
ipinfo_check_residential_proxy
Returns, per IP: ip and is_residential_proxy. For residential proxies, also service (proxy service name), last_seen (date), and percent_days_seen.
ipinfo_quota
Takes no parameters. Returns token (omitted when connected with OAuth), requests (day, month, limit, remaining), and per-feature quotas under features.
ipinfo_lite_lookup
Only offered to agents that sign their requests with AAuth, who get it in place of the tools above. Takes the common parameters and returns the Lite data for each IP: ip, asn, as_name, as_domain, country, country_code, continent, continent_code. When the daily limit for lookups without an account is reached, it returns a RATE_LIMITED error.
Configuration
The server is configured through environment variables:
| Variable | Default | Description |
|---|---|---|
IPINFO_TOKEN |
API token (stdio transport; over HTTP the token comes from the request) | |
IPINFO_API_BASE_URL |
https://api.ipinfo.io |
Base URL for api.ipinfo.io endpoints |
IPINFO_LEGACY_BASE_URL |
https://ipinfo.io |
Base URL for legacy ipinfo.io endpoints (e.g. /me) |
IPINFO_CACHE_TTL |
3600 |
Seconds a cached IP result stays fresh |
IPINFO_TRANSPORT |
stdio |
Transport type (stdio or http) |
HOST |
0.0.0.0 |
HTTP host (only for http transport) |
PORT |
8000 |
HTTP port (only for http transport) |
IPINFO_OAUTH_ISSUER |
OAuth issuer whose access tokens are accepted; OAuth is off when unset | |
IPINFO_MCP_RESOURCE_URL |
Public URL of this server, required with IPINFO_OAUTH_ISSUER |
|
IPINFO_OAUTH_JWKS_URI |
<issuer>/.well-known/jwks.json |
Where the issuer publishes its signing keys |
IPINFO_OPENAI_APPS_CHALLENGE |
Token served at /.well-known/openai-apps-challenge for OpenAI's domain verification |
|
IPINFO_AAUTH_PROVIDER_KEY |
Ed25519 private key, PEM encoded, for AAuth; AAuth is off when unset | |
IPINFO_AAUTH_ISSUER |
Public URL of this server for AAuth, required with the key |
With the http transport, each request authenticates with its own Authorization: Bearer <token> header.
Setting IPINFO_OAUTH_ISSUER turns on OAuth for the http transport. The server then advertises the issuer at /.well-known/oauth-protected-resource, answers requests without a valid credential with 401 Unauthorized, and verifies access tokens against the issuer's signing keys. A verified access token is sent to the IPinfo API in place of an API token. API tokens keep working as before.
Setting IPINFO_AAUTH_PROVIDER_KEY turns on AAuth for the http transport, so agents that sign their requests with AAuth can use ipinfo_lite_lookup without an IPinfo account. Generate the key with openssl genpkey -algorithm ed25519, and give every replica the same one. IPINFO_AAUTH_ISSUER must be the server's public URL: https, no port, path, or trailing slash. With AAuth on, the server also serves:
/aauth, the MCP endpoint for AAuth agents, whose only tool isipinfo_lite_lookup. Listing its tools needs no signature; calling one needs an AAuth signature. WhenIPINFO_MCP_RESOURCE_URLis set, only signatures made for that host are accepted./.well-known/aauth-resource.json, which points agents at/aauth. It names the origin ofIPINFO_MCP_RESOURCE_URL, or ofIPINFO_AAUTH_ISSUERwhen that is unset./.well-known/aauth-agent.jsonand/.well-known/aauth-jwks.json, the documents of the server's own AAuth agent,aauth:ipinfo-mcp@<issuer host>.
The main endpoint is unaffected.
Feedback
- Bugs and feature requests: open an issue on GitHub Issues.
- Security vulnerabilities: don't open a public issue; follow the security policy.
- Questions about your IPinfo account or plan: contact support@ipinfo.io.
Contributing
Contributions are welcome. See CONTRIBUTING.md for the workflow and the requirements a change has to meet.
Development
Prerequisites
- Python 3.14+
- uv
Setup
uv sync --dev
cp .env.example .env
# Add your IPinfo token to .env
Running the server
The server supports two transports: stdio (default) and HTTP.
# stdio (default, used by MCP clients)
uv run ipinfo-mcp-server
# HTTP
IPINFO_TRANSPORT=http HOST=0.0.0.0 PORT=8000 uv run ipinfo-mcp-server
Tests
# All tests
uv run pytest
# Integration tests (requires IPINFO_TOKEN)
uv run pytest tests/integration/
Integration tests hit the real IPinfo API and validate response structure only (no exact value assertions). They require IPINFO_TOKEN to be set and are skipped otherwise.
Type checking
uv run pyright
Linting
uv run ruff check .
uv run ruff format .
IPinfo MCP soruları
IPinfo MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env 'IPINFO_TOKEN=<YOUR_IPINFO_TOKEN>' mcp -- uvx ipinfo-mcp-server komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
IPinfo MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
IPinfo MCP hangi araçları sunar?
6 araç sunar; bunlar arasında ipinfo_lookup, ipinfo_check_privacy, ipinfo_check_residential_proxy, ipinfo_geolocate, ipinfo_asn yer alır.
Bir IP adresi hakkında ne tür bilgiler alabilirim?
Coğrafi konum, ağ sahipliği (ASN) ve bir IP'nin VPN, proxy, Tor çıkış düğümü veya konut proxy'si olup olmadığı gibi meta verileri bulabilirsiniz.
Sunucu OAuth destekliyor mu?
Evet, barındırılan HTTP sunucusu kullanıldığında, ilk bağlantıda IPinfo hesabınızla OAuth üzerinden giriş yapmanız istenir.
Bir IP'nin konut proxy'si olup olmadığını kontrol edebilir miyim?
Evet, konut proxy'si tespiti için ipinfo_check_residential_proxy adlı özel bir araç bulunmaktadır.