# FindIP

> FindIP is a free MCP server for security. Look up IP risk signals and review risky website visits with FindIP Shield. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI
- **Website:** https://www.findip.net/shield/overview
- **Repository:** https://github.com/findip-net/findip-mcp
- **MCP Registry name:** io.github.findip-net/findip-mcp
- **Categories:** security
- **Listing updated:** 2026-11-14

## About

FindIP is an IP intelligence service, and this local server lets an assistant query it. Ask about an address and get country, city, ISP and ASN along with signals such as VPN, proxy, Tor, relay, hosting, scanner and malicious listings, plus a threat score.

The other tools cover FindIP Shield, the company's visitor risk product that scores signups, logins, leads and checkouts by network. An assistant can list your Shield sites with today's event counts, show recent high-risk events, explain a single event in plain language, run a server-side check on a session, and read a recipe for installing Shield in a project.

It runs over stdio, is read-only, and reads keys from environment variables only, never from tool arguments or output. The README stresses that a VPN or hosting network describes the connection, not the person, and that decisions that matter belong on your server. Shield account tools are limited to 60 requests per account per minute.

## Features

- **IP lookup:** lookup_ip returns location, ISP, ASN and risk signals with a threat score.
- **Session verification:** verify_session returns score, recommendation and network rotation for a Shield session.
- **Risky event feed:** Shows recent high-risk events on a site, such as traffic hitting a signup form.
- **Plain-language explanations:** explain_event describes where an event came from and which signals fired.
- **Install help:** Recipe and status tools for adding Shield to a project.
- **Read-only access:** All seven tools only read data.

## Good for

- Check whether an address is a VPN or hosting provider
- Review what risky traffic hit a signup form this week
- Understand why a Shield session was flagged
- Set up Shield in a project with an assistant's help
- Triage suspicious logins by network signals

## Install

### Claude Code (Terminal)

```sh
claude mcp add findip-mcp --env FINDIP_API_KEY='<FINDIP_API_KEY>' --env FINDIP_SHIELD_SECRET_KEY='<FINDIP_SHIELD_SECRET_KEY>' -- npx -y @findip/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "findip-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@findip/mcp"
      ],
      "env": {
        "FINDIP_API_KEY": "<FINDIP_API_KEY>",
        "FINDIP_SHIELD_SECRET_KEY": "<FINDIP_SHIELD_SECRET_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "findip-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@findip/mcp"
      ],
      "env": {
        "FINDIP_API_KEY": "<FINDIP_API_KEY>",
        "FINDIP_SHIELD_SECRET_KEY": "<FINDIP_SHIELD_SECRET_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "findip-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@findip/mcp"
      ],
      "env": {
        "FINDIP_API_KEY": "<FINDIP_API_KEY>",
        "FINDIP_SHIELD_SECRET_KEY": "<FINDIP_SHIELD_SECRET_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "findip-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@findip/mcp"
      ],
      "env": {
        "FINDIP_API_KEY": "<FINDIP_API_KEY>",
        "FINDIP_SHIELD_SECRET_KEY": "<FINDIP_SHIELD_SECRET_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "findip-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@findip/mcp"
      ],
      "env": {
        "FINDIP_API_KEY": "<FINDIP_API_KEY>",
        "FINDIP_SHIELD_SECRET_KEY": "<FINDIP_SHIELD_SECRET_KEY>"
      }
    }
  }
}
```

## Tools

- `lookup_ip`: Country, city, ISP, ASN and risk signals for an IP.
- `verify_session`: Server-side risk check for a Shield session.
- `list_shield_sites`: Lists Shield sites with today's event counts.
- `recent_risky_events`: Recent high-risk events on a site.
- `explain_event`: Explains one event in plain language.
- `shield_install_recipe`: Recipe for adding Shield to a project.
- `shield_install_status`: Checks whether a Shield install is working.

## FAQ

### Do I need an API key?

Yes for lookups and Shield account tools; keys are free at findip.net. Install tools need none.

### Which key does verify_session need?

A Shield site's secret key (sec_...) set as FINDIP_SHIELD_SECRET_KEY.

### Can it change my settings?

No. All seven tools are read-only.

### Can I turn off the Shield account tools?

Yes. Set FINDIP_SHIELD_ACCOUNT_API to 0 to use the key for IP lookups only.

### Is FindIP free?

Yes. FindIP is free to use.

### How do I add FindIP to Claude Code?

Run this command in your terminal: claude mcp add findip-mcp --env FINDIP_API_KEY='<FINDIP_API_KEY>' --env FINDIP_SHIELD_SECRET_KEY='<FINDIP_SHIELD_SECRET_KEY>' -- npx -y @findip/mcp

### What are the best alternatives to FindIP?

The closest alternatives to FindIP are REA, Agent Roast, Midplane, Leash and Tinplate Edge AI Safety, Security & EU Compliance.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [SynomosAI Governance MCP](https://ai-powered.com/mcp/synomosai-governance-mcp-2): SynomosAI Governance MCP is an open-source MCP server for security.

---
Source: https://ai-powered.com/mcp/findip-2
