Supplymaven MCP Server

What SupplyMaven-SCR/supplymaven-mcp-server does

SupplyMaven-SCR/supplymaven-mcp-server exposes live supply chain intelligence to MCP-compatible clients. Its data includes a Global Disruption Index (GDI), a 0–100 composite measure built from transportation, energy, materials, and macroeconomic inputs. The service also provides detailed pillar scores, trends, alerts, and analytical summaries.

Coverage spans 31 commodities, 26 major ports, US commercial border crossings, strategic maritime chokepoints, air cargo hubs, freight rail, energy markets, trade policy, economic indicators, and natural disasters. Additional tools analyze ocean freight corridors, freight-rate observations, customs events, labor actions, commodity volatility, and port congestion trends.

How it works

The server is hosted at https://supplymaven.com/api/mcp and uses Streamable HTTP. Clients authenticate with a bearer token in the request headers. A free key is available through SupplyMaven's developer site, while paid tiers unlock additional tools and broader data coverage.

Responses are intended for both direct lookup and agent workflows. For example, an agent can combine the GDI with pillar details to diagnose elevated risk, compare corridor scores to identify a safer lane, or inspect port, border, rail, and air-cargo conditions when planning a shipment. The weekly brief and intelligence brief tools turn current observations into structured summaries for reviews and dashboards.

Several tools return time-aware analysis rather than point-in-time values. GDI trend analysis compares seven-, 14-, and 30-day periods; port trend analysis identifies acceleration against historical baselines; and predictive-signal tools report ACTIVE, WATCH, or CLEAR states. Signal results are based on Granger-causal relationships tested against live supply chain data, with lag and directional-accuracy details where applicable.

Setup and configuration

Add the remote MCP endpoint to a client that supports HTTP MCP connections. Claude Desktop and Claude Code use a server entry with the endpoint and an Authorization header:

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

Cursor and VS Code use the same URL and bearer header with an HTTP server configuration. Programmatic clients can connect through an MCP transport using the endpoint; the documented Vercel AI SDK example uses its SSE transport option. Tokens use the sm_free_* or sm_live_* format.

Tools and capabilities

The tool set supports:

• GDI assessment, pillar breakdowns, historical trend analysis, and weekly situation briefs.
• Commodity prices, abnormal-volatility alerts, energy data, and EIA energy forecasts.
• Port congestion, congestion trends, border wait times, chokepoint traffic, corridor risk, rail performance, freight indexes, and air-cargo disruptions.
• Disruption alerts, natural-disaster events, trade-policy impacts, customs events, labor actions, and freight-rate observations.
• Predictive signal status, signal explanations, AI-generated intelligence briefs, and a weekly content package.

Free access includes the GDI assessment, selected commodity prices, and critical disruption alerts. Higher tiers add broader monitoring and predictive analysis.

Limitations and notes

Data availability depends on the subscription tier. Free commodity monitoring covers five key commodities, while broader commodity coverage requires a paid tier; free disruption alerts are limited to critical severity. Predictive signals and several analytical tools are paid-tier capabilities.

A GDI composite is withheld when fewer than three pillars have a measurement in the current cycle. Individual unavailable pillars include a reason. The manufacturing output and manufacturing anomaly tools are described as unavailable in the current tool listing.

The service focuses on live and recent supply chain conditions, with coverage concentrated on the regions, assets, ports, crossings, and indicators supported by its data sources.