Koskamo

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.

SupplyMaven MCP logo, by SupplyMavenCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-06Published by SupplyMaven
MCP endpoint (Streamable HTTP)
https://supplymaven.com/api/mcp
Vendor documentation

What its tools do

34 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

34 of 34 have a description · 0 of 34 declare behavior hints · 1 of 1 with parameters document them all

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

Community listingRegistry 4.0.1

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
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  }
}

Tools

34 advertised

supply_chain_risk_assessment
Advertised by the server during the last successful anonymous check.

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.

supply_chain_risk_assessment input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
risk_pillar_breakdown
Advertised by the server during the last successful anonymous check.

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.

risk_pillar_breakdown input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
manufacturing_output_indicator
Advertised by the server during the last successful anonymous check.

Not available. The SupplyMaven Manufacturing Index is not currently offered; this tool returns a plain not-available response.

manufacturing_output_indicator input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
commodity_price_monitor
Advertised by the server during the last successful anonymous check.

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.

commodity_price_monitor input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
port_congestion_monitor
Advertised by the server during the last successful anonymous check.

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.

port_congestion_monitor input schema
{
  "type": "object",
  "properties": {}
}
port_congestion_monitor annotations
{
  "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
Advertised by the server during the last successful anonymous check.

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.

supply_chain_disruption_alerts input schema
{
  "type": "object",
  "properties": {}
}
supply_chain_disruption_alerts annotations
{
  "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
Advertised by the server during the last successful anonymous check.

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.

get_action_signals input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
get_border_delays
Advertised by the server during the last successful anonymous check.

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.

get_border_delays input schema
{
  "type": "object",
  "properties": {}
}
get_border_delays annotations
{
  "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
Advertised by the server during the last successful anonymous check.

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.

get_chokepoint_traffic input schema
{
  "type": "object",
  "properties": {}
}
get_chokepoint_traffic annotations
{
  "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
Advertised by the server during the last successful anonymous check.

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.

get_air_cargo_disruptions input schema
{
  "type": "object",
  "properties": {}
}
get_air_cargo_disruptions annotations
{
  "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
Advertised by the server during the last successful anonymous check.

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.

get_trade_policy_impacts input schema
{
  "type": "object",
  "properties": {}
}
get_trade_policy_impacts annotations
{
  "pillar": {
    "type": "string",
    "description": "Filter by affected GDI pillar: 'transportation', 'energy', 'materials', 'macro'."
  }
}
get_energy_breakdown
Advertised by the server during the last successful anonymous check.

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.

get_energy_breakdown input schema
{
  "type": "object",
  "properties": {}
}
get_energy_breakdown annotations
{
  "sector": {
    "type": "string",
    "description": "Filter: 'crude', 'naturalgas', 'fuel', 'refinery', 'storage', 'trade'. Default: summary of all."
  }
}
get_rail_freight_status
Advertised by the server during the last successful anonymous check.

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.

get_rail_freight_status input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
get_freight_transportation_index
Advertised by the server during the last successful anonymous check.

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.

get_freight_transportation_index input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
get_economic_indicators
Advertised by the server during the last successful anonymous check.

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.

get_economic_indicators input schema
{
  "type": "object",
  "properties": {}
}
get_economic_indicators annotations
{
  "category": {
    "type": "string",
    "description": "Filter: 'fred', 'ppi', 'gscpi', 'steo'. Default: summary of all."
  }
}
get_natural_disaster_alerts
Advertised by the server during the last successful anonymous check.

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.

get_natural_disaster_alerts input schema
{
  "type": "object",
  "properties": {}
}
get_natural_disaster_alerts annotations
{
  "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
Advertised by the server during the last successful anonymous check.

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.

get_corridor_risk input schema
{
  "type": "object",
  "properties": {}
}
get_corridor_risk annotations
{
  "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
Advertised by the server during the last successful anonymous check.

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.

get_predictive_signals input schema
{
  "type": "object",
  "properties": {}
}
get_predictive_signals annotations
{
  "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
Advertised by the server during the last successful anonymous check.

Not available. The SupplyMaven Manufacturing Index is not currently offered; this tool returns a plain not-available response.

get_manufacturing_anomalies input schema
{
  "type": "object",
  "properties": {}
}
get_manufacturing_anomalies annotations
{
  "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
Advertised by the server during the last successful anonymous check.

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.

get_supply_chain_weekly_brief input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
get_signal_narratives
Advertised by the server during the last successful anonymous check.

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.

get_signal_narratives input schema
{
  "type": "object",
  "properties": {}
}
get_signal_narratives annotations
{
  "signalId": {
    "type": "string",
    "description": "Specific signal ID (e.g. 'SIG-1'). If omitted, returns narratives for all active signals."
  }
}
get_energy_forecast
Advertised by the server during the last successful anonymous check.

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.

get_energy_forecast input schema
{
  "type": "object",
  "properties": {}
}
get_energy_forecast annotations
{
  "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
Advertised by the server during the last successful anonymous check.

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.

get_gdi_trend_analysis input schema
{
  "type": "object",
  "properties": {}
}
get_gdi_trend_analysis annotations
{
  "period": {
    "type": "string",
    "description": "Trend period: '7d', '14d', '30d', '90d'. Default: '30d'."
  }
}
get_commodity_volatility_alerts
Advertised by the server during the last successful anonymous check.

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.

get_commodity_volatility_alerts input schema
{
  "type": "object",
  "properties": {}
}
get_commodity_volatility_alerts annotations
{
  "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
Advertised by the server during the last successful anonymous check.

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.

get_port_congestion_trends input schema
{
  "type": "object",
  "properties": {}
}
get_port_congestion_trends annotations
{
  "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
Advertised by the server during the last successful anonymous check.

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.

get_intelligence_briefs input schema
{
  "type": "object",
  "properties": {}
}
get_intelligence_briefs annotations
{
  "type": {
    "type": "string",
    "description": "Brief type: 'energy', 'materials', 'transport', 'macro'. Omit for all briefs."
  }
}
get_weekly_content_package
Advertised by the server during the last successful anonymous check.

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.

get_weekly_content_package input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
get_freight_rate_observations
Advertised by the server during the last successful anonymous check.

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.

get_freight_rate_observations input schema
{
  "type": "object",
  "properties": {}
}
get_freight_rate_observations annotations
{
  "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
Advertised by the server during the last successful anonymous check.

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.

get_customs_trade_events input schema
{
  "type": "object",
  "properties": {}
}
get_customs_trade_events annotations
{
  "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
Advertised by the server during the last successful anonymous check.

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.

get_labor_actions input schema
{
  "type": "object",
  "properties": {}
}
get_labor_actions annotations
{
  "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
Advertised by the server during the last successful anonymous check.

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.

get_freight_rate_pressure input schema
{
  "type": "object",
  "properties": {}
}
get_freight_rate_pressure annotations
{
  "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
Advertised by the server during the last successful anonymous check.

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.

get_customs_friction_baseline input schema
{
  "type": "object",
  "properties": {}
}
get_customs_friction_baseline annotations
{
  "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
Advertised by the server during the last successful anonymous check.

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.

get_disaster_events input schema
{
  "type": "object",
  "properties": {}
}
get_disaster_events annotations
{
  "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
Advertised by the server during the last successful anonymous check.

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.

get_data_center_hub_load input schema
{
  "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

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

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.

Too few checks for a percentage yet (2 of 2 answered).

  1. 2026-11-06: 1 of 1 checks answered
  2. 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.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http supplymaven-mcp https://supplymaven.com/api/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add supplymaven-mcp --url https://supplymaven.com/api/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable supplymaven-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "supplymaven-mcp": {
      "url": "https://supplymaven.com/api/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "supplymaven-mcp": {
      "type": "streamableHttp",
      "url": "https://supplymaven.com/api/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start supplymaven-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "supplymaven-mcp": {
      "type": "http",
      "url": "https://supplymaven.com/api/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http supplymaven-mcp https://supplymaven.com/api/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://supplymaven.com/api/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "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.