MYIPGO / DEVELOPERS

API- och MCP-dokumentation

Använd offentlig information i skript och AI-agenter. Ingen nyckel behövs för grundläggande anrop.

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

Programmatisk åtkomst för utvecklare och agenter.

Rimliga användningsgränser gäller.

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.

Tolka resultat

my_ip visar nätverksadressen för processen som anropar MyIPGo. För en AI-agent är det ofta dess server- eller utgående IP, inte användarens enhet. IP-platser är ungefärliga. IP-sökningen ger inget VPN-besked eller DNS-/WebRTC-läcktest.

MyIPGo för AI-agenter ↗

”Mitt IP” från en agent ger agentserverns publika IP, inte nödvändigtvis användarens.