Supplymaven MCP Server

What SupplyMaven-SCR/supplymaven-mcp-server MCP server does

SupplyMaven-SCR/supplymaven-mcp-server MCP server gives AI clients access to live supply chain intelligence through MCP. Its data spans 31 commodities, 26 global ports, more than 80 North American border crossings, maritime chokepoints, air cargo hubs, freight activity, energy markets, economic indicators, natural disasters, labor actions, and customs events.

The service also exposes composite and derived measures. The Global Disruption Index scores overall supply chain risk from 0 to 100 across Transportation, Energy, Materials, and Macro pillars. Other tools provide manufacturing output and anomaly indicators, port readiness, corridor risk, customs friction, freight-rate pressure, and trend analysis. Predictive signal tools classify indicators as ACTIVE, WATCH, or CLEAR and cover possible changes in commodity prices, manufacturing, and macroeconomic conditions.

How it works

The server is hosted at https://supplymaven.com/api/mcp and uses Streamable HTTP. Clients send a bearer token in the Authorization header. The endpoint can be connected from MCP-compatible applications or used programmatically with MCP client libraries.

Capabilities are organized into service tiers. The free tier includes the core risk assessment, commodity monitoring, and disruption-alert tools, with limits such as five commodities and critical alerts only. Pro adds operational, transportation, economic, and market detail, while the Enterprise signal tier adds predictive analysis, briefs, narratives, forecasts, and related tools. The available response scope therefore depends on the API key and subscription tier.

Setup and configuration

Configure the hosted endpoint in the MCP client's server settings and provide a bearer token. The README shows keys using the sm_free_ or sm_live_ prefixes and directs users to SupplyMaven's developer page to obtain a key. Claude Desktop and Cursor examples use a URL plus an Authorization header; ChatGPT/OpenAI Agents use the same endpoint with Streamable HTTP. The README also identifies programmatic use with the Vercel AI SDK, LangChain, and CrewAI.

SupplyMaven-SCR/supplymaven-mcp-server MCP server does not require installing a local package based on the supplied setup instructions. Connect to the hosted URL instead.

Tools and capabilities

Notable tool groups include:

• Overall risk: GDI assessment, pillar breakdown, trend direction, velocity, acceleration, and momentum.
• Physical flow monitoring: port congestion, border waits, chokepoint traffic, air cargo disruptions, rail freight, freight indexes, and ocean corridor risk.
• Market and policy data: commodity prices, energy breakdowns and forecasts, freight rates, tariffs, sanctions, export controls, customs events, and economic indicators.
• Event detection: disruption alerts, natural disasters, labor actions, disaster-event filtering, port disruption, and manufacturing anomalies.
• Analysis and reporting: predictive signals, signal narratives, weekly supply chain briefs, intelligence briefs, and manufacturing indicators.

Limitations and notes

The service is not uniformly free. Several tools are marked Pro or Enterprise, and some free tools have narrower coverage. The README describes the endpoint as requiring bearer authentication, so it is not an anonymous MCP service. Data freshness and coverage vary by source: for example, border data is described as updating every 30 minutes, while other tools use live feeds, historical windows, forecasts, or news intelligence. Claims about predictive signals, proprietary indices, and manufacturing indicators describe the service's supplied methodology; users should evaluate those outputs for their own operational or investment decisions.