WhereAmI MCP Server

@kukapay

About WhereAmI MCP Server

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

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "whereami-mcp": {
      "command": "python",
      "args": [
        "whereami_mcp.py"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is WhereAmI MCP Server?

WhereAmI MCP Server is a lightweight Model Context Protocol server that tells you your geographic location based on your current IP address, powered by the ipapi.co API. It is designed for developers and Claude Desktop users who need quick, programmatic access to geolocation data.

How to use WhereAmI MCP Server?

Install Python 3.10+, clone the repository, install dependencies (mcp and httpx), then run python whereami_mcp.py directly or use mcp dev whereami_mcp.py for development. Optionally install it as an MCP service with mcp install whereami_mcp.py --name "WhereAmI". Query location data via the location://{type} resource or call the get_location() tool.

Key features of WhereAmI MCP Server

Dynamic resource location://{type} for specific fields (IP, city, etc.)
Full geolocation report via the get_location() tool
Predefined natural‑language prompt where_am_i_prompt
Robust error handling for API and network issues
Minimal dependencies: only mcp and httpx

Use cases of WhereAmI MCP Server

Retrieve your current city and country with a single resource call
Generate a detailed location table (IP, timezone, ISP, etc.)
Integrate geolocation data into Claude Desktop conversations
Debug or verify IP‑based location in automated workflows

FAQ from WhereAmI MCP Server

What data source does WhereAmI MCP Server use?

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

What are the minimal system requirements?

Python 3.10 or higher, and only two Python packages: mcp and httpx.

How does the server handle errors?

If the ipapi.co API is unreachable or returns an error, the server gracefully reports the issue instead of crashing.

Can I get only a single field (e.g., just the city)?

Yes. Use the resource URI location://city (or any supported type: ip, country, region, latitude, longitude, timezone, isp, asn).

Is there a natural language interface?

Yes. The where_am_i_prompt prompt automatically triggers get_location() when you ask "Where am I?" in a compliant host like Claude Desktop.

Frequently asked questions

What data source does WhereAmI MCP Server use?

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

What are the minimal system requirements?

Python 3.10 or higher, and only two Python packages: `mcp` and `httpx`.

How does the server handle errors?

If the ipapi.co API is unreachable or returns an error, the server gracefully reports the issue instead of crashing.

Can I get only a single field (e.g., just the city)?

Yes. Use the resource URI `location://city` (or any supported type: `ip`, `country`, `region`, `latitude`, `longitude`, `timezone`, `isp`, `asn`).

Is there a natural language interface?

Yes. The `where_am_i_prompt` prompt automatically triggers `get_location()` when you ask "Where am I?" in a compliant host like Claude Desktop.

Comments

Basic information

More Other MCP servers

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

Nginx UI

0xJacky

Yet another WebUI for Nginx

11.3K

🪟 Windows-MCP

CursorTouch

MCP Server for Computer Use in Windows

6.3K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K