Related MCP Server Resources

Explore more AI models, providers, and integration options:

  • Explore AI Models
  • Explore AI Providers
  • Explore MCP Servers
  • LangDB Pricing
  • Documentation
  • AI Industry Blog
  • MCP Sumo Logic Server
  • Find Flights MCP Server
  • Email Checker MCP Server
  • Ollama MCP Database Assistant
  • argocd-mcp
Back to MCP Servers
whereami-mcp

whereami-mcp

Public
kukapay/whereami-mcp

Lightweight MCP server leveraging IP-based geolocation to provide dynamic location data, detailed reports, and natural language queries with minimal dependencies and robust error handling.

python
0 tools
May 30, 2025
Updated Jun 4, 2025

Supercharge Your AI with whereami-mcp

MCP Server

Unlock the full potential of whereami-mcp through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.

Unified API Access
Complete Tracing
Instant Setup
Get Started Now

Free tier available • No credit card required

Instant Setup
99.9% Uptime
10,000+Monthly Requests

WhereAmI MCP Server

Python License Status

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

Features

  • 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.

Installation

Prerequisites

  • Python 3.10+
  • pip

Setup

  1. Clone the repository:
    git clone https://github.com/kukapay/whereami-mcp.git cd whereami-mcp
  2. Install dependencies:
    pip install mcp httpx
  3. (Optional) Install as an MCP service:
    mcp install whereami_mcp.py --name "WhereAmI"

Usage

Running the Server

  • Direct execution:
    python whereami_mcp.py
  • Development mode:
    mcp dev whereami_mcp.py

Components

Resource: location://{type}

Returns a specific location detail based on {type}.

  • Supported Types: ip, country, country_code, region, city, latitude, longitude, timezone, isp, asn
  • Examples:
    • @location://ip → "8.8.8.8"
    • @location://city → "Mountain View"
    • @location://country → "United States"

Tool: get_location()

Generates a detailed Markdown table of geolocation data.

  • Fields:
    • IP
    • Country
    • Country Code
    • Region
    • City
    • Latitude
    • Longitude
    • Timezone
    • ISP
    • ASN
  • Sample Output:
    | Field          | Value             |
    |----------------|-------------------|
    | IP            | 8.8.8.8           |
    | Country       | United States     |
    | Country Code  | US                |
    | Region        | California        |
    | City          | Mountain View     |
    | Latitude      | 37.4223           |
    | Longitude     | -122.0848         |
    | Timezone      | America/Los_Angeles |
    | ISP           | GOOGLE            |
    | ASN           | AS15169           |
    

Prompt: where_am_i_prompt

Predefined query: "Please tell me where I am based on my current IP address." Triggers get_location().

Examples in Claude Desktop

  1. Install the server:
    mcp install whereami_mcp.py --name "WhereAmI"
  2. Query data:
    • "My IP is @location://ip"
    • "I’m in @location://city, @location://country"
  3. Get full report:
    • "Where am I?"
    • get_location()

License

MIT License. See LICENSE for details.

Publicly Shared Threads0

Discover shared experiences

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!

Share your threads to help others
Related MCPs5
  • MCP Sumo Logic Server
    MCP Sumo Logic Server

    Model Context Protocol server integrating with Sumo Logic API to perform customizable log searches w...

    Added May 30, 2025
  • Find Flights MCP Server
    Find Flights MCP Server

    Search and retrieve detailed flight information using Duffel API with contextual memory, flexible mu...

    Added May 30, 2025
  • Email Checker MCP Server
    Email Checker MCP Server

    Validate email addresses efficiently with a Model Context Protocol server offering simple JSON respo...

    1 tools
    Added May 30, 2025
  • Ollama MCP Database Assistant
    Ollama MCP Database Assistant

    Interactive chat interface leveraging Model Context Protocol to enable natural language queries and ...

    Added May 30, 2025
  • argocd-mcp
    argocd-mcp

    An MCP (Model Context Protocol) server integrating with the ArgoCD API to enable AI assistants and l...

    Added May 30, 2025