FindIP
Look up IP risk signals and review risky website visits with FindIP Shield
- 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/mcpAdd 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.RequiredFINDIP_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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools
Agent Roast
MCP serverOffline review that flags agent changes which weaken tests, assertions or CI
Runs locally- Open source
- 4 Hacker News points
- Developer tools

Midplane
MCP serverPostgres gateway for AI agents with table grants, column masking and approval for writes
Runs locally- Open source
- 5 GitHub stars
- Databases

Leash
MCP serverReview what your AI touched, approve risky actions and undo supported changes
- 1 tool
- Remote
- Free
- 1 GitHub star
- Security
Zero-log MCP server with 49 tools for AI guardrails, secret scanning and EU compliance
- 49 tools
- Remote
- Freemium
- Security

SecureCloud
MCP serverSentinelOne and IT security catalog, prices, quotes and checkout links for Israel
- 7 tools
- Remote
- Free
- Security