mcpField
M
Maskbreak

Maskbreak

Local
maskbreak.comSecurity2Updated 2w ago
RepositoryVisit website

About Maskbreak

Maskbreak is an MCP server for querying limited public IP intelligence, including cloud-hosting ranges and Tor exit nodes, and checking API status. It offers local stdio and hosted HTTP access; its lookups do not cover VPN, proxy, or device evidence.

Key features

  1. 01Look up public IPv4 and IPv6 signals
  2. 02Identify cloud hosting and Tor exits
  3. 03Return risk scores and verdicts
  4. 04Check API health, uptime, and latency
  5. 05Connect locally or through a hosted endpoint

Use cases

  1. 01Review IP signals during fraud checks
  2. 02Check whether an IP is a Tor exit node
  3. 03Inspect Maskbreak API status

MCP support

Provides MCP clients with the `lookup_ip` and `service_status` tools. The local server uses stdio, while `https://maskbreak.com/mcp` offers Streamable HTTP access.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "com-maskbreak": {
      "command": "npx",
      "args": [
        "-y",
        "@sentinelsup/mcp"
      ],
      "env": {
        "MASKBREAK_API_KEY": "<MASKBREAK_API_KEY>",
        "SENTINEL_BASE_URL": "<SENTINEL_BASE_URL>"
      }
    }
  }
}
Run commandnpx -y @sentinelsup/mcp
Environment variables to set
MASKBREAK_API_KEYSecretMaskbreak 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.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@sentinelsup/mcp0.1.8

Tools

2

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
ipstringYesPublic IPv4 or IPv6 address to check, e.g. "185.220.101.34"

Details

From the project README

Maskbreak MCP Server

Look up limited public IP intelligence — cloud-hosting ranges and Tor exit nodes — from Claude, Cursor, or another MCP client. Powered by the Maskbreak fraud detection API. Requires Node.js 18+ for the local server.

Tools

ToolWhat it does
lookup_ipPublic IPv4/IPv6 lookup: known, allow / review / block, risk score, and nullable signal/network metadata. Public-feed coverage is limited to cloud hosting and Tor.
service_statusMaskbreak API health, uptime, and latency

Setup

Grab a free API key at maskbreak.com/signup (the Free plan includes 100,000 IP lookups a month, no card; paid plans from €29 a month raise it). Keyless mode uses the free web-tool endpoint, limited to 12 lookups/minute and 80/day per caller IP. Additional endpoint and abuse-protection limits can apply.

Neither mode performs a browser visit. VPN/proxy and device evidence require a browser-SDK-backed /v1/evaluate request outside these tools; service names are available only when known. Unknown IPs, false signals and allow verdicts are not proof of safety.

Claude Code
claude mcp add sentinel -e MASKBREAK_API_KEY=sk_live_your_key -- npx -y @sentinelsup/mcp
Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "sentinel": {
      "command": "npx",
      "args": ["-y", "@sentinelsup/mcp"],
      "env": { "MASKBREAK_API_KEY": "sk_live_your_key" }
    }
  }
}
Cursor / other MCP clients

Any client that speaks stdio MCP works the same way: command npx, args ["-y", "@sentinelsup/mcp"], env MASKBREAK_API_KEY.

Hosted endpoint (no install)

Prefer a remote server? The same tools are hosted at https://maskbreak.com/mcp (Streamable HTTP). Point any URL-based MCP client at it; pass your API key as an Authorization: Bearer header for full quota.

Example

"What public-feed evidence is available for this IP?"

Illustrative unknown-IP response, not a live lookup:

{
  "ip": "192.0.2.1",
  "known": false,
  "verdict": "allow",
  "risk_score": 0,
  "signals": null,
  "network": null
}

Environment

VariableRequiredDefaultPurpose
MASKBREAK_API_KEYrecommended—API key from your dashboard; unlocks your plan's lookup allowance (100,000 a month on the Free plan). Since v0.1.5; the older SENTINEL_API_KEY name is still read
SENTINEL_BASE_URLnohttps://maskbreak.comOverride for testing

Failures and local checks

Both tools return MCP isError: true for HTTP failures, malformed responses or requests that exceed the five-second timeout (including body reads). An unavailable lookup is not an allow decision.

npm ci --ignore-scripts
npm test
npm pack --dry-run --ignore-scripts
npm audit

Tests use a real stdio MCP client with loopback HTTP fixtures, without production keys. CI checks Node.js 18, 22 and 24. No package is published by these checks.

Links

MIT © Sentinel Edge Networks LTD

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.