MCP Server for AI Agents

Supply Chain Intelligence for Every AI Workflow

Connect any MCP-compatible AI agent to real-time supply chain risk data. Claude, ChatGPT, Cursor, and any agent that speaks the Model Context Protocol can query SupplyMaven directly.

The only MCP server providing validated predictive supply chain signals — not just raw data, but statistically tested leading indicators with known lag times and directional accuracy. Data comes from EIA, FRED, CBP, NOAA, global vessel tracking, and commodity markets.

Free API Key — No Credit Card

Get instant access to the GDI composite score, national SMI, 5 commodity prices, and critical alerts. 100 requests per day, forever free. Enter your email and your key generates immediately.

Already subscribed?

Manage API keys in Settings

Quick Start

Claude Desktop / Claude Code

Add to your MCP server configuration (Settings > MCP Servers in Claude Desktop, or ~/.claude.json for Claude Code):

{
  "mcpServers": {
    "supplymaven": {
      "url": "https://supplymaven.com/api/mcp",
      "headers": {
        "Authorization": "Bearer sm_free_your_key_here"
      }
    }
  }
}

Paid keys use the same format: Bearer sm_live_...

ChatGPT / OpenAI Agents

Endpoint: https://supplymaven.com/api/mcp
Transport: Streamable HTTP
Auth: 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();
// 25 supply chain intelligence tools ready

Test with cURL

curl -X POST https://supplymaven.com/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

Use Cases

Procurement AI Copilots

Your users ask "should we accelerate this copper order before tariffs hit?" Right now your agent guesses.

With SupplyMaven, it checks live materials stress, port congestion at origin, validated commodity signals, and GDI pillar scores before answering. The agent gives a defensible recommendation backed by real data — not a hallucination.

Trading and Quant Models

Government manufacturing reports come out monthly. Your model is flying blind between releases.

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

Your ERP chatbot gets asked "what's our supply chain exposure this week?" and returns a generic answer.

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 in shipment tracking.

Available Tools

supply_chain_risk_assessment

Free tier

Global Disruption Index (GDI) composite score. 0-100, higher = more risk. Built from 200+ live data variables. Updated every 15 minutes.

Free tier: Rounded to nearest 5, 24h delayed

risk_pillar_breakdown

Pro

Detailed breakdown by risk category — Transportation, Energy, Materials, and Macro pillars with weights and news boost values.

manufacturing_output_indicator

Free tier

Patent-pending Supply Manufacturing Index (SMI). Detects US manufacturing output changes up to 24 hours before official government reports. Weather-adjusted electricity demand across 8 US grid regions.

Free tier: National composite only, rounded

commodity_price_monitor

Free tier

Real-time prices for 31 commodities across energy, metals, agriculture, industrial, and semiconductor materials.

Free tier: 5 of 31 commodities

port_congestion_monitor

Pro

Vessel counts, congestion scores, and port status at 26 major global ports. US, Asian, and European coverage.

supply_chain_disruption_alerts

Free tier

Real-time disruption alerts from global news intelligence — port closures, tariffs, sanctions, weather, labor strikes, and more.

Free tier: Critical severity only

get_action_signalsNew

Pro

Statistically validated leading indicator signals evaluated against live 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. Unique to SupplyMaven.

get_border_delaysNew

Pro

Real-time US-Mexico and US-Canada commercial border crossing wait times. Updated every 30 minutes from CBP. 80+ crossings.

get_chokepoint_trafficNew

Pro

Maritime chokepoint vessel traffic — Suez Canal, Panama Canal, Strait of Malacca, Strait of Hormuz, and more. Congestion scores and vessel counts.

get_air_cargo_disruptionsNew

Pro

Air cargo disruption status at 39 US and international airports. FAA ground delays, ground stops, disruption scores, and traffic collapse detection.

get_trade_policy_impactsNew

Pro

Active tariffs, sanctions, export controls, and policy changes impacting supply chain risk. Persists beyond news cycle — shows ongoing GDI score impact.

get_energy_breakdownNew

Pro

Disaggregated US energy market data — crude oil, natural gas, retail fuel, refinery utilization, storage levels, and petroleum trade flows.

get_rail_freight_statusNew

Pro

US freight rail performance — train speed, terminal dwell time, carloadings, intermodal units, and grain transport rates from STB/AAR/USDA.

get_freight_transportation_indexNew

Pro

BTS Transportation Services Index, truck tonnage, rail carloadings, waterborne freight, and inventory-to-sales ratio.

get_economic_indicatorsNew

Pro

FRED economic data, Producer Price Index, NY Fed GSCPI, and EIA STEO energy forecasts. The macro backdrop for supply chain planning.

get_predictive_signalsNew

Signal

58 Granger-causal leading indicators with ACTIVE/WATCH/CLEAR status. Predicts commodity prices, manufacturing shifts, and macro changes 1 week to 6 months ahead. Filter by tier, status, or predictor group.

get_manufacturing_anomaliesNew

Signal

Electricity demand anomaly detection across 8 US grid regions. Patent-pending weather normalization isolates industrial demand. Current SMI + 7-day anomaly history ranked by severity.

get_supply_chain_weekly_briefNew

Signal

Executive-level weekly situation report. Combines GDI pillar scores, SMI, port congestion, active signals, top disruption events, and key takeaways in a single call.

get_signal_narrativesNew

Signal

Plain-language explanations of active predictive signals. Mechanism, economic logic, and implications for non-quantitative users. Suitable for reports and briefings.

get_energy_forecastNew

Signal

