{
  "markdown": "# Disruption Intelligence MCP\n\n[![M8ven Score](https://m8ven.ai/badge/mcp/forgemeshlabs-disruption-intelligence-mcp-pro7g7)](https://m8ven.ai/mcp/forgemeshlabs-disruption-intelligence-mcp-pro7g7)\n\nAI-native commercial disruption intelligence for MCP clients and x402-powered agents.\n\nDisruption Intelligence MCP gives AI agents access to commercial disruption signals through an MCP server backed by the hosted Forgemesh API. It supports WARN/layoff intelligence, company context, geospatial territory disruption, location-only Ripple Index cards, Ripple Signals, Ripple Paths, Disruption Intelligence Ripple Reports, x402 payment challenge inspection, and economic signal workflows without exposing private scoring logic, ingestion systems, schemas, or infrastructure.\n\nThis package is a thin client around the hosted API:\n\n`https://disruption.forgemesh.io`\n\nArchitecture:\n\n`Agent/MCP client -> this MCP server -> hosted Disruption Intelligence API`\n\nThe MCP package does not contain engine internals, scoring logic, ingestion architecture, database schema, private topology, wallet addresses, or secrets.\n\n## Install\n\n```bash\nnpm install -g @forgemeshlabs/disruption-intelligence-mcp\n```\n\nPublished package:\n\nhttps://www.npmjs.com/package/@forgemeshlabs/disruption-intelligence-mcp\n\nSource repo:\n\nhttps://github.com/forgemeshlabs/disruption-intelligence-mcp\n\nLocal development:\n\n```bash\nnpm install\nnpm run build\nnode dist/index.js\n```\n\n## Claude Desktop\n\nExample config:\n\n```json\n{\n  \"mcpServers\": {\n    \"disruption-intelligence\": {\n      \"command\": \"npx\",\n      \"args\": [\"@forgemeshlabs/disruption-intelligence-mcp\"],\n      \"env\": {\n        \"DISRUPTION_API_BASE\": \"https://disruption.forgemesh.io\"\n      }\n    }\n  }\n}\n```\n\nSee [examples/claude-desktop-config.json](examples/claude-desktop-config.json).\n\n## Tools\n\n| Tool | Endpoint | Cost behavior |\n| --- | --- | --- |\n| `get_api_status` | `GET /health` | Free |\n| `get_discovery_metadata` | `GET /index.json`, `/llms.txt`, `/openapi.json`, `/.well-known/x402.json` | Free |\n| `inspect_x402_challenge` | Unpaid request to a paid endpoint | Returns x402 challenge metadata |\n| `analyze_territory_disruption` | `GET /territory/:zip/disruption?radius=` | Paid; challenge-first by default |\n| `search_company_context` | `GET /companies/search?q=` | Paid; challenge-first by default |\n| `get_company_risk_summary` | `GET /companies/:id/intelligence` | Paid; challenge-first by default |\n| `get_event_severity` | `GET /events/:id/severity` | Paid; challenge-first by default; paid output includes confidence-rated `industry_classification` |\n| `get_event_company_intel` | `GET /events/:id/company-intel` | Paid; challenge-first by default; paid output includes confidence-rated `industry_classification` |\n| `get_event_timeline` | `GET /events/:id/timeline` | Paid; challenge-first by default |\n| `search_gold_inventory` | `GET /ripple/search?q=` | Compatibility tool name; free Ripple inventory counts and unlock pricing only |\n| `get_ripple_index` | `GET /ripple/index?q=&scope=&limit=` | Paid at $0.01; challenge-first by default; returns location-only Ripple index cards |\n| `get_gold_signals` | `GET /ripple/signals?q=&limit=&state=` | Compatibility tool name; paid at $0.10; challenge-first by default; returns Ripple Signals after settlement |\n| `get_gold_brief` | `GET /ripple/brief?q=&scope=&limit=` | Compatibility tool name; paid at $0.25; challenge-first by default; returns a Disruption Intelligence Ripple Report after settlement |\n| `get_gold_sector_impacts` | `GET /ripple/signals/:id/sector-impacts` | Compatibility tool name; paid at $0.15; challenge-first by default; returns Ripple Paths after settlement |\n\n## Ripple Output\n\nFree Ripple search is intentionally inventory-only. It returns counts, freshness, and unlock pricing without exposing commercial angles, evidence categories, source mix, signal IDs, company names, or raw source records.\n\n`get_ripple_index` unlocks a low-cost location-only index for choosing where to dig next. It can return signal IDs, event IDs, regions, states, signal types, freshness/depth/confidence/score bands, and unlock URLs, while withholding company names, employee counts, commercial angles, sector names, spend areas, source records, and impact paths.\n\nPaid Ripple endpoints expose distilled commercial intelligence. `get_gold_signals` returns Ripple Signal summaries, confidence bands, compact evidence labels, and Ripple Path inventory with an unlock endpoint. `get_gold_sector_impacts` unlocks the deeper operational map for one signal, including downstream spend categories such as fuel, food service, uniforms, maintenance, IT, logistics, office supplies, telecom, insurance, legal, cleaning, travel, and related vendor categories.\n\n## Industry Classification Output\n\nPaid event-level API responses now include `industry_classification` when event context is available. The hosted API returns the industry label, NAICS fields when present, derivation method, confidence level, source text when relevant, and a coverage note. The MCP remains a thin client: it does not infer industries locally and does not rewrite hosted WARN data.\n\n## Free vs Paid Behavior\n\nDefault mode is safe and non-settling. Free endpoints return API data directly. Paid endpoints are requested without payment credentials, so the hosted API can return an x402 `402 Payment Required` challenge.\n\nWhen payment is required, this MCP returns structured payment instructions and challenge metadata instead of dumping an upstream error. It does not require a private key and does not settle payments.\n\nFuture paid execution should be opt-in and delegated to a trusted wallet or payment client.\n\n## Configuration\n\n```bash\nDISRUPTION_API_BASE=https://disruption.forgemesh.io\n```\n\nNo wallet private key is required or accepted by this package. Paid endpoint calls return x402 challenge metadata for an external wallet or payment client to settle.\n\n## API Docs\n\nAPI docs and product context:\n\nhttps://github.com/forgemeshlabs/disruption-intelligence\n\nHosted API:\n\nhttps://disruption.forgemesh.io\n\n## Security Boundary\n\nThis repository is an agent-facing thin client wrapper around the hosted API. It intentionally excludes engine code, scoring formulas, ingestion internals, database details, operational topology, wallet addresses, private keys, and secrets.\n",
  "bytes": 6338,
  "sha": "9f671b0daa56ca2d846641546d5e1693fa45e7f9bc8fda39fac3bde71e9a5b8a",
  "repo_slug": "forgemeshlabs/disruption-intelligence-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_forgemeshlabs_disruption_intel_554aa339/readme"
}