JSON-API-Referenz
Die öffentliche API benötigt keinen API-Schlüssel. Senden Sie HTTPS-GET-Anfragen; erfolgreiche Antworten verwenden application/json. Die JSON-Beispiele zeigen das Format; Werte können abweichen.
OpenAPI-Spezifikation (JSON)
GET /api/v1/me
Liefert die IP-Adresse und verfügbare Edge-Netzwerkdaten des anfragenden Systems.
Parameter: Keine Abfrageparameter.
Antwortfelder
ip- Öffentliche IP-Adresse des Aufrufers.
version- IPv4 oder IPv6.
location- Ungefährer Ort oder null, wenn nicht verfügbar.
network- Netzwerkorganisation oder null.
asn- Autonomes System oder null.
country- Zweistelliger Ländercode oder null.
latitude / longitude- Ungefährre Koordinaten oder null.
example- Nur in der lokalen Vorschaudaten-Antwort true.
Anfragebeispiel
curl https://myipgo.com/api/v1/me
Beispielantwort
{
"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
Liefert die validierte IP-Version und, sofern Anbieterdaten verfügbar sind, Land und ASN. Stadtangaben werden nicht geliefert.
Parameter: Erforderlich: ip — IPv4- oder IPv6-Adresse.
Antwortfelder
ip- Abgefragte Adresse.
version- IPv4 oder IPv6.
source- Limited bei reiner Validierung; IPinfo Lite bei Anbieterdaten.
country- Land, falls verfügbar.
countryCode- Zweistelliger Ländercode, falls verfügbar.
continent- Kontinent, falls verfügbar.
continentCode- Zweistelliger Kontinentcode, falls verfügbar.
network- Netzwerk-/ASN-Organisation, falls verfügbar.
asn- Autonomes System, falls verfügbar.
as_domain- Zugehörige Netzwerk-Domain, falls verfügbar.
Anfragebeispiel
curl --get https://myipgo.com/api/v1/lookup --data-urlencode ip=1.1.1.1
Beispielantwort
{
"ip": "1.1.1.1",
"version": "IPv4",
"source": "Limited"
}
Mit konfiguriertem IPinfo Lite enthält die Antwort zusätzlich country, countryCode, continent, continentCode, network, asn und as_domain. Fehlende Anbieterdaten bedeuten nicht, dass keine Netzwerkdaten existieren.
GET /api/v1/dns
Fragt einen DNS-Eintrag ab und liefert den Antwortcode sowie bis zu 30 Antwortdatensätze.
Parameter: Erforderlich: name (bis zu 253 Zeichen). Optional: type — A, AAAA, CNAME, MX, NS, TXT, SOA oder PTR; Standard: A.
Antwortfelder
query- An den DNS-Resolver gesendeter Name.
type- Abgefragter Eintragstyp.
status- DNS-Antwortcode; 0 bedeutet NOERROR, 3 NXDOMAIN. Ein DNS-Fehlercode kann trotzdem HTTP 200 haben.
records- Antwortdatensätze; leer, wenn keine Antworten vorliegen.
records[].type- Eintragstyp.
records[].value- Eintragsdaten als Text.
records[].ttl- Gültigkeitsdauer in Sekunden.
Anfragebeispiel
curl --get https://myipgo.com/api/v1/dns --data-urlencode name=example.com --data-urlencode type=A
Beispielantwort
{
"query": "example.com",
"type": "A",
"status": 0,
"records": [
{ "type": "A", "value": "192.0.2.1", "ttl": 300 }
]
}
Das Beispiel verwendet eine nur für Dokumentation reservierte IP-Adresse. Eine gültige Abfrage ohne passende Einträge liefert HTTP 200, ein leeres records-Array und den Resolverstatus.
GET /api/v1/reverse
Erstellt den Reverse-Namen für eine IPv4- oder IPv6-Adresse und fragt PTR-Einträge ab.
Parameter: Erforderlich: ip — IPv4- oder IPv6-Adresse.
Antwortfelder
query- Erstellter in-addr.arpa- (IPv4) oder ip6.arpa-Name (IPv6).
type- PTR.
status- DNS-Antwortcode; 0 bedeutet NOERROR, 3 NXDOMAIN.
records- Bis zu 30 PTR-Antworten mit type, value und ttl.
Anfragebeispiel
curl --get https://myipgo.com/api/v1/reverse --data-urlencode ip=1.1.1.1
Beispielantwort
{
"query": "1.1.1.1.in-addr.arpa",
"type": "PTR",
"status": 0,
"records": [
{ "type": "PTR", "value": "one.one.one.one", "ttl": 300 }
]
}
Antwortwerte und TTL hängen von den DNS-Daten ab. query enthält den erstellten Reverse-Namen, nicht die ursprüngliche IP.
IP in der Kommandozeile
Gibt im Terminal nur die Adresse des anfragenden Systems aus. Gängige Kommandozeilen-Clients erhalten an der Hauptadresse Klartext; Browser erhalten weiterhin die Website. Verwenden Sie /ip für einen eindeutigen Klartext-Endpunkt.
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
HTTP-Fehler
Fehler liefern JSON mit einer error-Zeichenfolge. Eine negative DNS-Antwort ist anders: HTTP 200 mit einem DNS-Status ungleich null.
400Ungültige EingabeUngültige IP, DNS-Abfrage oder IPv4-CIDR/Präfix.
403Origin nicht erlaubtDer Origin der MCP-Anfrage stimmt nicht mit dem Host überein.
404Endpunkt unbekanntKein passender /api/v1-Endpunkt.
405Methode nicht erlaubtJSON-API benötigt GET; MCP benötigt POST.
503Upstream nicht verfügbarResolver oder IP-Datenanbieter nicht erreichbar; später erneut versuchen.
{ "error": "Invalid IP address" }
Es ist kein numerisches Anfragekontingent veröffentlicht. Verwenden Sie angemessene Abfrageraten und vermeiden Sie enge Polling-Schleifen.
MCP über Streamable HTTP
Verbinden Sie einen MCP-Client per Streamable HTTP mit https://myipgo.com/mcp. Ein API-Schlüssel ist nicht erforderlich. Der Endpunkt ist zustandslos; ein aktuelles MCP-SDK übernimmt Protokollinitialisierung und Nachrichtenformat.
Verfügbare Tools
my_ip- Keine Argumente. Liefert die IP des aufrufenden Servers und verfügbare ungefähre Edge-Daten.
lookup_ip- ip (string, erforderlich). Liefert Land/Netzwerk/Domain, falls verfügbar; keine Stadtangabe.
dns_lookup- name (string, erforderlich); type (A, AAAA, CNAME, MX, NS, TXT oder SOA; optional, Standard A).
reverse_dns- ip (string, erforderlich). Fragt PTR-Einträge für IPv4 oder IPv6 ab.
subnet_calculator- cidr (string, erforderlich). Berechnet IPv4-CIDR-Netze; Präfixe 0–32. Liefert Netzwerk, Broadcast (null für /31 und /32), Host-Bereich, Netzmaske, Wildcard-Maske und Adressanzahlen.
Node.js-Clientbeispiel
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();
Erfolgreiche Tools liefern JSON-Textinhalt und structuredContent. Toolfehler liefern isError: true und eine Textmeldung; Protokoll-/Transportfehler sind davon getrennt.