Skip to content
MCP server

FindIP

Look up IP risk signals and review risky website visits with FindIP Shield

Runs locallyStatus and history
Install
Pricing
Free
Platforms
CLI
Runs
Locally
Version
0.2.1
Listing updated
3 days ago

About FindIP

FindIP is a free MCP server for security. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a 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

Add to claude_desktop_config.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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.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>"
      }
    }
  }
}

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

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

Configuration

  • FINDIP_API_KEYYour FindIP API key (free at https://www.findip.net). Used for IP lookups and your Shield sites.Required
  • FINDIP_SHIELD_SECRET_KEYA Shield site's secret key (sec_...). Only needed for verify_session.

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Free

API keys free; Shield described as free to try

Prices change. Check findip.net before you buy.

FindIP 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 to FindIP

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools
  3. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  4. Leash

    MCP server

    Review what your AI touched, approve risky actions and undo supported changes

    • 1 tool
    • Remote
    • Free
    • 1 GitHub star
    • Security
  5. SecureCloud

    MCP server

    SentinelOne and IT security catalog, prices, quotes and checkout links for Israel

    • 7 tools
    • Remote
    • Free
    • Security