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.