MYIPGO / DEVELOPERS

API- en MCP-documentatie

Gebruik openbare gegevens in scripts en AI-agents. Geen sleutel nodig voor basisverzoeken.

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

Programmatische toegang voor ontwikkelaars en agents.

Redelijke gebruikslimieten zijn van toepassing.

JSON-API-referentie

De openbare API vereist geen API-sleutel. Gebruik HTTPS GET-verzoeken; geslaagde antwoorden zijn application/json. Voorbeelden tonen de vorm; waarden kunnen veranderen.

OpenAPI-specificatie (JSON)

GET /api/v1/me

Geeft het IP-adres en beschikbare Edge-netwerkgegevens van de machine die het verzoek doet.

Parameters: Geen queryparameters.

Antwoordvelden

ip
Publiek IP-adres van de aanroeper.
version
IPv4 of IPv6.
location
Geschatte locatie of null als die ontbreekt.
network
Netwerkorganisatie of null.
asn
Autonoom systeemnummer of null.
country
Landcode van twee letters of null.
latitude / longitude
Geschatte coördinaten of null.
example
Alleen true voor het lokale voorbeeld.

Voorbeeldverzoek

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

Illustratief antwoord

{
  "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

Geeft de gevalideerde IP-versie en, als providergegevens beschikbaar zijn, land- en ASN-gegevens. Geen stadsgegevens.

Parameters: Verplicht: ip — een IPv4- of IPv6-adres.

Antwoordvelden

ip
Opgevraagd adres.
version
IPv4 of IPv6.
source
Limited bij alleen validatie; IPinfo Lite als providergegevens beschikbaar zijn.
country
Land, indien beschikbaar.
countryCode
Landcode van twee letters, indien beschikbaar.
continent
Continent, indien beschikbaar.
continentCode
Continentcode van twee letters, indien beschikbaar.
network
Netwerk-/ASN-organisatie, indien beschikbaar.
asn
Autonoom systeem, indien beschikbaar.
as_domain
Bijbehorend netwerkdomein, indien beschikbaar.

Voorbeeldverzoek

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

Illustratief antwoord

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

Met geconfigureerd IPinfo Lite bevat het antwoord ook country, countryCode, continent, continentCode, network, asn en as_domain. Ontbrekende providermetadata betekent niet dat een adres geen land of netwerk heeft.

GET /api/v1/dns

Vraagt een DNS-record op en retourneert de antwoordcode plus maximaal 30 antwoorden.

Parameters: Verplicht: name (maximaal 253 tekens). Optioneel: type — A, AAAA, CNAME, MX, NS, TXT, SOA of PTR; standaard A.

Antwoordvelden

query
Naam die naar de DNS-resolver is gestuurd.
type
Opgevraagd recordtype.
status
DNS-antwoordcode; 0 is NOERROR en 3 is NXDOMAIN. Een DNS-foutcode kan nog steeds HTTP 200 hebben.
records
Antwoorden; leeg als er geen antwoord is.
records[].type
Recordtype.
records[].value
Recordgegevens als tekst.
records[].ttl
Time-to-live in seconden.

Voorbeeldverzoek

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

Illustratief antwoord

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

Het voorbeeld gebruikt een IP-adres dat voor documentatie is gereserveerd. Een geldige zoekopdracht zonder records geeft HTTP 200, een lege records-lijst en de resolverstatus.

GET /api/v1/reverse

Maakt de reverse-naam voor een IPv4- of IPv6-adres en vraagt PTR-records op.

Parameters: Verplicht: ip — een IPv4- of IPv6-adres.

Antwoordvelden

query
Gegenereerde in-addr.arpa-naam (IPv4) of ip6.arpa-naam (IPv6).
type
PTR.
status
DNS-antwoordcode; 0 is NOERROR en 3 is NXDOMAIN.
records
Maximaal 30 PTR-antwoorden met type, value en ttl.

Voorbeeldverzoek

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

Illustratief antwoord

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

Antwoorden en TTL verschillen met de DNS-gegevens. query is de gegenereerde reverse-naam, niet het oorspronkelijke IP.

IP via de opdrachtregel

Toont in de terminal alleen het adres van de machine die het verzoek doet. Gangbare terminalclients krijgen platte tekst op de hoofdpagina; browsers blijven de website ontvangen. Gebruik /ip als expliciet teksteindpunt.

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-fouten

Fouten zijn JSON-objecten met een error-tekst. Een negatief DNS-antwoord is anders: HTTP 200 met een niet-nul DNS-status.

400Ongeldige invoerOngeldig IP-adres, DNS-verzoek of IPv4-CIDR/prefix.
403Origin niet toegestaanDe MCP-Origin komt niet overeen met de host van het verzoek.
404Endpoint onbekendGeen passend /api/v1-endpoint.
405Methode niet toegestaanJSON-API vereist GET; MCP vereist POST.
503Upstream niet beschikbaarResolver of IP-provider niet beschikbaar; probeer later opnieuw.
{ "error": "Invalid IP address" }

Er is geen numeriek aanvraagquotum gepubliceerd. Gebruik redelijke frequenties en vermijd continu pollen.

MCP via Streamable HTTP

Verbind een MCP-client via Streamable HTTP met https://myipgo.com/mcp. Er is geen API-sleutel nodig. Het endpoint is stateless; gebruik een actuele MCP-client-SDK voor initialisatie en berichtverwerking.

Beschikbare tools

my_ip
Geen argumenten. Geeft het IP van de aanroepende server en beschikbare geschatte Edge-gegevens.
lookup_ip
ip (string, verplicht). Geeft land/netwerk/domein indien beschikbaar; geen stad.
dns_lookup
name (string, verplicht); type (A, AAAA, CNAME, MX, NS, TXT of SOA; optioneel, standaard A).
reverse_dns
ip (string, verplicht). Vraagt PTR-records op voor IPv4 of IPv6.
subnet_calculator
cidr (string, verplicht). Berekent een IPv4-CIDR-subnet; prefixen 0–32. Geeft netwerk, broadcast (null voor /31 en /32), hostbereik, netmasker, wildcardmasker en aantallen.

Node.js-clientvoorbeeld

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();

Geslaagde tools geven JSON-tekstinhoud en structuredContent terug. Toolfouten geven isError: true met een tekstbericht; protocol-/transportfouten staan daar los van.

Resultaten begrijpen

my_ip toont het netwerkadres van het proces dat MyIPGo aanroept. Voor een AI-agent is dat vaak het server- of uitgaande IP, niet dat van het apparaat van de gebruiker. IP-locaties zijn schattingen. De lookup geeft geen VPN-oordeel of DNS-/WebRTC-lektest.

MyIPGo voor AI-agents ↗

‘Mijn IP’ via een agent geeft het IP van de agentserver, mogelijk niet dat van de gebruiker.