IP lookup MCP server for Claude, Cursor and VS Code
Give Claude, Cursor and other AI assistants live IP lookups: where an address is, which network owns it (ISP and ASN), and a 0-100 risk score. On Pro and above, answers also include the VPN, proxy, Tor and datacenter flags and the reasons behind each score.
Free plan: 1,000 lookups a month. No credit card.
- Transport
- Streamable HTTP
- Auth
Authorization: Bearer <your API key>(or anX-API-Keyheader)- Tools
- 5, all read-only
What your assistant can do
Five tools. Ask in plain words and the assistant picks the tool.
-
lookup_ip
Look up one address
Location, network and risk score for one IPv4 or IPv6 address, with the fields your plan includes.
Example prompt: “Where is 8.8.8.8 and who runs it?”
-
bulk_lookup
Check a list in one call
Many addresses at once, sent in batches of your plan's bulk size (Starter: 20 per request). Each address that returns data counts as one lookup.
Example prompt: “Here are the IPs from my login log. Which countries are they in, and which ones have a high risk score?”
-
check_ip_risk
Get the risk verdict
The 0-100 risk score with its band, its label and the main reason behind it, on every plan. On Pro and above, the full breakdown: every reason with its points and source, and the VPN, proxy, Tor and datacenter flags.
Example prompt: “Is 185.220.101.1 risky?”
-
lookup_asn
Find a network
The ASN, its name, the ISP and the organization for an IP address, or a network by its AS number (AS13335 or 13335): its name, its ranges and largest prefixes. Each links to the network's page on this site.
Example prompt: “Which network is 1.1.1.1 on? And how big is AS13335?”
-
get_my_usage
See what you have left
Your plan, the lookups used and left this month, and when the count resets. It does not use a lookup.
Example prompt: “How many lookups do I have left this month?”
Setup
Pick your client and replace YOUR_KEY with your API key (VS Code asks for the key instead). Your keys are under Account → API.
Run this in a terminal. --scope user makes the server work in every folder; without it, Claude Code adds it to the current folder only.
claude mcp add --transport http --scope user myiphelp https://www.myiphelp.com/mcp/v1 --header "Authorization: Bearer YOUR_KEY"Claude Desktop's custom connectors need OAuth, which this server does not support yet. Connect through mcp-remote instead (it needs Node.js). Add this to claude_desktop_config.json (Settings → Developer → Edit Config), then restart Claude Desktop. The key sits in env because a space inside args breaks on Windows:
{
"mcpServers": {
"myiphelp": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://www.myiphelp.com/mcp/v1",
"--header", "Authorization:${AUTH_HEADER}"],
"env": { "AUTH_HEADER": "Bearer YOUR_KEY" }
}
}
}Add this to ~/.cursor/mcp.json, or to the project's .cursor/mcp.json:
{
"mcpServers": {
"myiphelp": {
"url": "https://www.myiphelp.com/mcp/v1",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}For GitHub Copilot in VS Code, add this to .vscode/mcp.json. VS Code asks for the key once and stores it, so this file holds no key:
{
"inputs": [
{ "type": "promptString", "id": "myiphelp-key", "description": "My IP Help API key", "password": true }
],
"servers": {
"myiphelp": {
"type": "http",
"url": "https://www.myiphelp.com/mcp/v1",
"headers": { "Authorization": "Bearer ${input:myiphelp-key}" }
}
}
}ChatGPT's connectors sign in with OAuth or with no authentication, and cannot send an API key, so this server does not work there yet.
Then ask your assistant something like “Where is 8.8.8.8?”. More detail, including the headers and errors, is in the API docs.
Troubleshooting
- 401 error, or “Server rejected the configured Authorization header”
-
The key was revoked or mistyped. Check the key, or create a new one. Then remove the server and add it again with the new key. In Claude Code:
claude mcp remove myiphelp --scope user
Then run the setup command above again with the new key. - The tools do not show up
- Tools load when a session starts. Start a new session, or run
/mcpin Claude Code to reconnect. - Keep your key private
- Never paste your key into a chat or share it. It belongs only in your assistant's setup. If a key gets out, revoke it and create a new one.
- After you replace a key
- Update it in every assistant and script that uses it. The old key stops working as soon as it is revoked.
Plans and limits
Every plan works, including the free one. Every tool call is an API request with your key, so it uses the same plan, monthly lookups, request rate and fields as the REST API.
| Plan | Price | Lookups a month | Requests: burst, then rate | IPs per bulk request | Full risk breakdown and VPN, proxy, Tor, datacenter flags |
|---|---|---|---|---|---|
| Starter | Free | 1,000 | 30, then 10 a minute | 20 | Score, band, label and the main reason |
| Pro | $29 a month | 100,000 | 180, then 60 a minute | 100 | Yes |
| Business | $79 a month | 500,000 | 600, then 200 a minute | 500 | Yes |
| Enterprise | $199 a month | 2,000,000 | 1,500, then 500 a minute | 1,000 | Yes |
Paid plans are billed monthly. Compare the plans
Questions
What is sent to My IP Help, and what is logged?
Your assistant sends each tool call to https://www.myiphelp.com/mcp/v1 with your API key. The addresses to look up go in the request body, never in the URL.
Every tool call is an API request and is counted like one. For each request counted toward your usage, we keep a record of its time, your key's ID and the number of lookups, with no IP addresses, for 400 days, and a daily lookup count for each key as billing history, with no time limit. Both stay after an account is closed, linked only to internal account and key IDs. Our traffic statistics count each request by endpoint, response status and time, without the addresses looked up and without linking it to your key or account. Each entry is kept for 30 days, then only daily totals per endpoint.
Our hosting and CDN providers' logs, our application logs and our error reports may contain the IP address your assistant called from. The details are in our Privacy Policy and section 6 of the Terms of Service.
Does a free key work, and what are its limits?
Yes. The free Starter plan gives 1,000 lookups a month, a burst of 30 requests and then 10 a minute, and up to 20 addresses per bulk request. Its answers have the location, the network and the risk score with its main reason. On Pro and above, answers also include the full breakdown of the score and the VPN, proxy, Tor and datacenter flags. The other plans are on the API plans page.
What counts as a lookup?
Each address that returns data counts as one lookup, whichever tool asked for it. Private, reserved and unknown addresses, errors and get_my_usage use no lookups. A bulk_lookup call is split into bulk requests of up to your plan's bulk size, and each one counts as one request toward your request rate. When the month's lookups run out, the tools answer with the time the count resets.
Where does the data come from, and do I have to credit it?
Location comes from MaxMind GeoLite2 and DB-IP Lite. The risk score and the flags also draw on the Tor Project's exit list, a list of hijacked networks, IP2Proxy LITE, public proxy lists and the IP ranges that bot operators publish; Data sources has the full list. Every tool result with data carries the credits of the sources behind it in attribution and _meta.attribution. If you or your assistant show the results to other people, you must show the credits with them.
Is there an npm package?
Not yet. Claude Desktop connects through mcp-remote as shown above, and the other clients connect to https://www.myiphelp.com/mcp/v1 directly.
Start with a free key
1,000 lookups a month on the Starter plan. Add the server to your client and ask about any public IP address.