ipwho-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| IPWHO_API_KEY | Yes | IP Who API key, sent in the Authorization: Bearer header. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
IPWho lookups. check_ip answers whether an IP looks risky (VPN, Tor, threat low|medium|high). Verdict block only when Tor and threat high; challenge when VPN, Tor, or threat medium/high; otherwise allow. Corporate connection is a hint, not a verdict. lookup_ip returns the full profile. lookup_ips batches up to 50 IPs and costs one API request. Free plan is 2000 requests/day. Do not claim malware families or abuse categories; the API does not provide them. Do not retry 401 or 429.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| check_ipA | 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. |
| lookup_ipB | 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. |
| lookup_ipsA | 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. |
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 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.