@forgemeshlabs/anomaly-mcp 0.4.0 → 0.5.1

package/README.md

@@ -2,7 +2,7 @@
 
 Multi-domain sequence anomaly detection for AI agents. Detects unusual event patterns across blockchain markets, live airspace, and GitHub repositories using NASA-derived sequence mining. Returns a story label and anomaly score, not just a number.
 
-This MCP server gives AI agents access to the ForgeMesh Anomaly Tracker API via 14 tools spanning blockchain, aviation, and GitHub domains.
+This MCP server gives AI agents access to the ForgeMesh Anomaly Tracker API via 16 tools spanning blockchain, aviation, GitHub, and real-time market monitoring domains.
 
 Thin client architecture:
 
@@ -44,18 +44,20 @@ npx -y @forgemeshlabs/anomaly-mcp
 | --- | --- | --- |
 | `health_check` | API health and uptime | Free |
 | `anomaly_scan` | Chain-wide sequence anomaly scan | $0.05 USDC |
-| `token_scan` | Single-token transfer pattern anomalies | $0.03 USDC |
+| `token_scan` | Best-effort single-token transfer anomalies with source status | $0.03 USDC |
 | `whale_alerts` | Whale movements, CEX flows, bridge activity | $0.02 USDC |
 | `address_scan` | Wallet transaction pattern anomalies | $0.03 USDC |
 | `model_status` | SequenceMiner model health per chain | $0.01 USDC |
-| `nft_scan` | NFT collection anomalies (sweeps, wash trading) | $0.03 USDC |
+| `nft_scan` | Best-effort NFT collection anomalies with source status | $0.03 USDC |
 | `defi_scan` | DeFi protocol flow anomalies | $0.03 USDC |
-| `squawk_alerts` | Live aviation emergency squawk codes | $0.02 USDC |
+| `squawk_alerts` | Best-effort live aviation emergency squawk codes with source status | $0.02 USDC |
 | `flight_scan` | Airspace region anomaly analysis | $0.03 USDC |
 | `trending_signal` | GitHub repos with anomalous star velocity | $0.02 USDC |
 | `repo_scan` | Deep repo velocity/fork anomaly scan | $0.03 USDC |
 | `github_watch` | Repo activity stream anomalies | $0.03 USDC |
 | `claude_feature_watch` | Anthropic/Claude merged feature alerts | $0.02 USDC |
+| `mempool_anomaly` | Real-time mempool anomaly score for 5-second polling | $0.01 USDC |
+| `depeg_monitor` | Real-time stablecoin depeg detector for 1-minute polling | $0.01 USDC |
 
 ### Blockchain Tools
 
@@ -64,7 +66,7 @@ npx -y @forgemeshlabs/anomaly-mcp
 - **window**: `1h`, `4h`, `24h`, or `168h` (default: 24h)
 - Returns: `sequence_score` (0-100), `story` (human label), `novelty`, `peak_window`, `possible_failure_modes`
 
-**token_scan** — Anomaly scan for a single token's recent transfer patterns.
+**token_scan** — Best-effort anomaly scan for a single token's recent transfer patterns. Paid output includes source status and coverage notes so agents can distinguish "quiet token" from source coverage issues.
 - **token** (required): Contract address (`0x...`) or symbol — `usdt`, `usdc`, `weth`, `wbtc`, `link`, `uni`, `aave`, `steth`, `pepe`, `dai`, `cbeth`, `arb`
 - **chain**: `ethereum`, `base`, or `arbitrum` (default: ethereum)
 - **window**: `1h`, `4h`, `24h`, or `168h` (default: 24h)
@@ -78,7 +80,7 @@ npx -y @forgemeshlabs/anomaly-mcp
 - **chain**: `ethereum`, `base`, or `arbitrum`
 - **window**: `1h`, `4h`, `24h`, or `168h`
 
-**nft_scan** — Anomaly scan for an NFT collection — sweep accumulation, wash trading, mint surges.
+**nft_scan** — Best-effort anomaly scan for an NFT collection — sweep accumulation, wash trading, mint surges. Paid output includes source status and coverage notes.
 - **token** (required): ERC-721/ERC-1155 contract address
 
 **defi_scan** — Anomaly scan for DeFi protocols — unusual flows through Uniswap, Aave, Curve, Compound.
@@ -86,7 +88,7 @@ npx -y @forgemeshlabs/anomaly-mcp
 
 ### Aviation Tools
 
