SupplyMaven MCP
SupplyMaven MCP provides real-time supply chain risk intelligence, monitoring 200+ data variables to produce proprietary indices like the Global Disruption Index. It offers tools for assessing supply chain risks, analyzing maritime chokepoints, tracking commodity prices, and accessing predictive signals for AI agents.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://supplymaven.com/api/mcpWhat its tools do
34 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Not annotated (34)
supply_chain_risk_assessmentrisk_pillar_breakdownmanufacturing_output_indicatorcommodity_price_monitorport_congestion_monitorsupply_chain_disruption_alertsget_action_signalsget_border_delaysget_chokepoint_trafficget_air_cargo_disruptionsget_trade_policy_impactsget_energy_breakdownget_rail_freight_statusget_freight_transportation_indexget_economic_indicatorsget_natural_disaster_alertsget_corridor_riskget_predictive_signalsget_manufacturing_anomaliesget_supply_chain_weekly_briefget_signal_narrativesget_energy_forecastget_gdi_trend_analysisget_commodity_volatility_alertsget_port_congestion_trendsget_intelligence_briefsget_weekly_content_packageget_freight_rate_observationsget_customs_trade_eventsget_labor_actionsget_freight_rate_pressureget_customs_friction_baselineget_disaster_eventsget_data_center_hub_load
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Assess global supply chain disruption risk using the Global Disruption Index
- Monitor maritime chokepoints and transit-based scoring for key canals and straits
- Track commodity prices and freight rail performance metrics
- Access predictive signals for anomaly detection and trend analysis
Source and maintenance
Protocol and capabilities
- Server
- supplymaven 4.0.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 34 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": true
}
}Tools
34 advertised
supply_chain_risk_assessment
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, 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. A pillar with no measurement this cycle is reported as unavailable with the reason, and the composite is withheld when fewer than three pillars are measured.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}risk_pillar_breakdown
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. A pillar with no measurement this cycle is reported as unavailable with the reason, and the composite is withheld when fewer than three pillars are measured.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}manufacturing_output_indicator
Not available. The SupplyMaven Manufacturing Index is not currently offered; this tool returns a plain not-available response.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}commodity_price_monitor
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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}port_congestion_monitor
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.
{
"type": "object",
"properties": {}
}{
"region": {
"type": "string",
"description": "Filter by geographic region or ISO country code. Valid regions: north_america, south_america, europe_west, europe_east, east_asia, southeast_asia, south_asia, middle_east, africa. Or use a 2-letter ISO country code (e.g., US, CN, DE)."
}
}supply_chain_disruption_alerts
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.
{
"type": "object",
"properties": {}
}{
"region": {
"type": "string",
"description": "Filter by geographic region or ISO country code. Matches articles by affectedEntryPoints (approximate — articles without geographic metadata are excluded). Valid regions: north_america, south_america, europe_west, europe_east, east_asia, southeast_asia, south_asia, middle_east, africa. Or use a 2-letter ISO country code (e.g., US, CN, DE)."
}
}get_action_signals
Get statistically validated leading indicator signals evaluated against live GDI 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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}get_border_delays
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.
{
"type": "object",
"properties": {}
}{
"border": {
"type": "string",
"description": "Filter by border: 'mexico' or 'canada'. Default: both."
},
"region": {
"type": "string",
"description": "Filter by geographic region or ISO country code. US=all borders, MX=Mexican border, CA=Canadian border. Valid regions: north_america, south_america, europe_west, europe_east, east_asia, southeast_asia, south_asia, middle_east, africa. Or use a 2-letter ISO country code (e.g., US, CN, DE)."
},
"crossing": {
"type": "string",
"description": "Specific crossing name (e.g., 'Laredo', 'El Paso')."
}
}get_chokepoint_traffic
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.
{
"type": "object",
"properties": {}
}{
"region": {
"type": "string",
"description": "Filter by geographic region or ISO country code. Valid regions: north_america, south_america, europe_west, europe_east, east_asia, southeast_asia, south_asia, middle_east, africa. Or use a 2-letter ISO country code (e.g., US, CN, DE)."
},
"chokepoint": {
"type": "string",
"description": "Chokepoint name (e.g., 'suez', 'panama', 'malacca'). Default: all."
}
}get_air_cargo_disruptions
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.
{
"type": "object",
"properties": {}
}{
"region": {
"type": "string",
"description": "Filter by geographic region or ISO country code. Valid regions: north_america, south_america, europe_west, europe_east, east_asia, southeast_asia, south_asia, middle_east, africa. Or use a 2-letter ISO country code (e.g., US, CN, DE)."
},
"airport": {
"type": "string",
"description": "IATA airport code (e.g., 'MEM', 'SDF', 'ORD'). Default: all monitored hubs."
}
}get_trade_policy_impacts
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, 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.
{
"type": "object",
"properties": {}
}{
"pillar": {
"type": "string",
"description": "Filter by affected GDI pillar: 'transportation', 'energy', 'materials', 'macro'."
}
}get_energy_breakdown
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.
{
"type": "object",
"properties": {}
}{
"sector": {
"type": "string",
"description": "Filter: 'crude', 'naturalgas', 'fuel', 'refinery', 'storage', 'trade'. Default: summary of all."
}
}get_rail_freight_status
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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}get_freight_transportation_index
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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}get_economic_indicators
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.
{
"type": "object",
"properties": {}
}{
"category": {
"type": "string",
"description": "Filter: 'fred', 'ppi', 'gscpi', 'steo'. Default: summary of all."
}
}get_natural_disaster_alerts
Get real-time natural disaster 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). 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.
{
"type": "object",
"properties": {}
}{
"type": {
"type": "string",
"description": "Filter by event type: 'earthquake', 'hurricane', 'typhoon', 'tropical_storm', 'flood', 'volcano'. Default: all types."
},
"region": {
"type": "string",
"description": "Filter by ISO country code (e.g., 'US', 'JP', 'TW') or country name. Default: all regions."
},
"active_only": {
"type": "boolean",
"description": "Only return currently active events. Default: true."
}
}get_corridor_risk
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 port congestion data with the proximity of active natural disruptions. Used by logistics planners for route risk comparison, procurement teams for supply chain exposure assessment, and freight forwarders for disruption early warning.
{
"type": "object",
"properties": {}
}{
"region": {
"type": "string",
"description": "Filter corridors by origin or destination region. Valid regions: north_america, south_america, europe_west, europe_east, east_asia, southeast_asia, south_asia, middle_east, africa. Or use a 2-letter ISO country code (e.g., US, CN, DE)."
},
"corridor_id": {
"type": "string",
"description": "Specific corridor ID (e.g., CN-US-WEST, CN-EU, IN-US). Omit for all corridors. Returns full waypoint breakdown when specified."
}
}get_predictive_signals
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 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, organized by predictor group (GDI pillars, commodities and commercial demand). Used by commodity traders for forward-looking positioning, procurement teams for buy/defer timing, and hedge funds for alternative data signals.
{
"type": "object",
"properties": {}
}{
"tier": {
"type": "number",
"description": "Filter by signal tier (1=highest confidence, 2=moderate, 3=exploratory). Omit for all tiers."
},
"group": {
"type": "string",
"description": "Filter by predictor group (e.g. 'GDI:Energy', 'GDI:Materials'). Omit for all groups."
},
"status": {
"type": "string",
"description": "Filter by current status: TRIGGERED, PENDING, or CLEAR. Omit for all statuses."
}
}get_manufacturing_anomalies
Not available. The SupplyMaven Manufacturing Index is not currently offered; this tool returns a plain not-available response.
{
"type": "object",
"properties": {}
}{
"region": {
"type": "string",
"description": "Filter by grid region: PJM, MISO, ERCO, CISO, SWPP, ISNE, NYIS, NW. Omit for all regions."
},
"minSeverity": {
"type": "string",
"description": "Minimum anomaly severity: LOW, MEDIUM, HIGH, or CRITICAL. Default: MEDIUM."
}
}get_supply_chain_weekly_brief
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, 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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}get_signal_narratives
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.
{
"type": "object",
"properties": {}
}{
"signalId": {
"type": "string",
"description": "Specific signal ID (e.g. 'SIG-1'). If omitted, returns narratives for all active signals."
}
}get_energy_forecast
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.
{
"type": "object",
"properties": {}
}{
"category": {
"type": "string",
"description": "Filter by category: 'prices', 'petroleum', 'natural_gas', 'electricity', 'macro'. Omit for priority series across all categories."
},
"forecast_only": {
"type": "boolean",
"description": "If true, returns only projected data points (not historical actuals). Default: false."
}
}get_gdi_trend_analysis
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.
{
"type": "object",
"properties": {}
}{
"period": {
"type": "string",
"description": "Trend period: '7d', '14d', '30d', '90d'. Default: '30d'."
}
}get_commodity_volatility_alerts
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.
{
"type": "object",
"properties": {}
}{
"category": {
"type": "string",
"description": "Filter by category: 'energy', 'metals', 'agriculture', 'industrial', 'semiconductors'. Omit for all."
},
"threshold": {
"type": "number",
"description": "Minimum absolute 24h change percentage to flag (e.g. 2.0 for 2%+). Default: 2.0."
}
}get_port_congestion_trends
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.
{
"type": "object",
"properties": {}
}{
"port": {
"type": "string",
"description": "Port name (e.g. 'Shanghai', 'Los Angeles'). Omit for all ports with significant changes."
},
"region": {
"type": "string",
"description": "Filter by geographic region or ISO country code. Valid regions: north_america, south_america, europe_west, europe_east, east_asia, southeast_asia, south_asia, middle_east, africa. Or use a 2-letter ISO country code (e.g., US, CN, DE)."
},
"threshold": {
"type": "number",
"description": "Minimum distance, in score points, of a port's congestion score from 50 (the score at its own baseline) to report. Default: 10."
}
}get_intelligence_briefs
Get AI-generated intelligence briefs for each supply chain dimension — energy, materials, transportation, macro. 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.
{
"type": "object",
"properties": {}
}{
"type": {
"type": "string",
"description": "Brief type: 'energy', 'materials', 'transport', 'macro'. Omit for all briefs."
}
}get_weekly_content_package
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, commodities, ports, signals), and platform-specific formatted content ready for publishing.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}get_freight_rate_observations
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.
{
"type": "object",
"properties": {}
}{
"direction": {
"type": "string",
"description": "Filter by rate direction: UP, DOWN, STABLE, or MIXED."
},
"index_name": {
"type": "string",
"description": "Filter by index name (e.g., BDI, SCFI, WCI)."
}
}get_customs_trade_events
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.
{
"type": "object",
"properties": {}
}{
"limit": {
"type": "number",
"description": "Max results to return (default 50, max 200)."
},
"direction": {
"type": "string",
"description": "Filter by policy direction: RESTRICTIVE, LIBERALIZING, NEUTRAL, or MIXED."
},
"event_type": {
"type": "string",
"description": "Filter by event type (e.g., TARIFF_INCREASE, SANCTION, EXPORT_CONTROL, TRADE_AGREEMENT)."
}
}get_labor_actions
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.
{
"type": "object",
"properties": {}
}{
"status": {
"type": "string",
"description": "Filter by status: ACTIVE, THREATENED, RESOLVED, or ONGOING."
},
"action_type": {
"type": "string",
"description": "Filter by action type: STRIKE, LOCKOUT, SLOWDOWN, CONTRACT_NEGOTIATION, CONTRACT_RATIFICATION, PROTEST, or OTHER."
}
}get_freight_rate_pressure
Returns freight rate pressure scores for major shipping and commodity indices (WCI, SCFI, BDI, CRB). Includes current values, week-over-week changes, z-score vs 52-week baseline, and mapping to trade corridors. WCI (Drewry World Container Index) tracks container rates in USD/FEU. SCFI (Shanghai Containerized Freight Index) tracks export rates from Shanghai. BDI (Baltic Dry Index) tracks dry bulk shipping rates. CRB (CRB Commodity Index) tracks broad commodity pressure. Pressure scoring: 0-35 STABLE, 36-55 ELEVATED, 56-69 VOLATILE, 70-84 SURGING, 85-100 EXTREME.
{
"type": "object",
"properties": {}
}{
"region": {
"type": "string",
"description": "Filter corridor mapping by region. Pressure scores are global but corridor mapping filters to corridors touching this region. Valid regions: north_america, south_america, europe_west, europe_east, east_asia, southeast_asia, south_asia, middle_east, africa. Or use a 2-letter ISO country code (e.g., US, CN, DE)."
},
"index_name": {
"type": "string",
"description": "Filter by index: 'WCI', 'SCFI', 'BDI', or 'CRB'. Omit for all."
}
}get_customs_friction_baseline
Get customs friction baseline scores by country. Returns a composite 0-100 score combining port congestion and customs/trade policy events. 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.
{
"type": "object",
"properties": {}
}{
"region": {
"type": "string",
"description": "Filter by region when listing all countries. Valid regions: north_america, south_america, europe_west, europe_east, east_asia, southeast_asia, south_asia, middle_east, africa. Or use a 2-letter ISO country code (e.g., US, CN, DE)."
},
"country": {
"type": "string",
"description": "ISO 2-letter country code (e.g., 'CN', 'MX', 'IN'). Returns detailed breakdown with component scores and 30-day history. Omit for all 21 countries."
}
}get_disaster_events
Get active natural disaster events that may impact supply chain operations. Sources: USGS (earthquakes M5.0+), NOAA (storms/hurricanes, US), NHC (tropical cyclones, Atlantic and eastern and central Pacific), 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.
{
"type": "object",
"properties": {}
}{
"days": {
"type": "number",
"description": "Number of days to look back. Default 7, max 30. When specified, includes both active and expired events within the window."
},
"type": {
"type": "string",
"description": "Filter by event type: 'earthquake', 'storm', 'flood', 'volcano'. Omit for all types."
},
"region": {
"type": "string",
"description": "Filter by region. Events are matched by their country field. Valid regions: north_america, south_america, europe_west, europe_east, east_asia, southeast_asia, south_asia, middle_east, africa. Or use a 2-letter ISO country code (e.g., US, CN, DE)."
},
"country": {
"type": "string",
"description": "ISO 2-letter country code to filter by affected country (e.g., 'US', 'JP', 'TW')."
}
}get_data_center_hub_load
Grid load for five US data center hub zones, built from EIA-930 hourly demand and delivered as daily or monthly series. Hubs: DOM (Dominion Virginia Power zone, PJM), NCEN (North Central, ERCOT), CE (Commonwealth Edison zone, PJM), PGAE (Pacific Gas and Electric, CAISO), ZONJ (New York City, NYISO). Daily rows: date, average MW, overnight floor MW (the day's minimum hour), zone hours, matched hours, status, and share of the parent grid. Monthly rows: average MW, overnight floor MW, share of parent, trailing 12-month average and overnight floor with their growth on the trailing 12 months a year earlier, and the count of complete days each figure used. Basis: EIA-930 hourly demand; UTC calendar days and months; days with fewer than 20 reported zone hours excluded; revisions not applied to the zone series. Signal tier.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"hub": {
"type": "string",
"description": "Hub zone code: DOM, NCEN, CE, PGAE or ZONJ."
},
"endDate": {
"type": "string",
"description": "Daily: YYYY-MM-DD (default the latest stored day; at most 366 days per request). Monthly: YYYY-MM (default the latest UTC month that has ended)."
},
"startDate": {
"type": "string",
"description": "Daily: YYYY-MM-DD (default 30 days before endDate). Monthly: YYYY-MM (default 24 months before endDate)."
},
"granularity": {
"type": "string",
"description": "'daily' or 'monthly'. Default monthly."
}
}
}Prompts
Not advertised
Resources
Not advertised
90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-06: 1 of 1 checks answered
- 2026-11-07: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 644 ms
- 95th percentile latency
- 644 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 644 ms · metadata changed · 34 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http supplymaven-mcp https://supplymaven.com/api/mcpCodex
codex mcp add supplymaven-mcp --url https://supplymaven.com/api/mcpCursor
{
"mcpServers": {
"supplymaven-mcp": {
"url": "https://supplymaven.com/api/mcp"
}
}
}Cline
{
"mcpServers": {
"supplymaven-mcp": {
"type": "streamableHttp",
"url": "https://supplymaven.com/api/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"supplymaven-mcp": {
"type": "http",
"url": "https://supplymaven.com/api/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http supplymaven-mcp https://supplymaven.com/api/mcpClaude Desktop
https://supplymaven.com/api/mcpWindsurf
{
"mcpServers": {
"supplymaven-mcp": {
"serverUrl": "https://supplymaven.com/api/mcp"
}
}
}Let your agent find its tools
Find servers like SupplyMaven MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.