@sentinelsup/mcp 0.1.4 → 0.1.6

package/README.md

@@ -18,7 +18,7 @@ Neither mode performs a browser visit. VPN/proxy and device evidence require a b
 ### Claude Code
 
 ```bash
-claude mcp add sentinel -e SENTINEL_API_KEY=sk_live_your_key -- npx -y @sentinelsup/mcp
+claude mcp add sentinel -e MASKBREAK_API_KEY=sk_live_your_key -- npx -y @sentinelsup/mcp
 ```
 
 ### Claude Desktop
@@ -31,7 +31,7 @@ Add to `claude_desktop_config.json`:
     "sentinel": {
       "command": "npx",
       "args": ["-y", "@sentinelsup/mcp"],
-      "env": { "SENTINEL_API_KEY": "sk_live_your_key" }
+      "env": { "MASKBREAK_API_KEY": "sk_live_your_key" }
     }
   }
 }
@@ -39,7 +39,7 @@ Add to `claude_desktop_config.json`:
 
 ### Cursor / other MCP clients
 
-Any client that speaks stdio MCP works the same way: command `npx`, args `["-y", "@sentinelsup/mcp"]`, env `SENTINEL_API_KEY`.
+Any client that speaks stdio MCP works the same way: command `npx`, args `["-y", "@sentinelsup/mcp"]`, env `MASKBREAK_API_KEY`.
 
 ### Hosted endpoint (no install)
 
@@ -66,7 +66,7 @@ Illustrative unknown-IP response, not a live lookup:
 
 | Variable | Required | Default | Purpose |
 |----------|----------|---------|---------|
-| `SENTINEL_API_KEY` | recommended | — | API key from your [dashboard](https://maskbreak.com/dashboard); unlocks 1,000 lookups/hour |
+| `MASKBREAK_API_KEY` | recommended | — | API key from your [dashboard](https://maskbreak.com/dashboard); unlocks 1,000 lookups/hour. Since v0.1.5; the older `SENTINEL_API_KEY` name is still read |
 | `SENTINEL_BASE_URL` | no | `https://maskbreak.com` | Override for testing |
 
 ## Failures and local checks

package/index.js

@@ -2,10 +2,11 @@
 // Maskbreak MCP server — IP fraud intelligence for MCP clients (Claude Code,
 // Claude Desktop, Cursor, ...). One stdio server, two tools.
 //
-// With SENTINEL_API_KEY set, lookups go through the authenticated API
-// (GET /v1/lookup/{ip}, 1,000 req/hr on the free tier). Without a key they
-// fall back to the free web-tool endpoint, which is fine for trying it out
-// but rate-limited to a handful of lookups per minute.
+// With MASKBREAK_API_KEY set (the older SENTINEL_API_KEY still works), lookups
+// go through the authenticated API (GET /v1/lookup/{ip}, 1,000 req/hr on the
+// free tier). Without a key they fall back to the free web-tool endpoint,
+// which is fine for trying it out but rate-limited to a handful of lookups
+// per minute.
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
@@ -18,7 +19,9 @@ const { version: VERSION } = JSON.parse(
 );
 
 const BASE = (process.env.SENTINEL_BASE_URL || 'https://maskbreak.com').replace(/\/+$/, '');
-const API_KEY = process.env.SENTINEL_API_KEY || '';
+// MASKBREAK_API_KEY is the name every doc surface uses; SENTINEL_API_KEY is
+// the older name, still read so existing client configs keep working.
+const API_KEY = process.env.MASKBREAK_API_KEY || process.env.SENTINEL_API_KEY || '';
 const TIMEOUT_MS = 5000;
 
 async function requestJson(path, init = {}, keylessLookup = false) {
@@ -39,7 +42,7 @@ async function requestJson(path, init = {}, keylessLookup = false) {
     }
     if (!res.ok) {
       const hint = keylessLookup && res.status === 429
-        ? ' (keyless mode is tightly rate-limited — set SENTINEL_API_KEY for 1,000 lookups/hour; free key at https://maskbreak.com/signup)'
+        ? ' (keyless mode is tightly rate-limited — set MASKBREAK_API_KEY for 1,000 lookups/hour; free key at https://maskbreak.com/signup)'
         : '';
       throw new Error(`${data?.error || `HTTP ${res.status}`}${hint}`);
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sentinelsup/mcp",
-  "version": "0.1.4",
-  "mcpName": "io.github.sentinelsup/maskbreak-mcp",
+  "version": "0.1.6",
+  "mcpName": "com.maskbreak/mcp",
   "description": "MCP server for Maskbreak — look up public cloud-hosting and Tor IP signals, with limited reputation evidence and API status, from an MCP client.",
   "keywords": [
     "mcp",