Advertise
MCP.so
Sign In

WhereAmI MCP Server

@kukapay

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

kukapay

About WhereAmI MCP Server

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

WhereAmI MCP Server config

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

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

WhereAmI MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

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.

2

What are the minimal system requirements?

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

3

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.

4

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`).

5

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

More Other MCP servers

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.

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

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K
Advertise