Skip to content
MCP server

Maskbreak

MCP server for IP lookups: Tor exit and cloud-hosting signals plus API status

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, API, Web
Runs
Locally
Version
0.1.8
Listing updated
2 days ago

About Maskbreak

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

Maskbreak is a fraud-detection API, and this server exposes its public IP intelligence to agents. It has two read-only tools. lookup_ip takes an IPv4 or IPv6 address and returns whether it is known, a verdict of allow, review or block, a risk score and nullable network details. Coverage is limited to cloud-hosting ranges and Tor exit nodes. service_status reports API health, uptime and latency.

The README is careful about limits: an unknown IP or allow verdict is not proof of safety, and it cannot tell whether an address is a VPN or proxy; that needs the REST API's live visit check with a browser script. Device fingerprinting, fake-browser detection and multi-account linking also sit outside these tools.

It runs locally through npx with a MASKBREAK_API_KEY, or as a hosted endpoint at maskbreak.com/mcp. Without a key a rate-limited free web endpoint allows 12 lookups a minute and 80 a day per caller IP. The Free plan includes 100,000 address lookups a month and paid plans start at 29 euros a month. The package is MIT licensed.

Install

Run in a terminal

claude mcp add mcp --env MASKBREAK_API_KEY='<MASKBREAK_API_KEY>' -- npx -y @sentinelsup/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@sentinelsup/mcp"
      ],
      "env": {
        "MASKBREAK_API_KEY": "<MASKBREAK_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@sentinelsup/mcp"
      ],
      "env": {
        "MASKBREAK_API_KEY": "<MASKBREAK_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@sentinelsup/mcp"
      ],
      "env": {
        "MASKBREAK_API_KEY": "<MASKBREAK_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@sentinelsup/mcp"
      ],
      "env": {
        "MASKBREAK_API_KEY": "<MASKBREAK_API_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@sentinelsup/mcp"
      ],
      "env": {
        "MASKBREAK_API_KEY": "<MASKBREAK_API_KEY>"
      }
    }
  }
}

Configuration

  • MASKBREAK_API_KEYMaskbreak API key for your plan's lookup allowance (100,000 a month on the Free plan). Without it, lookups use the rate-limited keyless endpoint. The older SENTINEL_API_KEY name is still read.
  • SENTINEL_BASE_URLAPI base URL override, for testing.

Tools this server provides (2)

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

lookup_ip
Looks up a public IP for Tor and cloud-hosting signals with a verdict and risk score
service_status
Reports Maskbreak API health, uptime and latency

What it does

IP lookup
Returns known status, verdict, risk score and network data.
Tor exit detection
Flags Tor exit nodes as block.
Cloud-host detection
Names the cloud provider's published range for review.
Service status
Reports API health, uptime and latency.
Keyless mode
Works without a key at reduced limits.
Hosted or local
Run via npx or use the hosted HTTP endpoint.

Good for

  • Check a chargeback order's IP during support triage
  • Classify the source of a traffic spike
  • Verify a signup integration against a known Tor exit
  • Check the Maskbreak API is up

Pricing

Freemium

Free plan with 100,000 lookups a month; paid plans from 29 euros a month

Prices change. Check maskbreak.com before you buy.

Maskbreak FAQ

Does it detect VPNs?

No. VPN and proxy verdicts need the REST API's live visit check.

Do I need an API key?

No, but keyless use is limited to 12 lookups a minute and 80 a day per caller IP.

What does the free plan give?

100,000 address lookups a month with an API key, no card.

Is an allow verdict proof of safety?

No. Unknown IPs and allow verdicts are not proof of safety.

Is Maskbreak free?

Maskbreak has a free plan, with paid plans for more usage or features.

How do I add Maskbreak to Claude Code?

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

What are the best alternatives to Maskbreak?

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

Alternatives to Maskbreak

  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