MYIPGO / DEVELOPERS

Documentation API & MCP

Accédez aux informations publiques depuis vos scripts et agents IA. Aucune clé requise pour les requêtes de base.

JSON API

GET /api/v1/me

GET /api/v1/lookup?ip=1.1.1.1

GET /api/v1/dns?name=example.com&type=A

GET /api/v1/reverse?ip=1.1.1.1

MCP

https://myipgo.com/mcp

Accès programmatique pour les développeurs et les agents.

Une limite d’usage raisonnable s’applique.

Référence de l’API JSON

L’API publique ne nécessite pas de clé. Envoyez des requêtes HTTPS GET ; les réponses réussies sont en application/json. Les exemples illustrent le format, les valeurs peuvent varier.

Spécification OpenAPI (JSON)

GET /api/v1/me

Renvoie l’adresse IP et les informations réseau Edge disponibles pour la machine qui effectue la requête.

Paramètres: Aucun paramètre de requête.

Champs de réponse

ip
Adresse IP publique de l’appelant.
version
IPv4 ou IPv6.
location
Lieu approximatif ou null si indisponible.
network
Organisation réseau ou null.
asn
Numéro de système autonome ou null.
country
Code pays à deux lettres ou null.
latitude / longitude
Coordonnées approximatives ou null.
example
True uniquement pour l’exemple de prévisualisation locale.

Exemple de requête

curl https://myipgo.com/api/v1/me

Réponse illustrative

{
  "ip": "203.0.113.42",
  "version": "IPv4",
  "location": "Amsterdam, Netherlands",
  "network": "Example Network (AS64500)",
  "asn": 64500,
  "country": "NL",
  "latitude": 52.37,
  "longitude": 4.9,
  "example": true
}

GET /api/v1/lookup

Renvoie la version IP validée et, si les données du fournisseur sont disponibles, le pays et l’ASN. Aucune ville n’est fournie.

Paramètres: Obligatoire : ip — adresse IPv4 ou IPv6.

Champs de réponse

ip
Adresse recherchée.
version
IPv4 ou IPv6.
source
Limited pour la validation seule ; IPinfo Lite si les données du fournisseur sont disponibles.
country
Pays, si disponible.
countryCode
Code pays à deux lettres, si disponible.
continent
Continent, si disponible.
continentCode
Code continent à deux lettres, si disponible.
network
Organisation réseau/ASN, si disponible.
asn
Identifiant de système autonome, si disponible.
as_domain
Domaine réseau associé, si disponible.

Exemple de requête

curl --get https://myipgo.com/api/v1/lookup --data-urlencode ip=1.1.1.1

Réponse illustrative

{
  "ip": "1.1.1.1",
  "version": "IPv4",
  "source": "Limited"
}

Avec IPinfo Lite configuré, la réponse inclut aussi country, countryCode, continent, continentCode, network, asn et as_domain. L’absence de données du fournisseur ne signifie pas que l’adresse n’a aucun pays ou réseau.

GET /api/v1/dns

Interroge un enregistrement DNS et renvoie le code de réponse ainsi que jusqu’à 30 réponses.

Paramètres: Obligatoire : name (253 caractères maximum). Facultatif : type — A, AAAA, CNAME, MX, NS, TXT, SOA ou PTR ; valeur par défaut : A.

Champs de réponse

query
Nom envoyé au résolveur DNS.
type
Type d’enregistrement demandé.
status
Code DNS ; 0 signifie NOERROR et 3 NXDOMAIN. Un code DNS négatif peut tout de même être accompagné de HTTP 200.
records
Réponses DNS ; vide en l’absence de réponse.
records[].type
Type d’enregistrement.
records[].value
Données de l’enregistrement sous forme de texte.
records[].ttl
Durée de vie en secondes.

Exemple de requête

curl --get https://myipgo.com/api/v1/dns --data-urlencode name=example.com --data-urlencode type=A

Réponse illustrative

{
  "query": "example.com",
  "type": "A",
  "status": 0,
  "records": [
    { "type": "A", "value": "192.0.2.1", "ttl": 300 }
  ]
}

La réponse utilise une adresse réservée à la documentation. Une requête valide sans enregistrement renvoie HTTP 200, un tableau records vide et le statut du résolveur.

GET /api/v1/reverse

Construit le nom de résolution inverse d’une adresse IPv4 ou IPv6 et interroge ses enregistrements PTR.