-**squawk_alerts** — Live global sweep of aircraft squawking 7700 (emergency), 7600 (radio failure), or 7500 (hijack).
+**squawk_alerts** — Best-effort live global sweep of aircraft squawking 7700 (emergency), 7600 (radio failure), or 7500 (hijack). Paid output includes source status, monitored scope, and coverage notes.
 
 **flight_scan** — Sequence anomaly analysis for a named airspace region.
 - **region**: `north_atlantic`, `europe`, `north_america`, `asia_pacific`, `middle_east`, `africa`, or `global`
@@ -105,6 +107,14 @@ npx -y @forgemeshlabs/anomaly-mcp
 **claude_feature_watch** — Watch Anthropic/Claude repos for recently merged features. Scans anthropic-sdk-python, anthropic-sdk-typescript, claude-code, courses, and anthropic-cookbook.
 - **days**: 1-30 (default: 7)
 
+### Real-Time Tools
+
+**mempool_anomaly** — Real-time mempool anomaly score for gas spikes, MEV signals, pending whale swaps, contract deploy bursts, and priority fee wars.
+- **chain**: `ethereum` or `base` (default: ethereum)
+
+**depeg_monitor** — Real-time stablecoin depeg detector for USDC, USDT, and DAI micro-deviations, stablecoin spreads, and volume spikes.
+- **chain**: `ethereum`, `base`, or `arbitrum` (default: ethereum)
+
 ## Symbol Alphabets
 
 **Financial**: `WHALE_BUY`, `WHALE_SELL`, `CEX_INFLOW`, `CEX_OUTFLOW`, `BRIDGE_IN`, `BRIDGE_OUT`, `DEX_SWAP`, `DEX_LIQUIDITY_ADD`, `DEX_LIQUIDITY_REMOVE`, `STABLECOIN_MINT`, `STABLECOIN_REDEEM`, `STABLECOIN_BURN`, `TOKEN_MINT`, `TOKEN_BURN`, `FUNDING_SPIKE`, `LIQUIDATION`

package/dist/index.js

@@ -5,7 +5,7 @@ import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprot
 import { callTool, tools } from "./tools.js";
 const server = new Server({
     name: "anomaly-mcp",
-    version: "0.4.0"
+    version: "0.5.1"
 }, {
     capabilities: {
         tools: {}

package/dist/tools.d.ts

@@ -241,5 +241,27 @@ export declare const tools: ({
         };
         required?: undefined;
     };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            chain: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            window?: undefined;
+            token?: undefined;
+            hours?: undefined;
+            address?: undefined;
+            protocol?: undefined;
+            region?: undefined;
+            days?: undefined;
+            repo?: undefined;
+        };
+        required?: undefined;
+    };
 })[];
 export declare function callTool(name: string, args: Record<string, unknown>): Promise<unknown>;

package/dist/tools.js

