IP Geolocation MCP Server

1# IP Geolocation MCP Server
2 
3This is a simple [Model Context Protocol](https://modelcontextprotocol.io) server that uses the [ipinfo.io](https://ipinfo.io) API to get detailed information about an IP address.
4This can be used to determine where the user is located (approximately) and what network they are used.
5 
6<a href="https://glama.ai/mcp/servers/pll7u5ak1h">
7  <img width="380" height="200" src="https://glama.ai/mcp/servers/pll7u5ak1h/badge" alt="IP Geolocation Server MCP server" />
8</a>
9 
10![Example conversation using mcp-server-ipinfo](demo.png)
11 
12 
13## Installation
14 
15You'll need to create a token to use the IPInfo API.
16If you don't already have one, you can sign up for a free account at https://ipinfo.io/signup.
17 
18While each client has its own way of specifying, you'll generally use the following values:
19 
20| Field | Value |
21|-------|-------|
22| **Command** | `uvx` |
23| **Arguments** | `mcp-server-ipinfo` |
24| **Environment** | `IPINFO_API_TOKEN` = `<YOUR TOKEN>` |
25 
26 
27### Development Version
28 
29If you'd like to use the latest and greatest, the server can be pulled straight from GitHub.
30Just add an additional `--from` argument:
31 
32 
33| Field | Value |
34|-------|-------|
35| **Command** | `uvx` |
36| **Arguments** | `--from`, `git+https://github.com/briandconnelly/mcp-server-ipinfo`, `mcp-server-ipinfo` |
37| **Environment** | `IPINFO_API_TOKEN` = `<YOUR TOKEN>` |
38 
39 
40## Components
41 
42### Tools
43 
44- `get_ip_details`: Get detailed information about one or more IP addresses including location, ISP, and network details.
45    - **Input:** `ips` (optional): List of IP addresses to analyze (IPv4 or IPv6). If not provided, analyzes the requesting client's IP address.
46    - **Output:** List of `IPDetails` containing location, organization, timezone, and more.
47    - **Note:** Batch lookups (multiple IPs) require `IPINFO_API_TOKEN`.
48 
49- `get_residential_proxy_info`: Check if an IP address is associated with a residential proxy service.
50    - **Input:** `ip`: The IP address to check for residential proxy usage.
51    - **Output:** `ResidentialProxyDetails` with proxy service name, last seen date, and activity percentage.
52    - **Note:** Requires `IPINFO_API_TOKEN` with residential proxy data access.
53 
54- `get_map_url`: Generate a URL to an interactive map visualization of IP addresses.
55    - **Input:** `ips`: List of IP addresses to visualize (max 500,000).
56    - **Output:** URL to an interactive map on ipinfo.io showing geographic locations.
57    - **Note:** Useful for visualizing geographic distribution of traffic or users.
58 
59### Resources
60 
61_No custom resources are included_
62 
63### Prompts
64 
65_No custom prompts are included_
66 
67 
68## Configuration
69 
70### Environment Variables
71 
72| Variable | Description | Default |
73|----------|-------------|---------|
74| `IPINFO_API_TOKEN` | IPInfo API token for premium features | None (basic lookups only) |
75| `IPINFO_CACHE_TTL` | Cache TTL in seconds | 3600 (1 hour) |
76 
77 
78## License
79 
80MIT License - See [LICENSE](LICENSE) file for details.
81 
82## Disclaimer
83 
84This project is not affiliated with [IPInfo](https://ipinfo.io).
85