Paramètres: Obligatoire : ip — adresse IPv4 ou IPv6.

Champs de réponse

query
Nom in-addr.arpa (IPv4) ou ip6.arpa (IPv6) généré.
type
PTR.
status
Code DNS ; 0 signifie NOERROR et 3 NXDOMAIN.
records
Jusqu’à 30 réponses PTR avec type, value et ttl.

Exemple de requête

curl --get https://myipgo.com/api/v1/reverse --data-urlencode ip=1.1.1.1

Réponse illustrative

{
  "query": "1.1.1.1.in-addr.arpa",
  "type": "PTR",
  "status": 0,
  "records": [
    { "type": "PTR", "value": "one.one.one.one", "ttl": 300 }
  ]
}

Les réponses et TTL varient selon les données DNS. query contient le nom inverse généré, pas l’adresse IP d’origine.

IP en ligne de commande

Affiche uniquement l’adresse de la machine qui effectue la requête. L’adresse principale renvoie du texte brut aux clients de terminal courants ; les navigateurs affichent toujours le site. Utilisez /ip pour un point d’accès texte explicite.

curl -fsS https://myipgo.com
curl -fsS https://myipgo.com/ip
curl -fsS https://myipgo.com/json
curl -fsS https://myipgo.com/asn
curl -fsS https://myipgo.com/country
curl -fsS https://myipgo.com/city
npx myipgo

Erreurs HTTP

Les erreurs sont des objets JSON avec une chaîne error. Une réponse DNS négative est différente : HTTP 200 avec un statut DNS non nul.

400Entrée invalideAdresse IP, requête DNS ou CIDR/préfixe IPv4 invalide.
403Origin refuséeL’Origin MCP ne correspond pas à l’hôte de la requête.
404Point d’accès inconnuAucun point d’accès /api/v1 correspondant.
405Méthode non autoriséeL’API JSON exige GET ; MCP exige POST.
503Service amont indisponibleRésolveur ou fournisseur IP indisponible ; réessayez plus tard.
{ "error": "Invalid IP address" }

Aucun quota numérique n’est publié. Utilisez un rythme raisonnable et évitez les interrogations répétées trop fréquentes.

MCP via Streamable HTTP

Connectez un client MCP à https://myipgo.com/mcp via Streamable HTTP. Aucune clé API n’est requise. Le point d’accès est sans état ; un SDK MCP récent gère l’initialisation et le format des messages.

Outils disponibles

my_ip
Aucun argument. Renvoie l’IP du serveur appelant et les informations Edge approximatives disponibles.
lookup_ip
ip (string, obligatoire). Renvoie pays/réseau/domaine si disponibles ; aucune ville.
dns_lookup
name (string, obligatoire) ; type (A, AAAA, CNAME, MX, NS, TXT ou SOA ; facultatif, A par défaut).
reverse_dns
ip (string, obligatoire). Recherche les enregistrements PTR IPv4 ou IPv6.
subnet_calculator
cidr (string, obligatoire). Calcule un sous-réseau IPv4 ; préfixes de 0 à 32. Renvoie réseau, diffusion (null pour /31 et /32), plage d’hôtes, masques et nombres d’adresses.

Exemple de client Node.js

npm install @modelcontextprotocol/sdk

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const client = new Client({ name: 'myipgo-client', version: '1.0.0' });
await client.connect(new StreamableHTTPClientTransport(
  new URL('https://myipgo.com/mcp')
));

const result = await client.callTool({
  name: 'subnet_calculator',
  arguments: { cidr: '192.168.1.0/24' }
});
if (result.isError) throw new Error(result.content[0]?.text);
console.log(result.structuredContent ?? result.content);
await client.close();

Les outils réussis renvoient un bloc de texte JSON et structuredContent. Les erreurs d’outil renvoient isError: true et un message texte ; les erreurs de protocole ou de transport sont distinctes.

Interpréter les résultats

my_ip indique l’adresse réseau du processus appelant MyIPGo. Pour un agent IA, il s’agit souvent de son IP serveur ou de sortie, pas de l’appareil de l’utilisateur. Les localisations sont approximatives. La recherche ne fournit pas de verdict VPN ni de test de fuite DNS/WebRTC.

MyIPGo pour les agents IA ↗

« Mon IP » appelé par un agent renvoie l’IP de son serveur et non nécessairement celle de l’utilisateur.