WhereAmI MCP Server

A lightweight mcp server that tells you exactly where you are.

Local serverstdioPython

What is the WhereAmI MCP server?

A lightweight mcp server that tells you exactly where you are. That is what the whereami mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.

The short version

A lightweight mcp server that tells you exactly where you are based on your current IP, powered by ipapi.co.

  • Dynamic Resources — Fetch specific data (e.g., IP, country, city) via location://{type}
  • Detailed Tool — Generate a comprehensive location report with get_location()
  • Natural Language Prompt — Ask "Where am I?" to get detailed results
  • Robust Error Handling — Gracefully manages API and network issues
  • Minimal Dependencies — Requires only mcp and httpx

Getting it running

mcp on PyPI is all you need. Most clients run it directly, so configuration is a few lines and a restart.

The tools it exposes

The server publishes 3 tools. What each one is for:

  • Prerequisites — The Prerequisites tool exposed by this server
  • Setup — 1. Clone the repository: bash git clone https://github.com/kukapay/whereami-mcp.git cd whereami-mcp 2. Install dependencies: bash pip install mcp
  • Components — The Components tool exposed by this server

What it needs from you

  • Python 3.10+ - pip

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

How it compares

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. WhereAmI's toolset — Prerequisites, Setup, Components — is a fair guide to whether it matches your workflow. It is maintained by kukapay; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Available tools

ToolWhat it does
PrerequisitesThe Prerequisites tool exposed by this server.
Setup1. Clone the repository: bash git clone https://github.com/kukapay/whereami-mcp.git cd whereami-mcp 2. Install dependencies: bash pip install mcp httpx 3. (Optional) Install as an MCP service: bash mcp install whereami_m
ComponentsThe Components tool exposed by this server.

How to install the WhereAmI MCP server

{
  "mcpServers": {
    "whereami": {
      "command": "uvx",
      "args": ["mcp"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • Python 3.10+ - pip

Example prompts to try

  • Use WhereAmI to Prerequisites.
  • Use WhereAmI to Setup.
  • Use WhereAmI to Components.

Frequently asked questions

It uses the ipapi.co API to convert your public IP address into location details such as country, city, latitude, and longitude.