ipwho-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ipwho-mcp should I allow 185.220.101.1? run a risk check on it"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ipwho-mcp
Serveur MCP local pour IP Who. Il interroge https://api.ipwho.org et expose trois outils : un contrôle de risque, la fiche d’une adresse, et un lookup groupé.
Le serveur parle MCP en stdio. La même commande sert à Cursor, Claude Code, Claude Desktop, Codex et l’application ChatGPT Desktop. ChatGPT sur le web n’est pas pris en charge.
La clé API est lue dans IPWHO_API_KEY et envoyée dans le header Authorization: Bearer. Elle n’est jamais placée dans l’URL.
Prérequis
Node.js 20 ou plus récent
Une clé API IP Who. Le plan gratuit permet 2 000 requêtes par jour. Crée-la depuis la page d’authentification.
Related MCP server: MCP AbuseIPDB Server
Installation
npx -y ipwho-mcp installLa commande demande la clé si IPWHO_API_KEY n’est pas déjà définie, puis enregistre le serveur ipwho dans les configurations utilisateur qu’elle trouve :
Client | Fichier |
Cursor |
|
Claude Desktop |
|
Claude Code |
|
Codex et ChatGPT Desktop |
|
Un client absent est ignoré. L’installeur ne modifie pas un mcp.json de projet. --dry-run liste les fichiers sans les écrire et sans afficher la clé.
npx -y ipwho-mcp install --dry-run
npx -y ipwho-mcp install --client cursor,codexTant que le paquet n’est pas publié sur npm, construis-le et lance l’installeur local. Il enregistre alors le chemin absolu de ce build :
npm install
npm run build
IPWHO_API_KEY=sk.xxx node dist/index.js install--npx force la forme npx -y ipwho-mcp, à utiliser une fois le paquet publié.
Ensuite : redémarre Claude Desktop et ChatGPT Desktop, ouvre une nouvelle session Claude Code et Codex, puis recharge Cursor.
Le premier lancement via npx télécharge le paquet. Codex laisse 30 secondes à ce démarrage (startup_timeout_sec). Si Claude Code affiche un échec de connexion au premier essai, relance claude mcp list une fois le téléchargement fini.
Outils
check_ip prend une adresse. Il ne demande que les blocs security et connection.
Le verdict :
Tor et menace
high:blockVPN, Tor, menace
mediumouhigh, ou menace inconnue :challengesinon :
allowun type de connexion
Corporateajoute l’indicedatacenter_or_office. Il ne change pas le verdict.si le bloc
securityest absent :challenge
lookup_ip prend une adresse et, en option, fields, la liste des champs à conserver. Sans filtre, la fiche complète est renvoyée : géolocalisation, fuseau, drapeau, devise, connexion, sécurité.
lookup_ips prend de 1 à 50 adresses. Les doublons sont retirés. C’est un seul appel GET /bulk/…, donc une seule unité de quota. Si une adresse est invalide, aucune requête n’est envoyée.
Les trois outils sont en lecture seule. Une adresse est validée avant l’appel.
Ce que le signal ne dit pas
isThreat vaut low, medium ou high. L’API ne fournit ni famille de malware, ni catégorie d’abus, ni score détaillé. Un VPN légitime produit challenge, pas une preuve d’attaque. Le plan gratuit est limité à 2 000 requêtes par jour et à 100 requêtes par seconde. Un HTTP 401 ou 429 ne doit pas être relancé en boucle.
Configuration manuelle
Si tu préfères coller la configuration toi-même :
{
"mcpServers": {
"ipwho": {
"type": "stdio",
"command": "npx",
"args": ["-y", "ipwho-mcp"],
"env": {
"IPWHO_API_KEY": "sk.xxx"
}
}
}
}Pour Codex et ChatGPT Desktop, dans ~/.codex/config.toml :
[mcp_servers.ipwho]
command = "npx"
args = ["-y", "ipwho-mcp"]
env = { IPWHO_API_KEY = "sk.xxx" }
startup_timeout_sec = 30Développement
npm test
npm run buildLes tests ne contactent pas l’API. Pour lancer le serveur à la main :
IPWHO_API_KEY=sk.xxx node dist/index.jsSans argument, le process parle MCP sur stdin/stdout. Les journaux vont sur stderr.
Available Tools
3 toolscheck_ipContrôle de risque IPARead-onlyIdempotent
Dit si une adresse IPv4 ou IPv6 paraît risquée. Retourne un verdict allow, challenge ou block, plus VPN, Tor, niveau de menace et type de connexion. block seulement pour Tor et menace high. Un type Corporate est un indice, pas un verdict.
Inputs: ip (required).
lookup_ipFiche IPBRead-onlyIdempotent
Retourne la fiche IP Who d’une adresse : géolocalisation, fuseau, drapeau, devise, connexion et sécurité. Le paramètre fields limite la réponse aux champs demandés, par exemple country, city, security.
Inputs: ip (required), fields.
lookup_ipsFiches IP groupéesARead-onlyIdempotent
Retourne les fiches de 1 à 50 adresses en un seul appel API. Les doublons sont retirés. Une adresse invalide annule toute la requête.
Inputs: ips (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Les trois outils sont globalement distincts : lookup_ip renvoie les données brutes d'une IP, lookup_ips fait la même chose en lot, et check_ip produit un verdict décisionnel. La frontière entre check_ip et lookup_ip reste un peu floue puisque lookup_ip expose aussi les champs security (VPN, Tor, threat), mais les descriptions clarifient que seul check_ip rend un verdict allow/challenge/block.
Schéma verbe_nom entièrement cohérent en snake_case : check_ip, lookup_ip, lookup_ips. La distinction singulier/pluriel pour l'opération de lot est prévisible et lisible.
Trois outils pour un service d'intelligence IP, c'est mince mais chaque outil couvre un besoin réel : verdict, fiche unitaire, fiche en lot. On reste dans le périmètre bas de la fourchette recommandée sans outil redondant.
Le cycle lookup unitaire, lookup en lot et évaluation de risque est couvert, ce qui correspond au domaine. Petit manque : le verdict de risque n'existe pas en version lot (check_ip est mono-adresse), ce qu'un agent devra contourner par des appels répétés.
Maintenance
Related MCP Connectors
IP geolocation, ASN and a 0-100 risk score (VPN, proxy, Tor, datacenter) for any IP address.
Free no-key IP intelligence: geolocation, VPN detection, DNS, WHOIS, blacklists, breach checks
Resolves IP autonomous system numbers (ASN) and geographic coordinates.
Look up location, network, company and threat data for IP addresses and ASNs in ipdata.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables IP address intelligence lookup including geolocation, network information, privacy detection (VPN/proxy/Tor), company data, and abuse contacts using IPLocate.io API. Supports both IPv4 and IPv6 addresses with comprehensive analysis tools and security assessment capabilities.MIT
- AlicenseAqualityDmaintenanceProvides threat intelligence lookups against the AbuseIPDB database, enabling IP reputation checks, CIDR block analysis, and log enrichment. It features intelligent caching and rate limiting to efficiently manage API usage for security analysis and automated workflows.5MIT
- AlicenseNot gradedqualityDmaintenanceProvides comprehensive IP and domain security intelligence, enabling analysis of IP addresses and domains for threat and reputation information.1MIT
- AlicenseNot gradedqualityDmaintenanceProvides a no-key IP intelligence API for MCP clients, enabling IP geolocation, VPN/datacenter detection, DNS, WHOIS, blacklist checks, security headers, port scanning, and more.MIT