curl ipq.fyi
JSON:
ipq.fyi/?format=json
Lookup an IP:
ipq.fyi/216.73.217.17
Specific field:
ipq.fyi/:countryCode
↳ with IP lookup:ipq.fyi/216.73.217.17:countryCode
Any agent that speaks MCP can geolocate addresses itself, with no key and no account. Your client needs to support remote servers over HTTP; one that only launches a local command will not see it.
https://ipq.fyi/mcp
Add to:
Run this in a terminal. Add --scope user to keep it across projects.
claude mcp add --transport http geoip https://ipq.fyi/mcp
Add to ~/.codex/config.toml, then start a new session.
[mcp_servers.geoip] url = "https://ipq.fyi/mcp"
Add to ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
{
"mcpServers": {
"geoip": {
"url": "https://ipq.fyi/mcp"
}
}
}
Add to .vscode/mcp.json in the workspace, then start it from the editor.
{
"servers": {
"geoip": {
"type": "http",
"url": "https://ipq.fyi/mcp"
}
}
}
Settings, Connectors, Add custom connector, then paste the endpoint.
https://ipq.fyi/mcp
Most clients take a url entry. Name it whatever you like.
{
"mcpServers": {
"geoip": {
"type": "http",
"url": "https://ipq.fyi/mcp"
}
}
}
Then try it out, something like geolocate 8.8.8.8 or where is 8.8.8.8.