SupplyMaven API Pro
OfficialThe SupplyMaven API Pro server provides real-time, AI-driven supply chain risk intelligence across 24 tools. Here's what you can do:
Core Risk Assessment
Monitor the Global Disruption Index (GDI): a 0–100 composite score built from 200+ live variables across Transportation (30%), Energy (25%), Materials (25%), and Macro (20%) pillars
Analyze GDI trends, velocity, and acceleration over 7/14/30/90-day windows to detect regime changes
Manufacturing Intelligence
Detect US manufacturing output shifts up to 24 hours early using the patent-pending SMI (weather-normalized electricity demand across 8 grid regions)
Identify unusual factory shutdown or ramp-up patterns with 7-day anomaly history
Commodity & Market Monitoring
Track real-time prices and volatility for 31 commodities (energy, metals, agriculture, industrial, semiconductors)
Receive alerts for abnormal 24-hour price movements
Logistics & Transportation
Monitor port congestion at 26 major global ports with trend and acceleration analysis
Track vessel traffic at critical maritime chokepoints (Suez, Panama, Hormuz, Malacca, and more)
Get real-time commercial border crossing wait times at 80+ US-Mexico/Canada crossings (updated every 30 min)
Monitor air cargo disruptions at 39 major cargo hub airports
Track US freight rail performance (train speed, dwell time, carloadings) and the BTS Transportation Services Index
Trade Policy & Energy
Track active tariffs, sanctions, and export controls with their ongoing GDI impact
Access disaggregated US energy data (crude oil, natural gas, retail fuel, refinery utilization) and EIA Short-Term Energy Outlook forecasts
Predictive Signals
Access 58 Granger-causal leading indicators (p≤0.01) predicting commodity prices, manufacturing shifts, and macro changes 1 week to 6 months ahead
Get plain-language signal narratives for executive briefings
Retrieve FRED data, PPI, and the NY Fed Global Supply Chain Pressure Index
Reporting & Alerts
Generate executive-level weekly situation reports combining all data sources
Receive AI-written hourly analytical briefs per supply chain dimension
Get real-time disruption alerts for port closures, tariffs, weather events, and labor strikes
Generate a weekly pre-written content package (Substack, LinkedIn, Twitter/X) from live supply chain data
Provides programmatic access to supply chain intelligence tools via CrewAI, enabling integration of real-time supply chain data, disruption alerts, and predictive signals into AI applications and workflows.
Provides programmatic access to supply chain intelligence tools via LangChain, enabling integration of real-time supply chain data, disruption alerts, and predictive signals into AI applications and workflows.
Provides real-time supply chain risk intelligence tools for ChatGPT/OpenAI Agents, including global disruption indices, commodity price monitoring, manufacturing indicators, port congestion data, and predictive signals for supply chain decision-making.
Provides programmatic access to supply chain intelligence tools via Vercel AI SDK, enabling integration of real-time supply chain data, disruption alerts, and predictive signals into AI applications and workflows.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
SupplyMaven MCP Server
Real-time supply chain risk intelligence for AI agents. The only MCP server providing live supply chain disruption data, proprietary risk indices, and validated predictive signals.
Track 31 commodities, 26 global ports, 80+ border crossings, maritime chokepoints, air cargo hubs, and trade policy impacts — with proprietary indices that replace enterprise supply chain visibility platforms costing $100K+/year.
https://supplymaven.com/api/mcp
Keywords: supply chain risk management tools, agentic AI for supply chain, real-time supply chain visibility, supply chain disruption monitoring, supply chain risk intelligence, automated supply chain monitoring, supply chain visibility platform, supplier risk monitoring, SCM software, leading manufacturing indicator
Connect in 30 Seconds
Claude Desktop / Claude Code
Add to your MCP server configuration:
{
"mcpServers": {
"supplymaven": {
"url": "https://supplymaven.com/api/mcp",
"headers": {
"Authorization": "Bearer sm_free_your_key_here"
}
}
}
}ChatGPT / OpenAI Agents
Endpoint: https://supplymaven.com/api/mcp
Transport: Streamable HTTP
Auth: Bearer sm_free_your_key_hereCursor / VS Code
{
"mcpServers": {
"supplymaven": {
"type": "http",
"url": "https://supplymaven.com/api/mcp",
"headers": {
"Authorization": "Bearer sm_free_your_key_here"
}
}
}
}Programmatic (Vercel AI SDK, LangChain, CrewAI)
import { experimental_createMCPClient } from "ai";
const client = await experimental_createMCPClient({
transport: {
type: "sse",
url: "https://supplymaven.com/api/mcp",
}
});
const tools = await client.tools();
// 34 supply chain intelligence tools readyAny MCP Client
Endpoint: https://supplymaven.com/api/mcp
Transport: Streamable HTTP
Auth: Bearer token (sm_free_* or sm_live_*)
Free tier: Get a key instantly at supplymaven.com/developers
Related MCP server: freight-pulse
Available Tools (34)
Free Tier — No credit card, get a key instantly
Tool | Description |
| Global Disruption Index (GDI) — 0-100 composite score of supply chain risk across Transportation (30%), Energy (25%), Materials (25%), and Macro (20%) pillars. Built from 200+ live data variables. |
| Real-time prices for 31 commodities across energy, metals, agriculture, industrial, and semiconductor materials. Free tier: 5 key commodities. |
| Real-time disruption alerts from global news intelligence — port closures, tariffs, sanctions, weather, labor strikes. Free tier: critical severity only. |
Pro Tier — contact tellme@supplymaven.com - includes Dashboard
Tool | Description |
| Supply Manufacturing Index (SMI) — Patent-pending weather-adjusted electricity demand indicator. Detects US manufacturing output changes up to 24 hours before government reports across 8 power grid regions. Leading manufacturing indicator used by commodity traders and hedge funds. |
| Individual GDI pillar scores for Transportation, Energy, Materials, and Macro with weights and news boost breakdown. |
| Vessel counts, congestion scores, and port status at 26 major global ports across US, Asia, and Europe. |
| Validated predictive signals — Granger-causal leading indicators (p<=0.01) evaluated against live data. ACTIVE/WATCH/CLEAR status with directional accuracy and lag times. |
| Real-time US-Mexico and US-Canada commercial border crossing wait times. 80+ crossings updated every 30 minutes from CBP. |
| Maritime chokepoint vessel traffic — Suez Canal, Panama Canal, Strait of Malacca, Strait of Hormuz, and other strategic waterways. |
| Air cargo disruption status at 39 US and international airports. FAA ground delays, ground stops, disruption scores, and traffic collapse detection. |
| Active tariffs, sanctions, export controls, and policy changes impacting supply chain risk. Persists beyond news cycle — shows ongoing GDI score impact. |
| Disaggregated US energy market data — crude oil, natural gas, retail fuel, refinery utilization, storage levels, and petroleum trade flows. |
| US freight rail performance — train speed, terminal dwell time, carloadings, intermodal units, and grain transport rates from STB/AAR/USDA. |
| BTS Transportation Services Index, truck tonnage, rail carloadings, rail intermodal, waterborne freight, and inventory-to-sales ratio. |
| FRED economic data, Producer Price Index, NY Fed Global Supply Chain Pressure Index, and EIA STEO energy forecasts. |
| Real-time natural disaster alerts from USGS, NOAA, and GDACS. Earthquakes, hurricanes, floods, volcanoes with severity and coordinates. |
| Risk levels across 10 ocean freight trade corridors. Weakest-link scoring chains ports and chokepoints into end-to-end lane risk. |
| Freight rate index observations (BDI, SCFI, WCI, CCFI, HARPEX) with direction, magnitude, and trade lane context. |
| Customs and trade policy events — tariffs, sanctions, export controls. Direction (RESTRICTIVE/LIBERALIZING) and US impact assessment. |
| Labor actions affecting supply chains — strikes, lockouts, slowdowns, contract negotiations with affected ports and status. |
| Freight rate pressure scores for WCI and SCFI. Z-score vs 52-week baseline mapped to 0-100 with corridor mapping. |
| Per-country customs friction baseline (0-100) combining port congestion and trade policy events. 21 countries. |
| Active natural disaster events with geographic and type filtering. Region-based filtering and multi-day lookback. |
| Port Readiness scores for 7 US ports. 5-component composite: rail dwell, vessel congestion, highway incidents, truck availability, weather. |
Signal Tier — Enterprise - includes everything in Pro
Tool | Description |
| 58 Granger-causal leading indicators with ACTIVE/WATCH/CLEAR status. Predicts commodity prices, manufacturing shifts, and macroeconomic changes 1 week to 6 months ahead. Filter by tier, status, or predictor group. |
| Electricity demand anomaly detection across 8 US grid regions. Patent-pending weather normalization isolates industrial demand. Current SMI score with regional breakdown plus 7-day anomaly history ranked by severity. |
| Executive-level weekly situation report combining GDI pillar scores, manufacturing output, port congestion, active predictive signals, top disruption events, and key takeaways in a single call. |
| Plain-language explanations of signal mechanisms and economic logic for each of the 58 predictive signals. Suitable for executive briefings, client reports, and AI agent reasoning chains. |
| EIA Short-Term Energy Outlook forward-looking projections — crude oil production, natural gas prices, electricity generation, renewable capacity, and more. Actual vs forecast comparison with 1,467 tracked series. |
| GDI risk direction, velocity, acceleration, and pillar-level momentum over 7/14/30/90-day windows. Detects regime changes and trend reversals before they show in the headline number. |
| Abnormal commodity price movement detection across 31 commodities. Flags unusual 24-hour changes that may signal supply disruptions, demand shifts, or speculative activity. |
| Port congestion trajectory and acceleration versus historical baselines at 26 global ports. Direction of change matters more than point-in-time score. |
| AI-generated hourly analytical briefs per supply chain dimension — energy, materials, transportation, macro, and manufacturing. Cross-pillar awareness with anti-hallucination safeguards. |
| Weekly 'Signal of the Week' content package — pre-written, data-verified marketing bundle with Substack article, LinkedIn post, and Twitter thread. |
Example Responses
supply_chain_risk_assessment
Global Disruption Index: 58.4
Data quality: GOOD
Needs attention: true
Last updated: 2026-04-04T14:30:00.000Z
Data provided by SupplyMaven | supplymaven.com/validationmanufacturing_output_indicator
Supply Maven Manufacturing Index (lower = stronger):
National: 44.2 — NORMAL
Regional Breakdown:
MISO: 41.3 (NORMAL)
ERCO: 38.7 (NORMAL)
PJM: 52.1 (BELOW TREND)
SWPP: 40.5 (NORMAL)
CISO: 46.8 (NORMAL)
ISNE: 44.9 (NORMAL)
NYIS: 48.2 (NORMAL)
NW: 43.1 (NORMAL)
Data provided by SupplyMaven | supplymaven.com/validationget_action_signals
Action Signals — 3 ACTIVE, 4 WATCH (7 total triggered):
[ACTIVE] Materials Stress -> WTI Crude Oil
GDI:Materials -> WTI Crude Oil | 1 week lead | 57% directional accuracy | current: 71 index | threshold: 65
[WATCH] Mid-Atlantic Manufacturing -> New Orders Lead
SMI:PJM (deterioration trigger) -> Manufacturing New Orders | 3 month lead | 78% directional accuracy | current: 63 SMI score | threshold: 66
Signal statuses: ACTIVE = threshold crossed, act now. WATCH = approaching threshold, prepare.
All signals validated via Granger causality (p<=0.01) with directional accuracy >=55%.
Data provided by SupplyMaven | supplymaven.com/validationget_border_delays
Border Crossing Delays (81 crossings):
Laredo (mexico): commercial delay=45 min
El Paso (mexico): commercial delay=32 min
Otay Mesa (mexico): commercial delay=28 min
Detroit (canada): commercial delay=12 min
Buffalo (canada): commercial delay=8 min
Avg delay: 22 min | High delay (>30min): 8 crossings | Critical (>60min): 2
Data provided by SupplyMaven | supplymaven.com/validationget_chokepoint_traffic
Maritime Chokepoint Traffic (8 chokepoints, aggregate score: 42.5):
Suez Canal: score=62.4 level=ELEVATED vessels=47 slow=5 stationary=2 avg_speed=8.2kn
Panama Canal: score=51.3 level=ELEVATED vessels=32 slow=3 stationary=1 avg_speed=6.8kn
Strait of Malacca: score=45.1 level=NORMAL vessels=89 slow=8 stationary=3 avg_speed=10.4kn
Strait of Hormuz: score=38.7 level=NORMAL vessels=41 slow=2 stationary=0 avg_speed=11.1kn
Data provided by SupplyMaven | supplymaven.com/validationUse Cases
Procurement AI Copilots — Your users ask "should we accelerate this copper order?" With SupplyMaven, your agent checks live materials stress, port congestion, validated commodity signals, and GDI pillar scores before answering with a defensible recommendation.
Trading and Quant Models — Government manufacturing reports come out monthly. The SMI updates hourly from EIA electricity demand data — the same physical signal that precedes manufacturing shifts by 6-24 hours. Commodity price signals with validated Granger lag times tell you which market to watch and when.
Enterprise Risk Dashboards — Embed live GDI scores, pillar breakdowns, and action signals in your internal tools. When the Transportation pillar spikes, the chatbot flags it before your logistics team sees the delay.
Logistics Routing Agents — Feed port congestion, border delays, chokepoint traffic, and air cargo disruption data into route optimization workflows.
Data Coverage
31 Commodities — Energy, metals, agriculture, industrial materials, semiconductor materials
26 Global Ports — US (LA, Long Beach, Houston, Savannah, NY/NJ), Asia (Shanghai, Singapore, Busan), Europe (Rotterdam, Hamburg, Antwerp)
80+ Border Crossings — US-Mexico and US-Canada commercial wait times from CBP
12 Maritime Chokepoints — Suez, Panama, Malacca, Hormuz, Bab el-Mandeb, and more
39 Airports — Major US and international cargo hubs with FAA status
8 US Energy Grid Regions — Real-time electricity demand from EIA
Trade Policy Tracking — Active tariffs, sanctions, and export controls
US Freight Rail — Train speed, dwell time, carloadings, intermodal from STB/AAR
Freight Transportation Index — BTS TSI, truck tonnage, waterborne freight
Energy Market Data — Crude, natural gas, retail fuel, refinery, storage, trade flows
Macroeconomic Indicators — FRED, PPI, Global Supply Chain Pressure Index, EIA STEO forecasts
Proprietary Indices
Global Disruption Index (GDI)
A 0-100 composite score quantifying overall supply chain disruption risk. Combines four weighted pillars — Transportation (30%), Energy (25%), Materials (25%), Macro (20%). Recalculates every 15 minutes. Higher = more risk.
Supply Maven Manufacturing Index (SMI)
A patent-pending index that measures US manufacturing activity by analyzing weather-normalized electricity demand across 8 power grid regions. Detects manufacturing output changes weeks before official government reports.
Validated Predictive Signals
58 Granger-causal signals tested at p<=0.01 with directional accuracy >=55%. Each signal has a known lag time (how far ahead it predicts) and is evaluated against live data every 15 minutes. Organized in 3 tiers by statistical confidence.
Get a free API key instantly at supplymaven.com/developers
Links
Website: supplymaven.com
Developer Portal: supplymaven.com/developers
API Documentation: supplymaven.com/developers/docs
MCP Endpoint:
https://supplymaven.com/api/mcpLLM Info: supplymaven.com/llms.txt
About
SupplyMaven is built by SupplyMaven, Inc.. The platform monitors over 200 data variables in real time, sourced from government agencies (EIA, USDA, CBP, BLS, Federal Reserve, FAA, NOAA), commodity markets, global vessel tracking (AIS/Datalastic), and news intelligence feeds.
SupplyMaven — Enterprise-grade supply chain intelligence for AI agents.
Available Tools
34 toolscommodity_price_monitorAInspect
Monitor real-time commodity prices and price volatility for supply chain cost management. Tracks 31 commodities across energy (WTI crude, Brent, natural gas, coal, ethanol), metals (copper, aluminum, nickel, zinc, lithium, cobalt, iron, titanium, uranium), agriculture (corn, wheat, soybeans, rice, cotton, lumber), industrial materials (rubber, polyethylene, PVC, polypropylene, soda ash), and semiconductor materials (germanium, gallium, indium, neodymium). Returns current price and 24-hour change percentage. Free tier covers 5 key commodities; paid tier covers all 31.
Inputs: no named parameters.
get_action_signalsAInspect
Get statistically validated leading indicator signals evaluated against live GDI and SMI data. Each signal is a Granger-causal relationship (p≤0.01) with a specific lag time and directional accuracy. Returns ACTIVE, WATCH, or CLEAR status for each signal. Paid tier only.
Inputs: no named parameters.
get_air_cargo_disruptionsAInspect
Get real-time air cargo disruption status at major US and international freight hub airports. Returns FAA ground delays, ground stops, arrival and departure delays with estimated minutes, closure status, disruption score, and traffic collapse detection. Covers major cargo hubs including Memphis (FedEx), Louisville (UPS), Anchorage, Chicago O'Hare, Los Angeles, Miami, New York JFK, and Dallas-Fort Worth. Used by air freight forwarders, express carriers, and logistics planners to reroute time-sensitive shipments around airport disruptions.
Inputs: no named parameters.
get_border_delaysAInspect
Get real-time commercial border crossing wait times at US-Mexico and US-Canada ports of entry. Returns current delay in minutes for commercial vehicles, number of lanes open, and port status. Updated every 30 minutes from US Customs and Border Protection. Covers all major commercial crossings including Laredo, El Paso, Nogales, Otay Mesa, Detroit, Buffalo, and Blaine. Used by logistics companies, freight brokers, and trucking operations to route cross-border shipments through the fastest crossing points.
Inputs: no named parameters.
get_chokepoint_trafficAInspect
Monitor real-time vessel traffic and congestion at critical maritime chokepoints — Suez Canal, Panama Canal, Strait of Malacca, Strait of Hormuz, Bab el-Mandeb, and other strategic waterways. Returns total vessel count, average speed, count of slow or stationary vessels, and a congestion score with severity level. When chokepoints congest or close, global shipping routes reroute within days — this data detects that signal in real time.
Inputs: no named parameters.
get_commodity_volatility_alertsAInspect
Get alerts for commodities experiencing abnormal price volatility. Flags any commodity where the 24-hour price change exceeds normal ranges or where prices are at extreme levels. Returns the current price, 24-hour change percentage, trend direction, and risk assessment. Answers 'which commodities are behaving unusually right now?' — a question that takes procurement teams hours to answer manually. Used by procurement teams to time purchases, commodity traders to identify opportunities, and supply chain managers to anticipate cost changes.
Inputs: no named parameters.
get_corridor_riskAInspect
Monitor risk levels across 10 major ocean freight trade corridors (China-US West Coast, China-US East Coast, China-Mexico, Taiwan-US, India-US, China-Europe, Europe-US, Middle East-Europe, Brazil-US). Each corridor chains origin ports, chokepoints, and destination ports into a single lane scored by its weakest link (highest risk waypoint). Scores combine real-time port congestion data with active natural disaster proximity. Used by logistics planners for route risk comparison, procurement teams for supply chain exposure assessment, and freight forwarders for disruption early warning.
Inputs: no named parameters.
get_customs_friction_baselineAInspect
Get customs friction baseline scores by country. Returns a composite 0-100 score combining port congestion (55% weight) and customs/trade policy events (45% weight). Covers 21 countries across North America, East Asia, Southeast Asia, South Asia, Europe, Middle East, and South America. Higher score = more friction. Optional country parameter for single-country detail with component breakdown and 30-day history. Used by trade compliance teams, procurement managers, and logistics planners to assess customs clearance risk by country.
Inputs: no named parameters.
get_customs_trade_eventsAInspect
Get customs and trade policy events extracted from news intelligence. Covers tariff changes, sanctions, export controls, trade agreements, anti-dumping duties, and regulatory changes. Each event includes affected countries, products, direction (RESTRICTIVE/LIBERALIZING/NEUTRAL/MIXED), US impact assessment, and confidence score. Used by trade compliance teams and procurement managers to track policy risk.
Inputs: no named parameters.
get_disaster_eventsAInspect
Get active natural disaster events that may impact supply chain operations. Sources: USGS (earthquakes M5.0+), NOAA (storms/hurricanes, US), GDACS (global earthquakes, tropical cyclones, floods, volcanoes). Returns event type, severity, location, coordinates, and affected country. Events auto-expire based on source TTL. Supports filtering by event type, country, region, and lookback window. Complements get_natural_disaster_alerts with additional filtering options including multi-day lookback and region-based geographic filtering.
Inputs: no named parameters.
get_economic_indicatorsAInspect
Get key economic indicators affecting supply chain costs and conditions. Returns Federal Reserve data (industrial production, capacity utilization, manufacturing PMI, housing starts, imports), Producer Price Index by category, Global Supply Chain Pressure Index (GSCPI) from the New York Fed, and EIA Short-Term Energy Outlook forecasts. Used by supply chain strategists, procurement leaders, and economic analysts who need the macro backdrop for supply chain planning.
Inputs: no named parameters.
get_energy_breakdownAInspect
Get comprehensive US energy market status for supply chain cost analysis. Returns crude oil prices (WTI and Brent), natural gas spot prices (Henry Hub), retail fuel prices (gasoline, diesel), natural gas storage versus capacity, refinery utilization rates, petroleum stock levels with week-over-week changes, and import/export flows. This is the disaggregated view behind the GDI Energy pillar — instead of a single risk number, you get the full picture of energy costs affecting manufacturing, freight, and logistics. Used by supply chain cost analysts, transportation managers, and energy procurement teams.
Inputs: no named parameters.
get_energy_forecastAInspect
Get the US Energy Information Administration's Short-Term Energy Outlook (STEO) — official government forecasts for energy production, consumption, and pricing. Returns both historical actuals and forward-looking projections for crude oil prices, natural gas prices, electricity generation, renewable energy production, and petroleum consumption. The STEO is the most widely referenced energy forecast in the world. Distinguishes actual historical data from projected forecasts using the isActual flag. Used by energy traders, logistics companies budgeting fuel costs, and macro analysts.
Inputs: no named parameters.
get_freight_rate_observationsAInspect
Get freight rate index observations extracted from news intelligence. Covers major ocean freight indexes (BDI, SCFI, WCI, CCFI, HARPEX) with direction, magnitude, trade lane, and rate values. Each observation includes confidence score and source URL. Used by logistics planners to track rate trends and identify cost pressure signals.
Inputs: no named parameters.
get_freight_rate_pressureAInspect
Returns freight rate pressure scores for major container shipping indices (WCI, SCFI). Includes current values, week-over-week changes, z-score vs 52-week baseline, and mapping to trade corridors. WCI (Drewry World Container Index) tracks Asia-Europe and transpacific container rates in USD/FEU. SCFI (Shanghai Containerized Freight Index) tracks export rates from Shanghai. Pressure scoring: 0-35 STABLE, 36-55 ELEVATED, 56-69 VOLATILE, 70-84 SURGING, 85-100 EXTREME. Use to assess freight cost pressure on specific trade lanes.
Inputs: no named parameters.
get_freight_transportation_indexAInspect
Get the US freight transportation health index from the Bureau of Transportation Statistics. Returns the Transportation Services Index (TSI) for freight and passenger, truck tonnage, rail carloadings, rail intermodal volume, waterborne freight, inventory-to-sales ratio, and industrial production index. Declining freight volumes are a leading indicator of economic slowdown. Used by logistics companies, freight brokers, and economic analysts tracking US freight demand trends.
Inputs: no named parameters.
get_gdi_trend_analysisAInspect
Get trend analysis of the Global Disruption Index over time. Returns the current GDI score plus 7-day, 14-day, and 30-day comparisons with direction, velocity of change, and pillar-level momentum. Identifies which pillar is driving changes and whether risk is accelerating or decelerating. Answers: 'Is supply chain risk getting better or worse, how fast, and why?' Used by supply chain executives for weekly status briefings and by traders to time entry/exit decisions around supply chain volatility.
Inputs: no named parameters.
get_intelligence_briefsAInspect
Get AI-generated intelligence briefs for each supply chain dimension — energy, materials, transportation, macro, and manufacturing. Each brief provides a narrative analysis of current conditions, key drivers, emerging risks, and recommended watch items. These are not raw data — they are synthesized analytical summaries generated every hour from live data. Designed for decision-makers who need a quick read on each supply chain dimension. Returns structured briefs suitable for executive dashboards, email digests, or Slack channels.
Inputs: no named parameters.
get_labor_actionsAInspect
Get labor actions affecting supply chains extracted from news intelligence. Covers strikes, lockouts, slowdowns, contract negotiations, and protests. Each event includes union, employer, location, worker count, affected ports, status, and impact description. Used by logistics planners and procurement teams to assess labor disruption risk at ports and manufacturing facilities.
Inputs: no named parameters.
get_manufacturing_anomaliesAInspect
Detect unusual electricity demand patterns that signal manufacturing disruptions before they appear in official reports. Monitors 8 US power grid regions (PJM, MISO, ERCOT, CAISO, SPP, ISNE, NYISO, NW) for demand anomalies — sudden drops indicate factory shutdowns, surges indicate production ramp-ups. Returns current SMI score with regional breakdown plus anomalies from the past 7 days ranked by severity. The Supply Manufacturing Index (SMI) uses patent-pending weather normalization to isolate industrial demand from weather-driven consumption. Used by commodity traders for early manufacturing signals and procurement teams to anticipate supply changes.
Inputs: no named parameters.
get_natural_disaster_alertsAInspect
Get real-time natural disaster alerts from USGS (earthquakes M5.0+), NOAA (hurricanes, tropical storms), and GDACS (global earthquakes, cyclones, floods, volcanoes). Returns active and recent events with magnitude, severity, coordinates, and affected country. Used by logistics planners and procurement teams to reroute shipments and activate contingency plans around seismic events, hurricanes, and floods affecting supply chain infrastructure.
Inputs: no named parameters.
get_port_congestion_trendsAInspect
Get port congestion trend analysis — not just current congestion, but direction and trajectory. Returns how congestion has changed relative to historical baselines, identifies ports where congestion is accelerating, and flags ports approaching critical thresholds. Answers: 'Which ports are getting worse and how fast?' Used by logistics planners to reroute shipments before congestion peaks, and by importers to anticipate lead time extensions.
Inputs: no named parameters.
get_port_disruption_indexAInspect
Get Port Readiness scores measuring land-side logistics conditions at major US ports. Scores 0-100 (higher = harder cargo hand-off). Covers rail terminal dwell, vessel congestion, highway incidents, truck availability, and weather. 7 nodes: LA/LB, NY/NJ, Savannah, Houston, Seattle/Tacoma, El Paso, Laredo.
Inputs: no named parameters.
get_predictive_signalsAInspect
Statistically validated leading indicator signals evaluated against live supply chain data. Each signal is a Granger-causal relationship tested at p<=0.01 with directional accuracy >=55%. Signals predict commodity price movements, manufacturing shifts, and macroeconomic changes 1 week to 6 months ahead. Returns ACTIVE (threshold crossed — act now), WATCH (approaching threshold — prepare), or CLEAR status for each signal. 58 signals across 3 tiers organized by predictor group (GDI pillars, SMI regions, cross-index spreads). Used by commodity traders for forward-looking positioning, procurement teams for buy/defer timing, and hedge funds for alternative data signals.
Inputs: no named parameters.
get_rail_freight_statusAInspect
Get US freight rail performance metrics including average train speed, terminal dwell time, cars on line, trains held per day, railcars not moved within 48 hours, total carloadings, intermodal units, and grain transport rates. Sourced from the Surface Transportation Board railroad service metrics, Association of American Railroads carloading data, and USDA grain transportation reports. When rail slows down, inland supply chains back up within days — this data provides early warning of freight bottlenecks across the US rail network.
Inputs: no named parameters.
get_signal_narrativesAInspect
Get plain-language explanations of active predictive signals. Each narrative explains the mechanism behind a signal — why the predictor leads the target, what economic logic connects them, and what the current reading implies. Designed for non-quantitative users who want to understand the 'why' behind each signal without reading F-statistics. Returns trigger context, predictor value, direction, and a narrative paragraph suitable for reports and briefings.
Inputs: no named parameters.
get_supply_chain_weekly_briefAInspect
Comprehensive weekly supply chain situation report combining all SupplyMaven data sources into an executive-level brief. Includes GDI score with pillar breakdown and trend, top disruption events with risk scores, manufacturing output status across 8 regions, commodity price movements, port congestion highlights, and active predictive signals. Designed to answer 'what happened this week in supply chains?' in a single call. Used by executives, procurement leaders, and supply chain managers for weekly risk reviews and stakeholder briefings.
Inputs: no named parameters.
get_trade_policy_impactsAInspect
Get active trade policy actions currently impacting supply chain risk — tariffs, sanctions, export controls, import restrictions, and regulatory changes. Unlike news alerts that expire after 72 hours, policy adjustments persist as long as the policy is in effect and continue to modify GDI risk scores. Each policy includes the affected GDI pillar, score modifier, effective date, and source event. Used by procurement teams navigating tariff exposure, compliance officers tracking sanctions, and supply chain strategists adapting sourcing to policy shifts.
Inputs: no named parameters.
get_weekly_content_packageAInspect
Get the weekly 'Signal of the Week' content package — a pre-written, data-verified marketing bundle generated every Monday from live SupplyMaven data. Returns a Substack article (~500 words), LinkedIn post (~200 words), and Twitter/X thread (4-5 tweets), all built from verified supply chain data. Every number in the content traces back to a live data source. Designed for automated content distribution via Claude Desktop + platform MCP servers. The content package includes the signal headline, full data context (GDI, SMI, commodities, ports, signals), and platform-specific formatted content ready for publishing.
Inputs: no named parameters.
manufacturing_output_indicatorAInspect
Detect US manufacturing output changes up to 24 hours before official government reports. The patent-pending Supply Manufacturing Index (SMI) analyzes weather-normalized electricity demand across 8 US power grid regions (MISO/Midwest, ERCOT/Texas, PJM/Mid-Atlantic, CISO/California, ISNE/New England, NYIS/New York, SWPP/Central, NW/Pacific Northwest) to isolate real industrial activity from seasonal heating and cooling noise. Returns regional and national manufacturing activity scores, trend direction, and comparison to official Federal Reserve Industrial Production (INDPRO) data. INVERTED scale: lower = stronger manufacturing. 0-35 STRONG, 36-50 NORMAL, 51-65 BELOW TREND, 66+ WEAK. Used by commodity traders, economic analysts, and hedge funds as a leading manufacturing indicator.
Inputs: no named parameters.
port_congestion_monitorAInspect
Monitor real-time port congestion and vessel traffic at 26 major global ports. Returns vessel counts at berth and at anchor, congestion score versus historical baseline, and port status. Covers US ports (Los Angeles, Long Beach, Savannah, Houston, New York/New Jersey, Charleston, Oakland, Seattle, Tacoma), Asian ports (Shanghai, Singapore, Busan, Ningbo, Shenzhen, Hong Kong), and European ports (Rotterdam, Hamburg, Antwerp, Felixstowe, Piraeus). Used by freight forwarders, logistics teams, and importers to monitor delays, plan routing, and anticipate lead time changes.
Inputs: no named parameters.
risk_pillar_breakdownAInspect
Get detailed breakdown of supply chain disruption risk by category. Returns individual scores for each GDI pillar — Transportation (port congestion, border delays, freight weather), Energy (petroleum, natural gas, electricity, fuel prices), Materials (31 commodity prices with volatility), and Macro (Federal Reserve indicators, Producer Price Index). Each pillar includes its score, trend direction, and the specific data points driving the current reading. Essential for supply chain managers who need to diagnose which risk category is elevated and why.
Inputs: no named parameters.
supply_chain_disruption_alertsAInspect
Get real-time supply chain disruption alerts from global news intelligence and event detection. Returns categorized alerts for port closures, trade policy changes, tariff actions, natural disasters, labor strikes, sanctions, commodity shortages, and weather disruptions. Each alert includes severity level, affected supply chain stage (sourcing, manufacturing, logistics, distribution), and risk score. Free tier returns critical-severity alerts only; paid tier returns all severities.
Inputs: no named parameters.
supply_chain_risk_assessmentAInspect
Assess current global supply chain disruption risk. Returns the Global Disruption Index (GDI) — a real-time composite score from 0-100 measuring disruption across transportation, energy, materials, and macroeconomic pillars. Higher scores indicate greater supply chain risk. Built from 200+ live data variables including port congestion at 26 global ports, commodity prices for 31 assets, US border crossing delays, manufacturing output from 8 power grid regions, and Federal Reserve economic indicators. Used by procurement teams, logistics planners, commodity traders, and supply chain managers for real-time supply chain visibility and risk monitoring.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 34 tools
While most tools have distinct purposes, there is some overlap between tools like `commodity_price_monitor` and `get_commodity_volatility_alerts`, and between `get_disaster_events` and `get_natural_disaster_alerts`. However, descriptions clarify their different focuses, so ambiguity is minimal.
Naming conventions are mixed: many tools follow a `get_` prefix pattern, but several others use noun-first names like `commodity_price_monitor` or `port_congestion_monitor`. This inconsistency could cause minor confusion, but the names are still descriptive enough.
With 34 tools, the server is comprehensive but slightly heavy. Each tool justifies its existence by covering a specific data point or analysis, but the set could be streamlined without losing functionality. Still, the scope of supply chain monitoring warrants this many tools.
The toolset is remarkably complete for a supply chain risk monitoring API. It covers commodities, ports, borders, chokepoints, rail, air cargo, freight rates, economic indicators, manufacturing, disasters, policy, predictive signals, and synthesized briefs. No obvious gaps are apparent for the stated domain.
Maintenance
Related MCP Connectors
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 102 tools.
Ocean & multimodal freight intelligence: rates, landed cost, transit, customs, risk, ship decisions
Agent-ready economic, market & geo-health intelligence — 317 MCP tools, 309 driver-backed indices.
Port delay exposure with p50/p90 confidence intervals, demurrage impact and a free public feed.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceOcean container shipping intelligence for AI agents — D\&D tariffs, freight rates, vessel schedules, port congestion, inland haulage across 6 major carriers. 24 MCP tools.1MIT
- AlicenseAqualityDmaintenanceOcean and multimodal freight intelligence suite providing cross-validated rates, total landed cost, transit reliability, customs, risk, emissions, and unified ship decisions through 47 tools.4719 npmMIT
- AlicenseNot gradedqualityDmaintenanceAgent-ready economic, market & geo-health intelligence — 163 MCP tools, 155 driver-backed indices.MIT
- 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-