Disruption Intelligence MCP
Summary: A thin MCP client for the hosted Forgemesh Disruption Intelligence API, offering free status/discovery plus paid, x402-challenge-first WARN, company, geospatial, event, and Ripple commercial-disruption intelligence.
Check hosted API health and fetch free discovery metadata (index.json, llms.txt, openapi.json, x402 well-known metadata).
Inspect x402 payment challenges for paid endpoints without settling payment.
Analyze territory disruption by ZIP code and optional radius.
Search company context and retrieve company risk intelligence summaries.
Retrieve event severity, event company intel, and event timeline per the server schema; paid event responses may include industry_classification.
Search free Ripple inventory counts and unlock pricing without exposing signal details.
Get paid location-only Ripple Index cards, Ripple Signals, Disruption Intelligence Ripple Reports, and Ripple Paths/sector impacts for a signal.
Default paid behavior is safe and non-settling: calls return structured x402 challenge metadata; no private key is required or accepted.
Uses a fixed hosted API base URL with bounded requests: 60s timeout, 2 MB response cap, no redirects, and challenge inspection limited to a plain path on that host.
Note: the schema exposes get_event_timeline, while the README says timeline was removed and replaced by get_event_history.
Disruption Intelligence MCP
AI-native commercial disruption intelligence for MCP clients and x402-powered agents.
Disruption 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.
This package is a thin client around the hosted API:
https://disruption.forgemesh.io
Architecture:
Agent/MCP client -> this MCP server -> hosted Disruption Intelligence API
The MCP package does not contain engine internals, scoring logic, ingestion architecture, database schema, private topology, wallet addresses, or secrets.
Install
npm install -g @forgemeshlabs/disruption-intelligence-mcpPublished package:
https://www.npmjs.com/package/@forgemeshlabs/disruption-intelligence-mcp
Source repo:
https://github.com/forgemeshlabs/disruption-intelligence-mcp
Local development:
npm install
npm run build
node dist/index.jsRelated MCP server: coinopai-mcp
Claude Desktop
Example config:
{
"mcpServers": {
"disruption-intelligence": {
"command": "npx",
"args": ["@forgemeshlabs/disruption-intelligence-mcp"]
}
}
}See examples/claude-desktop-config.json.
Tools
Tool | Endpoint | Cost behavior |
|
| Free |
|
| Free |
| Unpaid request to a paid endpoint | Returns x402 challenge metadata |
|
| Paid; challenge-first by default |
|
| Paid; challenge-first by default |
|
| Paid; challenge-first by default |
|
| Paid; challenge-first by default; output includes |
|
| Paid; challenge-first by default; output includes |
|
| Paid at $0.02; challenge-first by default; WARN notice amendment history (replaces the removed timeline route) |
|
| Compatibility tool name; free Ripple inventory counts and unlock pricing only |
|
| Paid at $0.01; challenge-first by default; returns location-only Ripple index cards |
|
| Compatibility tool name; paid at $0.10; challenge-first by default; returns Ripple Signals after settlement |
|
| Compatibility tool name; paid at $0.25; challenge-first by default; returns a Disruption Intelligence Ripple Report after settlement |
|
| Compatibility tool name; paid at $0.15; challenge-first by default; returns Ripple Paths after settlement |
Ripple Output
Free 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.
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.
Paid 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.
Industry Classification Output
Paid 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.
Free vs Paid Behavior
Default 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.
When 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.
Future paid execution should be opt-in and delegated to a trusted wallet or payment client.
Configuration
No environment variables are read. The API base URL is fixed to https://disruption.forgemesh.io; every request is bounded (60 s timeout, 2 MB response cap, no redirects) and inspect_x402_challenge only accepts a plain path on that host.
No 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.
API Docs
API docs and product context:
https://github.com/forgemeshlabs/disruption-intelligence
Hosted API:
https://disruption.forgemesh.io
Security Boundary
This 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.
Available Tools
14 toolsanalyze_territory_disruptionA
Thin wrapper for GET /territory/:zip/disruption?radius=. Paid endpoint; returns x402 challenge in default non-settling mode.
Inputs: zip (required), radius.
get_api_statusA
Check the hosted Disruption Intelligence API health endpoint. Free.
Inputs: no named parameters.
get_company_risk_summaryB
Thin wrapper for GET /companies/:id/intelligence. Paid endpoint; returns x402 challenge in default non-settling mode.
Inputs: id (required).
get_discovery_metadataB
Fetch free discovery metadata from index.json, llms.txt, openapi.json, and x402 well-known metadata. Free.
Inputs: no named parameters.
get_event_company_intelA
Thin wrapper for GET /events/:id/company-intel. Paid endpoint; enriched paid responses include event industry_classification with method, confidence, and coverage_note. Returns x402 challenge in default non-settling mode.
Inputs: id (required).
get_event_severityB
Thin wrapper for GET /events/:id/severity. Paid endpoint; enriched paid responses include industry_classification with method, confidence, and coverage_note. Returns x402 challenge in default non-settling mode.
Inputs: id (required).
get_event_timelineA
Thin wrapper for GET /events/:id/timeline. Paid endpoint; returns x402 challenge in default non-settling mode.
Inputs: id (required).
get_gold_briefC
Compatibility tool for GET /ripple/brief. Paid endpoint currently priced at $0.25; returns a Disruption Intelligence Ripple Report, challenge-first by default.
Inputs: q, limit, scope.
get_gold_sector_impactsA
Compatibility tool for GET /ripple/signals/:id/sector-impacts. Paid endpoint currently priced at $0.15; returns Ripple Paths with deep operational spend and downstream sector impacts for one signal, challenge-first by default.
Inputs: id (required).
get_gold_signalsA
Compatibility tool for GET /ripple/signals. Paid endpoint currently priced at $0.10; returns Ripple Signals and Ripple Path inventory, challenge-first by default.
Inputs: q, limit, state.
get_ripple_indexA
Thin wrapper for GET /ripple/index. Paid endpoint currently priced at $0.01; returns location-only Ripple index cards with signal IDs, bands, and unlock URLs while withholding companies, employee counts, commercial angles, and impact paths.
Inputs: q, limit, scope.
inspect_x402_challengeA
Make an unpaid request to a paid endpoint and return the structured x402 payment challenge. Does not settle payment.
Inputs: endpoint.
search_company_contextA
Thin wrapper for GET /companies/search?q=. Paid endpoint; returns x402 challenge in default non-settling mode.
Inputs: q (required).
search_gold_inventoryB
Compatibility tool for free inventory-only Ripple Signal search. Returns counts and unlock pricing without revealing signal details.
Inputs: q.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Most tools target distinct resources, but the 'gold' family (get_gold_signals, search_gold_inventory, get_gold_brief, get_gold_sector_impacts) and the ripple index overlap conceptually, making selection less obvious. Event tools and company tools are clearer, though get_company_risk_summary and get_event_company_intel could still be confused.
Tool names consistently use a verb_noun pattern, mostly get_*, with search_, analyze_, and inspect_ as readable variations. The main inconsistency is mixing 'gold' and 'ripple' branding across related tools.
14 tools is slightly on the high side but still reasonable for a multi-faceted intelligence API covering company, event, territory, ripple signals, metadata, and API status. The count is manageable, though several thin paid-endpoint wrappers add breadth without much conceptual variety.
The server covers discovery, API health, company intelligence, event intelligence, territory analysis, and ripple/gold signal products. Minor gaps exist, such as no explicit event search or signal detail unlock flow beyond the generic x402 challenge mechanism, but agents can work around these.
Maintenance
Related MCP Connectors
Pay-per-call DeFi and macro intel for AI agents. x402 USDC tools via streamable HTTP /api/mcp.
Intelligence subscription protocol for AI agents. Scored, filtered AI intelligence signals via MCP.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Remote MCP server exposing 330 production AI-agent services for web/data processing, validation, AI utilities, blockchain/crypto utilities, and x402 pay-per-use access.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAgent-native company intelligence. AI agents search and retrieve structured, verified company context (certifications, capabilities, capacity, lead times) for manufacturing & supply chain via 5 MCP tools.MIT
- AlicenseAqualityBmaintenanceKronos crypto signals + trade decisions + 819 automation prompts. x402 micropayments, USDC/Base.11707 npm1MIT
- FlicenseNot gradedqualityBmaintenanceThe first MCP server that pays for itself. AI agents pay for ScriptMasterLabs data autonomously via x402 — 43+ pay-per-call tools for market intelligence, SEC filings, federal grants/contracts, and more.1-
- FlicenseAqualityDmaintenanceMCP server that exposes tools for monitoring supply chain disruptions, including vessel positions, port weather, congestion, and news. Includes an AI agent that synthesizes these sources to assess route risks.5-