MCP.so
Sign In

WhereAmI MCP Server

@kukapay

Repository

About WhereAmI MCP Server

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

Basic information

Category

Other

License

MIT

Runtime

python

Transports

stdio

Publisher

kukapay

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.

Comments

More Other MCP servers

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

FastMCP v2 🚀

jlowin

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

26.0K

MCP Registry

modelcontextprotocol

A community driven registry service for Model Context Protocol (MCP) servers.

7.0K