MYIPGO / DEVELOPERS

API & MCP-Dokumentation

Öffentliche Informationen für Skripte und KI-Agenten. Für Basisendpunkte ist kein Schlüssel nötig.

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

Programmgesteuerter Zugriff für Entwickler und Agenten.

Für die kostenlose Nutzung gelten angemessene Grenzen.

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.

Ergebnisse richtig einordnen

my_ip meldet die Netzwerkadresse des aufrufenden Prozesses. Bei einem KI-Agenten ist das meist dessen Server- oder Ausgangs-IP, nicht das Gerät des Menschen. IP-Ortsangaben sind ungefähr. Die IP-Abfrage liefert weder ein VPN-Urteil noch einen DNS-/WebRTC-Lecktest.

MyIPGo für KI-Agenten ↗

„Meine IP“ eines Agenten zeigt die öffentliche IP seines Servers, nicht unbedingt die des Nutzers.