whereami
agent-ready json output non-interactive
:round_pushpin: Get your geolocation information using freegeoip.app
How to install whereami
npm install -g @rafaelrinaldi/whereami whereami use case
Get geolocation information (latitude, longitude, city, country) for a given IP address or the user's own IP address via CLI.
When to use whereami
- When an AI agent needs to determine the geographic location of an IP address.
- When generating location-based context for a user or system (e.g., timezone, country).
- When automating geolocation lookups in scripts or pipelines.
When not to use whereami
- If offline geolocation is required (the tool depends on freegeoip.app API).
- If precise street-level or postal address data is needed (freegeoip.app provides city-level accuracy).
- If high-frequency or bulk lookups are needed without rate limit management.
whereami features
- · Get geolocation of current IP or any specified IP address
- · Multiple output formats: human-readable, JSON, sexagesimal, raw data
- · Simple CLI interface with help and version flags
- · Lightweight JavaScript package installable via npm
Want your agent to find this automatically?
Add the MCP server to your agent config and it will discover tools like whereami on its own.
Set up MCP →