Referens för JSON-API
Det offentliga API:et kräver ingen API-nyckel. Skicka HTTPS GET-förfrågningar; lyckade svar använder application/json. Exemplen visar formatet och värden kan ändras.
OpenAPI-specifikation (JSON)
GET /api/v1/me
Returnerar IP-adressen och tillgängliga Edge-nätverksuppgifter för maskinen som gör anropet.
Parametrar: Inga frågeparametrar.
Svarsfält
ip- Anroparens publika IP-adress.
version- IPv4 eller IPv6.
location- Ungefärlig plats eller null om den saknas.
network- Nätverksorganisation eller null.
asn- Autonomt systemnummer eller null.
country- Tvåställig landskod eller null.
latitude / longitude- Ungefärliga koordinater eller null.
example- True endast för det lokala förhandsvisningsexemplet.
Exempel på begäran
curl https://myipgo.com/api/v1/me
Exempelsvar
{
"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
Returnerar validerad IP-version och, när leverantörsdata finns, land och ASN. Stadsuppgifter returneras inte.
Parametrar: Obligatorisk: ip — en IPv4- eller IPv6-adress.
Svarsfält
ip- Den sökta adressen.
version- IPv4 eller IPv6.
source- Limited vid enbart validering; IPinfo Lite när leverantörsdata returneras.
country- Land, om tillgängligt.
countryCode- Tvåställig landskod, om tillgänglig.
continent- Kontinent, om tillgänglig.
continentCode- Tvåställig kontinentkod, om tillgänglig.
network- Nätverks-/ASN-organisation, om tillgänglig.
asn- Autonomt system, om tillgängligt.
as_domain- Tillhörande nätverksdomän, om tillgänglig.
Exempel på begäran
curl --get https://myipgo.com/api/v1/lookup --data-urlencode ip=1.1.1.1
Exempelsvar
{
"ip": "1.1.1.1",
"version": "IPv4",
"source": "Limited"
}
När IPinfo Lite är konfigurerat innehåller svaret även country, countryCode, continent, continentCode, network, asn och as_domain. Saknade leverantörsdata betyder inte att adressen saknar land eller nätverk.
GET /api/v1/dns
Slår upp en DNS-post och returnerar svarskoden samt upp till 30 svarsposter.
Parametrar: Obligatorisk: name (högst 253 tecken). Valfri: type — A, AAAA, CNAME, MX, NS, TXT, SOA eller PTR; standard A.
Svarsfält
query- Namnet som skickades till DNS-resolvern.
type- Den efterfrågade posttypen.
status- DNS-svarskod; 0 betyder NOERROR och 3 betyder NXDOMAIN. DNS-fel kan ändå returneras med HTTP 200.
records- Svarsposter; tom när svaret saknar poster.
records[].type- Posttyp.
records[].value- Postdata som text.
records[].ttl- Livslängd i sekunder.
Exempel på begäran
curl --get https://myipgo.com/api/v1/dns --data-urlencode name=example.com --data-urlencode type=A
Exempelsvar
{
"query": "example.com",
"type": "A",
"status": 0,
"records": [
{ "type": "A", "value": "192.0.2.1", "ttl": 300 }
]
}
Exemplet använder en IP-adress som är reserverad för dokumentation. En giltig sökning utan poster ger HTTP 200, en tom records-lista och resolverns status.
GET /api/v1/reverse
Skapar reverse-namnet för en IPv4- eller IPv6-adress och slår upp PTR-poster.
Parametrar: Obligatorisk: ip — en IPv4- eller IPv6-adress.
Svarsfält
query- Skapat in-addr.arpa-namn (IPv4) eller ip6.arpa-namn (IPv6).
type- PTR.
status- DNS-svarskod; 0 betyder NOERROR och 3 betyder NXDOMAIN.
records- Upp till 30 PTR-svar med type, value och ttl.
Exempel på begäran
curl --get https://myipgo.com/api/v1/reverse --data-urlencode ip=1.1.1.1
Exempelsvar
{
"query": "1.1.1.1.in-addr.arpa",
"type": "PTR",
"status": 0,
"records": [
{ "type": "PTR", "value": "one.one.one.one", "ttl": 300 }
]
}
Svar och TTL varierar med DNS-data. query är det skapade reverse-namnet, inte den ursprungliga IP-adressen.
IP från kommandoraden
Skriver endast adressen för maskinen som gör begäran. Vanliga terminalklienter får ren text på huvudadressen; webbläsare får fortfarande webbplatsen. Använd /ip för en uttrycklig textadress.
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-fel
Fel returneras som JSON med en error-sträng. Ett negativt DNS-svar är annorlunda: HTTP 200 med en DNS-status som inte är noll.
400Ogiltig indataOgiltig IP-adress, DNS-fråga eller IPv4-CIDR/prefix.
403Origin tillåts inteMCP-anropets Origin matchar inte anropsvärden.
404Okänd endpointIngen matchande /api/v1-endpoint.
405Metoden tillåts inteJSON-API kräver GET; MCP kräver POST.
503Uppströmstjänst otillgängligResolver eller IP-dataleverantör är otillgänglig; försök igen senare.
{ "error": "Invalid IP address" }
Ingen numerisk anropskvot publiceras. Använd rimlig anropstakt och undvik tät polling.
MCP via Streamable HTTP
Anslut en MCP-klient till https://myipgo.com/mcp via Streamable HTTP. Ingen API-nyckel krävs. Endpointen är tillståndslös; använd ett aktuellt MCP-SDK för protokollinitiering och meddelandeformat.
Tillgängliga verktyg
my_ip- Inga argument. Returnerar anropsserverns IP och tillgängliga ungefärliga Edge-uppgifter.
lookup_ip- ip (string, obligatorisk). Slår upp land/nätverk/domän när data finns; returnerar ingen stad.
dns_lookup- name (string, obligatorisk); type (A, AAAA, CNAME, MX, NS, TXT eller SOA; valfri, standard A).
reverse_dns- ip (string, obligatorisk). Slår upp PTR-poster för IPv4 eller IPv6.
subnet_calculator- cidr (string, obligatorisk). Beräknar ett IPv4-CIDR-nät; prefix 0–32 stöds. Returnerar nätverk, broadcast (null för /31 och /32), värdintervall, nätmask, jokerteckenmask och antal.
Node.js-klientexempel
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();
Lyckade verktygsanrop returnerar ett JSON-textobjekt och structuredContent. Verktygsfel returnerar isError: true och ett textmeddelande; protokoll-/transportfel är separata.