supplymaven-mcp-server

# 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: ```json { "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_here ``` ### Cursor / VS Code ```json { "mcpServers": { "supplymaven": { "type": "http", "url": "https://supplymaven.com/api/mcp", "headers": { "Authorization": "Bearer sm_free_your_key_here" } } } } ``` ### Programmatic (Vercel AI SDK, LangChain, CrewAI) ```javascript 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 ready ``` ### Any 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](https://supplymaven.com/developers) --- ## Available Tools (34) ### Free Tier — No credit card, get a key instantly | Tool | Description | |------|-------------| | `supply_chain_risk_assessment` | **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. | | `commodity_price_monitor` | Real-time prices for 31 commodities across energy, metals, agriculture, industrial, and semiconductor materials. Free tier: 5 key commodities. | | `supply_chain_disruption_alerts` | 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 | |------|-------------| | `manufacturing_output_indicator` | **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. | | `risk_pillar_breakdown` | Individual GDI pillar scores for Transportation, Energy, Materials, and Macro with weights and news boost breakdown. | | `port_congestion_monitor` | Vessel counts, congestion scores, and port status at 26 major global ports across US, Asia, and Europe. | | `get_action_signals` | **Validated predictive signals** — Granger-causal leading indicators (p<=0.01) evaluated against live data. ACTIVE/WATCH/CLEAR status with directional accuracy and lag times. | | `get_border_delays` | Real-time US-Mexico and US-Canada commercial border crossing wait times. 80+ crossings updated every 30 minutes from CBP. | | `get_chokepoint_traffic` | Maritime chokepoint vessel traffic — Suez Canal, Panama Canal, Strait of Malacca, Strait of Hormuz, and other strategic waterways. | | `get_air_cargo_disruptions` | Air cargo disruption status at 39 US and international airports. FAA ground delays, ground stops, disruption scores, and traffic collapse detection. | | `get_trade_policy_impacts` | Active tariffs, sanctions, export controls, and policy changes impacting supply chain risk. Persists beyond news cycle — shows ongoing GDI score impact. | | `get_energy_breakdown` | Disaggregated US energy market data — crude oil, natural gas, retail fuel, refinery utilization, storage levels, and petroleum trade flows. | | `get_rail_freight_status` | US freight rail performance — train speed, terminal dwell time, carloadings, intermodal units, and grain transport rates from STB/AAR/USDA. | | `get_freight_transportation_index` | BTS Transportation Services Index, truck tonnage, rail carloadings, rail intermodal, waterborne freight, and inventory-to-sales ratio. | | `get_economic_indicators` | FRED economic data, Producer Price Index, NY Fed Global Supply Chain Pressure Index, and EIA STEO energy forecasts. | | `get_natural_disaster_alerts` | Real-time natural disaster alerts from USGS, NOAA, and GDACS. Earthquakes, hurricanes, floods, volcanoes with severity and coordinates. | | `get_corridor_risk` | Risk levels across 10 ocean freight trade corridors. Weakest-link scoring chains ports and chokepoints into end-to-end lane risk. | | `get_freight_rate_observations` | Freight rate index observations (BDI, SCFI, WCI, CCFI, HARPEX) with direction, magnitude, and trade lane context. | | `get_customs_trade_events` | Customs and trade policy events — tariffs, sanctions, export controls. Direction (RESTRICTIVE/LIBERALIZING) and US impact assessment. | | `get_labor_actions` | Labor actions affecting supply chains — strikes, lockouts, slowdowns, contract negotiations with affected ports and status. | | `get_freight_rate_pressure` | Freight rate pressure scores for WCI and SCFI. Z-score vs 52-week baseline mapped to 0-100 with corridor mapping. | | `get_customs_friction_baseline` | Per-country customs friction baseline (0-100) combining port congestion and trade policy events. 21 countries. | | `get_disaster_events` | Active natural disaster events with geographic and type filtering. Region-based filtering and multi-day lookback. | | `get_port_disruption_index` | 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 | |------|-------------| | `get_predictive_signals` | **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. | | `get_manufacturing_anomalies` | 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. | | `get_supply_chain_weekly_brief` | **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. | | `get_signal_narratives` | 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. | | `get_energy_forecast` | 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. | | `get_gdi_trend_analysis` | 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. | | `get_commodity_volatility_alerts` | Abnormal commodity price movement detection across 31 commodities. Flags unusual 24-hour changes that may signal supply disruptions, demand shifts, or speculative activity. | | `get_port_congestion_trends` | Port congestion trajectory and acceleration versus historical baselines at 26 global ports. Direction of change matters more than point-in-time score. | | `get_intelligence_briefs` | AI-generated hourly analytical briefs per supply chain dimension — energy, materials, transportation, macro, and manufacturing. Cross-pillar awareness with anti-hallucination safeguards. | | `get_weekly_content_package` | 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/validation ``` ### `manufacturing_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/validation ``` ### `get_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/validation ``` ### `get_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/validation ``` ### `get_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/validation ``` --- ## Use 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](https://supplymaven.com/developers) --- ## Links - **Website:** [supplymaven.com](https://supplymaven.com) - **Developer Portal:** [supplymaven.com/developers](https://supplymaven.com/developers) - **API Documentation:** [supplymaven.com/developers/docs](https://supplymaven.com/developers/docs) - **MCP Endpoint:** `https://supplymaven.com/api/mcp` - **LLM Info:** [supplymaven.com/llms.txt](https://supplymaven.com/llms.txt) --- ## About SupplyMaven is built by [SupplyMaven, Inc.](https://supplymaven.com). 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.*