# SupplyMaven-SCR/supplymaven-mcp-server [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/SupplyMaven-SCR/supplymaven-mcp-server  
**GitHub Stars:** 1  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/supplymaven-scr-supplymaven-mcp-server

## Description
Real-time supply chain risk intelligence for AI agents. 25 tools across 3 tiers: Global Disruption Index, Manufacturing Index, commodity prices, port congestion, border delays, chokepoints, air cargo, trade policy, energy, rail, freight, economic indicators, predictive signals, and AI intelligence briefs.

## Tools
Capabilities this server exposes over MCP:

- **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.
- **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.
- **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.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "supplymaven-mcp-server": {
    "url": "https://supplymaven.com/api/mcp"
  }
}
```

## Documentation

## What SupplyMaven-SCR/supplymaven-mcp-server MCP server does

SupplyMaven-SCR/supplymaven-mcp-server MCP server gives AI clients access to live supply chain intelligence through MCP. Its data spans 31 commodities, 26 global ports, more than 80 North American border crossings, maritime chokepoints, air cargo hubs, freight activity, energy markets, economic indicators, natural disasters, labor actions, and customs events.

The service also exposes composite and derived measures. The Global Disruption Index scores overall supply chain risk from 0 to 100 across Transportation, Energy, Materials, and Macro pillars. Other tools provide manufacturing output and anomaly indicators, port readiness, corridor risk, customs friction, freight-rate pressure, and trend analysis. Predictive signal tools classify indicators as ACTIVE, WATCH, or CLEAR and cover possible changes in commodity prices, manufacturing, and macroeconomic conditions.

## How it works

The server is hosted at `https://supplymaven.com/api/mcp` and uses Streamable HTTP. Clients send a bearer token in the `Authorization` header. The endpoint can be connected from MCP-compatible applications or used programmatically with MCP client libraries.

Capabilities are organized into service tiers. The free tier includes the core risk assessment, commodity monitoring, and disruption-alert tools, with limits such as five commodities and critical alerts only. Pro adds operational, transportation, economic, and market detail, while the Enterprise signal tier adds predictive analysis, briefs, narratives, forecasts, and related tools. The available response scope therefore depends on the API key and subscription tier.

## Setup and configuration

Configure the hosted endpoint in the MCP client's server settings and provide a bearer token. The README shows keys using the `sm_free_` or `sm_live_` prefixes and directs users to SupplyMaven's developer page to obtain a key. Claude Desktop and Cursor examples use a URL plus an `Authorization` header; ChatGPT/OpenAI Agents use the same endpoint with Streamable HTTP. The README also identifies programmatic use with the Vercel AI SDK, LangChain, and CrewAI.

SupplyMaven-SCR/supplymaven-mcp-server MCP server does not require installing a local package based on the supplied setup instructions. Connect to the hosted URL instead.

## Tools and capabilities

Notable tool groups include:

- Overall risk: GDI assessment, pillar breakdown, trend direction, velocity, acceleration, and momentum.
- Physical flow monitoring: port congestion, border waits, chokepoint traffic, air cargo disruptions, rail freight, freight indexes, and ocean corridor risk.
- Market and policy data: commodity prices, energy breakdowns and forecasts, freight rates, tariffs, sanctions, export controls, customs events, and economic indicators.
- Event detection: disruption alerts, natural disasters, labor actions, disaster-event filtering, port disruption, and manufacturing anomalies.
- Analysis and reporting: predictive signals, signal narratives, weekly supply chain briefs, intelligence briefs, and manufacturing indicators.

## Limitations and notes

The service is not uniformly free. Several tools are marked Pro or Enterprise, and some free tools have narrower coverage. The README describes the endpoint as requiring bearer authentication, so it is not an anonymous MCP service. Data freshness and coverage vary by source: for example, border data is described as updating every 30 minutes, while other tools use live feeds, historical windows, forecasts, or news intelligence. Claims about predictive signals, proprietary indices, and manufacturing indicators describe the service's supplied methodology; users should evaluate those outputs for their own operational or investment decisions.

_Full upstream README: https://allmcps.com/mcp/supplymaven-scr-supplymaven-mcp-server/readme_