@@ -26,7 +26,7 @@ export const tools = [
     },
     {
         name: "token_scan",
-        description: "Anomaly scan for a single token — scores recent transfer patterns for unusual activity (large CEX flows, whale accumulation, token mints/burns). Pass a contract address or well-known symbol. Costs $0.03 USDC on Base mainnet.",
+        description: "Best-effort anomaly scan for a single token — scores recent transfer patterns for unusual activity and returns source status plus coverage notes. Pass a contract address or well-known symbol. Costs $0.03 USDC on Base mainnet.",
         inputSchema: {
             type: "object",
             properties: {
@@ -101,7 +101,7 @@ export const tools = [
     // ── NFT & DeFi ────────────────────────────────────────────────────────────
     {
         name: "nft_scan",
-        description: "Anomaly scan for an NFT collection — detects sweep accumulation, wash trading patterns, and mint surges before they're obvious. Pass a contract address. Returns a story label (e.g. 'Sweep Accumulation', 'Wash Trading Detected') and anomaly score. Costs $0.03 USDC on Base mainnet.",
+        description: "Best-effort anomaly scan for an NFT collection — detects sweep accumulation, wash trading patterns, and mint surges, then returns source status plus coverage notes. Pass a contract address. Costs $0.03 USDC on Base mainnet.",
         inputSchema: {
             type: "object",
             properties: {
@@ -150,7 +150,7 @@ export const tools = [
     // ── Aviation ──────────────────────────────────────────────────────────────
     {
         name: "squawk_alerts",
-        description: "Live global sweep of active aviation emergency squawk codes via OpenSky Network. Returns all aircraft currently squawking 7700 (general emergency), 7600 (radio failure), or 7500 (hijack) with position, altitude, and velocity. Costs $0.02 USDC on Base mainnet.",
+        description: "Best-effort live global sweep of active aviation emergency squawk codes via OpenSky Network. Returns aircraft currently squawking 7700, 7600, or 7500 with source status and coverage notes. Costs $0.02 USDC on Base mainnet.",
         inputSchema: {
             type: "object",
             properties: {}
@@ -226,6 +226,35 @@ export const tools = [
                 }
             }
         }
+    },
+    // ── Real-time polling endpoints ──────────────────────────────────────────
+    {
+        name: "mempool_anomaly",
+        description: "Real-time mempool anomaly score — detects gas spikes, MEV signals, pending whale swaps, contract deploy bursts, and priority fee wars. Designed for 5-second polling. Returns a story label (e.g. 'MEV Attack', 'Gas Surge', 'Priority Fee War') and anomaly score. Costs $0.01 USDC on Base mainnet.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                chain: {
+                    type: "string",
+                    enum: ["ethereum", "base"],
+                    description: "Blockchain (default: ethereum). Only Ethereum and Base have RPC mempool access."
+                }
+            }
+        }
+    },
+    {
+        name: "depeg_monitor",
+        description: "Real-time stablecoin depeg detector — monitors USDC, USDT, DAI prices for micro-deviations from $1.00 peg, spread between stables, and volume spikes. Catches depegs before they become crises. Designed for 1-minute polling. Returns a story label (e.g. 'Single Coin Drift', 'Multi-Stablecoin Crisis', 'Depeg Event') and anomaly score. Costs $0.01 USDC on Base mainnet.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                chain: {
+                    type: "string",
+                    enum: ["ethereum", "base", "arbitrum"],
+                    description: "Blockchain (default: ethereum)"
+                }
+            }
+        }
     }
 ];
 async function apiGet(path) {
@@ -333,6 +362,14 @@ export async function callTool(name, args) {
             const cfDays = args.days || 7;
             return apiGet(`/api/claude-feature-watch?days=${cfDays}`);
         }
+        case "mempool_anomaly": {
+            const mpChain = args.chain || "ethereum";
+            return apiGet(`/api/mempool-anomaly?chain=${mpChain}`);
+        }
+        case "depeg_monitor": {
+            const dpChain = args.chain || "ethereum";
+            return apiGet(`/api/depeg-monitor?chain=${dpChain}`);
+        }
         default:
             return { error: `Unknown tool: ${name}` };
     }

package/glama.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://glama.ai/mcp/schemas/server.json",
   "name": "@forgemeshlabs/anomaly-mcp",
-  "description": "Multi-domain sequence anomaly detection — blockchain, aviation, and GitHub. NASA-derived sequence mining returns story labels via x402 micropayments on Base mainnet.",
+  "description": "Multi-domain real-time anomaly detection — blockchain, aviation, GitHub, mempool, and stablecoin depeg monitoring. NASA-derived sequence mining returns story labels via x402 micropayments on Base mainnet.",
   "maintainers": [
     "clawdbotworker"
   ],
@@ -10,6 +10,10 @@
     "blockchain",
     "aviation",
     "github",
+    "mempool",
+    "stablecoin",
+    "depeg",
+    "realtime",
     "x402",
     "usdc",
     "sequence-mining"

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@forgemeshlabs/anomaly-mcp",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "mcpName": "io.github.forgemeshlabs/anomaly-mcp",
-  "description": "Multi-domain sequence anomaly detection MCP server. Blockchain, aviation, and GitHub anomalies via x402 micropayments.",
+  "description": "Multi-domain real-time anomaly detection MCP server. Mempool (5s polling), stablecoin depeg (1min polling), blockchain, aviation, and GitHub anomalies via x402 micropayments.",
   "type": "module",
   "bin": {
     "anomaly-mcp": "dist/index.js"
@@ -40,7 +40,11 @@
     "forgemesh",
     "usdc",
     "nasa",
-    "sequenceminer"
+    "sequenceminer",
+    "mempool",
+    "stablecoin",
+    "depeg",
+    "realtime"
   ],
   "author": "forgemeshlabs",
   "license": "MIT",

package/server.json

@@ -1,17 +1,17 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.forgemeshlabs/anomaly-mcp",
-  "description": "Multi-domain sequence anomaly detection — blockchain, aviation, and GitHub. NASA-derived sequence mining returns story labels via x402 micropayments.",
+  "description": "Multi-domain real-time anomaly detection — mempool, stablecoin depeg, blockchain, aviation, and GitHub. NASA-derived sequence mining via x402 micropayments.",
   "repository": {
     "url": "https://github.com/forgemeshlabs/anomaly-mcp",
     "source": "github"
   },
-  "version": "0.4.0",
+  "version": "0.5.1",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@forgemeshlabs/anomaly-mcp",
-      "version": "0.4.0",
+      "version": "0.5.1",
       "transport": {
         "type": "stdio"
       },