MCP Server for AI Agents
The Professional Standard for Supply Chain Intelligence.
Connect any MCP-compatible agent (Claude, ChatGPT, Cursor, or custom) to live supply chain risk data sourced 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, 5 commodity prices, and critical alerts. Forever free. Enter your email and your key generates immediately.
Already subscribed?
Manage API keys in SettingsNo credit card. Instant access.
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();
// 33 supply chain intelligence tools readyTest 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, and GDI pillar scores before answering. The agent gives a defensible recommendation backed by real data — not a hallucination.
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 and pillar breakdowns in your internal tools. When the Transportation pillar spikes, the chatbot flags it before your logistics team sees the delay in shipment tracking.
Why SupplyMaven?
| Factor | Traditional APIs | SupplyMaven |
|---|---|---|
| Data Source | Surveys & Sentiment | Current Grid Demand & Logistics Flow |
| Utility | Static Dashboard | Live MCP Server for AI Agents |
Available Tools
supply_chain_risk_assessmentGlobal 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_breakdownDetailed breakdown by risk category — Transportation, Energy, Materials, and Macro pillars.
commodity_price_monitorPrices for commodities across energy, metals, agriculture, industrial, and semiconductor materials.
Free tier: 5 commodities
port_congestion_monitorVessel counts, congestion scores, and port status at major global ports. US, Asian, and European coverage.
supply_chain_disruption_alertsDisruption alerts from global news intelligence: port closures, tariffs, sanctions, weather, labor strikes, and more.
Free tier: Critical severity only
get_border_delaysNewCurrent US-Mexico and US-Canada commercial border crossing wait times. Updated every 30 minutes from CBP. 80+ crossings.
get_chokepoint_trafficNewMaritime chokepoint vessel traffic — Suez Canal, Panama Canal, Strait of Malacca, Strait of Hormuz, and more. Congestion scores and vessel counts.
get_air_cargo_disruptionsNewAir cargo disruption status at 39 US and international airports. FAA ground delays, ground stops, disruption scores, and traffic collapse detection.
get_trade_policy_impactsNewActive tariffs, sanctions, export controls, and policy changes impacting supply chain risk. Persists beyond news cycle — shows ongoing GDI score impact.
get_energy_breakdownNewDisaggregated US energy market data — crude oil, natural gas, retail fuel, refinery utilization, storage levels, and petroleum trade flows.
get_rail_freight_statusNewUS freight rail performance — train speed, terminal dwell time, carloadings, intermodal units, and grain transport rates from STB/AAR/USDA.
get_freight_transportation_indexNewBTS Transportation Services Index, truck tonnage, rail carloadings, waterborne freight, and inventory-to-sales ratio.
get_economic_indicatorsNewFRED economic data, Producer Price Index, NY Fed GSCPI, and EIA STEO energy forecasts. The macro backdrop for supply chain planning.
get_natural_disaster_alertsNewNatural disruption alerts from USGS (earthquakes M5.0+), NOAA (hurricanes, tropical storms), NHC (tropical cyclone centres, Atlantic and eastern and central Pacific), and GDACS (global earthquakes, cyclones, floods, volcanoes). Active and recent events with magnitude, severity, coordinates, and affected country.
get_corridor_riskNewRisk levels across 10 major ocean freight trade corridors. Each corridor chains origin ports, chokepoints, and destination ports into a single lane score with weakest-link detection.
get_freight_rate_observationsNewFreight 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.
get_customs_trade_eventsNewCustoms and trade policy events extracted from news intelligence — tariff changes, sanctions, export controls, trade agreements, anti-dumping duties, and regulatory changes with affected countries and direction.
get_labor_actionsNewLabor actions affecting supply chains — strikes, lockouts, slowdowns, contract negotiations, and protests. Union, employer, location, worker count, affected ports, and status.
get_freight_rate_pressureNewFreight rate pressure scores for major shipping and commodity indices (WCI, SCFI, BDI, CRB). Current values, week-over-week changes, z-score vs 52-week baseline, and trade corridor mapping.
get_customs_friction_baselineNewCustoms friction baseline scores by country. Composite 0-100 score combining port congestion and customs/trade policy events across 21 countries. Higher score = more friction.
get_disaster_eventsNewActive natural disruption events that may impact supply chain operations. USGS, NOAA, NHC and GDACS sources with filtering by event type, country, region, and lookback window.
get_supply_chain_weekly_briefNewExecutive-level weekly situation report. Combines GDI pillar scores, port congestion, top disruption events, and key takeaways in a single call.
get_energy_forecastNewEIA Short-Term Energy Outlook — official government forecasts for crude oil, natural gas, electricity, and more. Historical actuals + forward-looking projections.
get_gdi_trend_analysisNewGDI 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_alertsNewFlags commodities with abnormal 24h price movements. Answers: which commodities are behaving unusually right now?
get_port_congestion_trendsNewPort congestion trajectory analysis — deviation from baseline, acceleration detection. Answers: which ports are getting worse and how fast?
get_intelligence_briefsNewAI-generated hourly analytical briefs per supply chain dimension. Energy, materials, transport, and macro summaries for executive dashboards.
Developer Resources
View Full API DocumentationAuthentication, rate limits, response formats, and full endpoint referenceImplementation Support
Designed and operated by an Enterprise Architect with 25 years of supply chain systems experience. API Pro subscribers get direct implementation support — integration planning, data model mapping, 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
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 gets exposed through the MCP server?
Only final computed scores and prices. 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?
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 — no time limit.
Is there a rate limit?
Rate limits scale by tier. Specific limits are communicated at key provisioning. Contact support for enterprise volume requirements.
Questions? support@supplymaven.com
Join the technical leaders already validating regional divergence via our MCP server.