MCP Server Iplocate

1# MCP Server for IP address geolocation and network data from IPLocate.io
2 
3[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=iplocate&config=eyJjb21tYW5kIjoibnB4IC15IEBpcGxvY2F0ZS9tY3Atc2VydmVyIiwiZW52Ijp7IklQTE9DQVRFX0FQSV9LRVkiOiIifX0%3D)
4 
5An MCP (Model Context Protocol) server for [IPLocate.io](https://iplocate.io) - providing comprehensive IP address intelligence including geolocation, network information, privacy detection, and abuse contacts.
6 
7## Features
8 
9This MCP server provides tools to look up detailed information about IP addresses:
10 
11- **Geolocation**: Country, city, coordinates, timezone, postal code and more
12- **Network Information**: ASN name, number, type, network range, ISP information
13- **Privacy & Security**: VPN detection, proxy detection, Tor exit nodes, hosting providers
14- **Company Data**: Organization name, domain, business type
15- **Abuse Contacts**: Email, phone, and address for reporting malicious activity
16 
17## Requirements
18 
19To follow our quick start setup instructions, you will need:
20 
21- Node.js 18 or higher
22- npm
23- A compatible MCP client. For example, Cursor, Claude Desktop.
24 
25## Quick Start
26 
27The easiest way to use this MCP server is through your MCP client. Simply configure your client with the setup instructions below:
28 
29### Configure your MCP client
30 
31<details>
32<summary><strong>Cursor</strong></summary>
33 
34One-click setup:
35 
36[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=iplocate&config=eyJjb21tYW5kIjoibnB4IC15IEBpcGxvY2F0ZS9tY3Atc2VydmVyIiwiZW52Ijp7IklQTE9DQVRFX0FQSV9LRVkiOiIifX0%3D)
37 
38Manual configuration:
39 
401. In your project directory, create the configuration:
41 
42   ```bash
43   mkdir -p .cursor
44   touch .cursor/mcp.json
45   ```
46 
472. Add the following to `.cursor/mcp.json`:
48 
49   ```json
50   {
51     "mcpServers": {
52       "iplocate": {
53         "command": "npx",
54         "args": ["-y", "@iplocate/mcp-server"],
55         "env": {
56           "IPLOCATE_API_KEY": "your_api_key_here"
57         }
58       }
59     }
60   }
61   ```
62 
63   Replace `your_api_key_here` with your actual API key from [IPLocate.io](https://iplocate.io/signup).
64 
65</details>
66 
67<details>
68<summary><strong>Claude Desktop</strong></summary>
69 
701. Open Claude Desktop settings
71   - On macOS: `Cmd + ,`
72   - On Windows: `Ctrl + ,`
73 
742. Go to the "Developer" tab and click "Edit Config"
75 
763. Add the IPLocate server configuration:
77 
78   ```json
79   {
80     "mcpServers": {
81       "iplocate": {
82         "command": "npx",
83         "args": ["-y", "@iplocate/mcp-server"],
84         "env": {
85           "IPLOCATE_API_KEY": "your_api_key_here"
86         }
87       }
88     }
89   }
90   ```
91 
92   Replace `your_api_key_here` with your actual API key from [IPLocate.io](https://iplocate.io/signup).
93 
94</details>
95 
96<details>
97<summary><strong>VS Code (Preview)</strong></summary>
98 
991. Create the VS Code MCP configuration:
100 
101   ```bash
102   mkdir -p .vscode
103   touch .vscode/mcp.json
104   ```
105 
1062. Add the following to `.vscode/mcp.json`:
107 
108   ```json
109   {
110     "servers": {
111       "iplocate": {
112         "type": "stdio",
113         "command": "npx",
114         "args": ["-y", "@iplocate/mcp-server"],
115         "env": {
116           "IPLOCATE_API_KEY": "your_api_key_here"
117         }
118       }
119     }
120   }
121   ```
122 
123   Replace `your_api_key_here` with your actual API key from [IPLocate.io](https://iplocate.io/signup).
124 
125</details>
126 
127### Available tools
128 
129The server provides the following tools:
130 
131#### `lookup_ip_address_details`
132 
133Get comprehensive information about an IP address including all available data.
134 
135**Parameters:**
136 
137- `ip` (optional): IPv4 or IPv6 address to look up. If not provided, returns information about the caller's IP address.
138 
139**Example:**
140 
141```json
142{
143  "ip": "8.8.8.8"
144}
145```
146 
147**Returns:** All available data about the IP address, including geolocation, network information, privacy, and company data.
148 
149#### `lookup_ip_address_location`
150 
151Get geographic location information for an IP address.
152 
153**Parameters:**
154 
155- `ip` (optional): IPv4 or IPv6 address to look up.
156 
157**Returns:** Country, city, coordinates, timezone, postal code, and more.
158 
159#### `lookup_ip_address_privacy`
160 
161Check whether an IP address is detected as a VPN, proxy, other anonymizing service; is on an abuse blocklist; or is a hosting provider.
162 
163**Parameters:**
164 
165- `ip` (optional): IPv4 or IPv6 address to look up.
166 
167**Returns:** VPN status, proxy detection, Tor exit node status, hosting provider information.
168 
169#### `lookup_ip_address_network`
170 
171Get network and ASN (Autonomous System Number) information for an IP address.
172 
173**Parameters:**
174 
175- `ip` (optional): IPv4 or IPv6 address to look up.
176 
177**Returns:** ASN details, network range, ISP information, regional registry.
178 
179#### `lookup_ip_address_company`
180 
181Get company/organization information for an IP address.
182 
183**Parameters:**
184 
185- `ip` (optional): IPv4 or IPv6 address to look up.
186 
187**Returns:** Company name, domain, country, organization type.
188 
189#### `lookup_ip_address_abuse_contacts`
190 
191Get abuse contact information for an IP address to report malicious activity.
192 
193**Parameters:**
194 
195- `ip` (optional): IPv4 or IPv6 address to look up.
196 
197**Returns:** Abuse contact email, phone, address, and network range.
198 
199### Available prompts
200 
201The server also provides pre-configured prompts to help with common IP analysis tasks:
202 
203#### `check_ip_security`
204 
205Analyze an IP address for security concerns including VPN, proxy, Tor usage, and abuse history.
206 
207**Example usage:** "Use the check_ip_security prompt to analyze 192.168.1.1"
208 
209#### `locate_ip_geographically`
210 
211Get detailed geographic information about an IP address.
212 
213**Example usage:** "Use the locate_ip_geographically prompt to find where I am"
214 
215#### `investigate_ip_ownership`
216 
217Get detailed information about who owns and operates an IP address.
218 
219**Example usage:** "Use the investigate_ip_ownership prompt to check who owns 8.8.8.8"
220 
221#### `ip_comparison`
222 
223Compare geographic and network information between two IP addresses.
224 
225**Example usage:** "Use the ip_comparison prompt to compare 1.1.1.1 and 8.8.8.8"
226 
227## Add your API key
228 
229You can make up to 50 requests per day without an API key.
230 
231Sign up for a free API key at [IPLocate.io](https://iplocate.io/signup) to increase your free quota to **1,000 requests per day**.
232 
233### Sign up for a free API key
234 
2351. Visit [https://iplocate.io/signup](https://iplocate.io/signup)
2362. Create a free account
2373. Get your API key from the dashboard
238 
239### Using an API key with this server
240 
241The server automatically reads your API key from the `IPLOCATE_API_KEY` environment variable. Configure it in your MCP client settings (see the configuration examples above) or set it when running manually.
242 
243## Running the server manually
244 
245If you need to run the server manually (for development or testing), you have several options:
246 
247### Prerequisites
248 
249- Node.js 18 or higher
250- npm or yarn
251 
252### Using npx (recommended)
253 
254```bash
255npx -y @iplocate/mcp-server
256```
257 
258With API key:
259 
260**On macOS/Linux:**
261 
262```bash
263export IPLOCATE_API_KEY=your_api_key_here
264npx -y @iplocate/mcp-server
265```
266 
267**On Windows:**
268 
269```powershell
270set IPLOCATE_API_KEY=your_api_key_here
271npx -y @iplocate/mcp-server
272```
273 
274### Install from npm
275 
276```bash
277npm install -g @iplocate/mcp-server
278mcp-server-iplocate
279```
280 
281### Install from source
282 
283```bash
284git clone https://github.com/iplocate/mcp-server-iplocate.git
285cd mcp-server-iplocate
286yarn install
287yarn build
288yarn start
289```
290 
291For development with auto-reload:
292 
293```bash
294yarn dev
295```
296 
297### Testing
298 
299You can test the server using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector):
300 
301```bash
302npx @modelcontextprotocol/inspector node dist/index.js
303```
304 
305## API Response Format
306 
307The IPLocate API returns comprehensive data about IP addresses. Here's an example response structure:
308 
309```json
310{
311  "ip": "8.8.8.8",
312  "country": "United States",
313  "country_code": "US",
314  "city": "Mountain View",
315  "latitude": 37.386,
316  "longitude": -122.0838,
317  "asn": {
318    "asn": "AS15169",
319    "name": "Google LLC",
320    "domain": "google.com"
321  },
322  "privacy": {
323    "is_vpn": false,
324    "is_proxy": false,
325    "is_tor": false,
326    "is_hosting": true
327  }
328  // ... and more fields
329}
330```
331 
332For full details, see the [IPLocate API documentation](https://iplocate.io/docs).
333 
334## Contributing
335 
336Contributions are welcome! Please feel free to submit a Pull Request.
337 
338## License
339 
340This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
341 
342## Support
343 
344- For issues with this MCP server, please open an issue on GitHub
345- For IPLocate API support, contact <support@iplocate.io>
346- For IPLocate API documentation, visit [https://iplocate.io/docs](https://iplocate.io/docs)
347 
348## Acknowledgments
349 
350- [Model Context Protocol](https://modelcontextprotocol.io) for the MCP specification
351- [Anthropic](https://anthropic.com) for the MCP TypeScript SDK
352 
353## About IPLocate.io
354 
355Since 2017, IPLocate has set out to provide the most reliable and accurate IP address data.
356 
357We process 50TB+ of data to produce our comprehensive IP geolocation, IP to company, proxy and VPN detection, hosting detection, ASN, and WHOIS data sets. Our API handles over 15 billion requests a month for thousands of businesses and developers.
358 
359- Email: [support@iplocate.io](mailto:support@iplocate.io)
360- Website: [iplocate.io](https://iplocate.io)
361- Documentation: [iplocate.io/docs](https://iplocate.io/docs)
362- Sign up for a free API Key: [iplocate.io/signup](https://iplocate.io/signup)
363