EIA Short-Term Energy Outlook — official government forecasts for crude oil, natural gas, electricity, and more. Historical actuals + forward-looking projections.

get_gdi_trend_analysisNew

Signal

GDI trend over time with direction, velocity, acceleration, and pillar-level momentum. Answers: is risk getting better or worse, how fast, and why?

get_commodity_volatility_alertsNew

Signal

Flags commodities with abnormal 24h price movements. Answers: which commodities are behaving unusually right now?

get_port_congestion_trendsNew

Signal

Port congestion trajectory analysis — deviation from baseline, acceleration detection. Answers: which ports are getting worse and how fast?

get_intelligence_briefsNew

Signal

AI-generated hourly analytical briefs per supply chain dimension. Energy, materials, transport, macro, and manufacturing summaries for executive dashboards.

Pricing Tiers

Free (Email Registration)

GDI composite score (rounded, delayed 24h)
National SMI composite (rounded)
5 key commodity prices
Critical-severity alerts only
100 requests per day

Already have a key?

Get your free key above

Pro ($499/month)

Exact real-time GDI score
All 4 pillar scores with weights and news boosts
All 8 regional SMI scores
All 31 commodity prices
26-port congestion data
All severity disruption alerts
Border crossing delays — 80+ crossings
Maritime chokepoint traffic
Air cargo disruptions — 39 airports
Trade policy impacts
Energy breakdown — crude, gas, fuel, refinery, storage
Rail freight + transportation index
Economic indicators — FRED, PPI, GSCPI, STEO
Action signals — 36 validated leading indicators
Dashboard access included
10,000 requests per day

Subscribe to Pro

Signal ($999/month)

Everything in Pro, plus:
58 Granger-causal predictive signals
Signal narratives — plain-language explanations
Manufacturing anomaly detection
EIA energy forecasts (STEO)
GDI trend analysis with velocity tracking
Commodity volatility alerts
Port congestion trend analysis
AI intelligence briefs (hourly)
Weekly executive situation brief
25,000 requests per day

For commodity traders, hedge funds, and procurement teams who need forward-looking intelligence.

Subscribe to Signal

What makes get_action_signals different

Validated predictive signals — not just real-time data

Every other supply chain API gives you current readings. SupplyMaven gives you statistically validated lead relationships — signals where the predictor has been shown to Granger-cause the target at a specific lag with measured directional accuracy, tested across hundreds of observations.

GDI:Materials → WTI Crude

1 week lead | 57% directional accuracy | 375 weekly observations | p<0.01 | unidirectional

SMI:PJM deterioration → New Orders

3 month lead | 78% directional accuracy | 9 confirmed episodes | conditional trigger

SMI:National → Nickel

60 day lead | 66% directional accuracy | 87 monthly observations | SC:HOLDS

When a signal crosses its threshold, the API returns ACTIVE status, the current reading vs. threshold, and the evidence basis. Your agent can surface this in a procurement recommendation, a risk briefing, or a trading model without any additional validation work on your end.

Developer Resources

API Pro Response Preview — get_action_signals

> 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

  [ACTIVE] Macro Stress → Gallium
    GDI:Macro → Gallium | 1 week lead | 55% directional accuracy | current: 68 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. WATCH = approaching.
All signals validated via Granger causality (p≤0.01), directional accuracy ≥55%.

View Full API DocumentationAuthentication, rate limits, response formats, and full endpoint reference

Implementation Support

API Pro subscribers get direct access to implementation support from a 25-year supply chain systems architect. Integration planning, data model mapping, webhook configuration, and custom alerting pipelines.

Response within 1 business day. Available to API Pro subscribers.

Data Sources

All data comes from verified institutional sources. No surveys, no sentiment scores, no self-reported supplier questionnaires.

US Energy Information Administration (EIA)

Federal Reserve Economic Data (FRED)

US Customs & Border Protection (CBP)

NOAA / Aviation Weather Center

Datalastic — Global Vessel Tracking

Commodities-API — 50+ Markets

GNews — Supply Chain Intelligence

38 Global Ports Monitored Daily

Frequently Asked Questions

What is MCP?

Model Context Protocol (MCP) is an open standard backed by Anthropic, GitHub, and Microsoft that lets AI agents connect to external data sources and tools. Any MCP-compatible agent — Claude, ChatGPT, Cursor, custom agents — can query SupplyMaven automatically without any custom integration code.

What makes the action signals different from the raw scores?

Raw scores tell you the current state. Action signals tell you what is likely to change and when. Each signal is a Granger-causal relationship tested across hundreds of observations — meaning the predictor has been statistically shown to lead the target at a specific lag. When a signal goes ACTIVE, it means the current reading has crossed a threshold that historically preceded a move in the target variable.

What gets exposed through the MCP server?

Only final computed scores, prices, and signal statuses. The proprietary formulas, regression coefficients, baseline calibrations, and raw intermediate data stay entirely in the backend. The MCP server is a window into results, not into the methodology.

How fresh is the data?

Electricity demand (SMI): hourly. Commodity prices: every 3 hours. Port congestion: multiple times daily. GDI composite: recalculates every 15 minutes. FRED economic indicators: on their publication schedule. Action signals: re-evaluated every GDI recalculation cycle.

Do I need a credit card for the free tier?

No. Enter your email above and your free API key is generated instantly. The free tier is permanent — 100 requests per day, no time limit.

Is there a rate limit?

Free tier: 100 requests per day. Pro: 10,000 per day. Signal: 25,000 per day. Contact support for enterprise volume requirements.

Questions? support@supplymaven.com

Get Free API Key Subscribe to Pro Subscribe to Signal API Documentation