MCP Server for AI Agents

Supply Chain Intelligence for Every AI Workflow

Connect any MCP-compatible AI agent to real-time supply chain risk data. No API key required for the free tier. Claude, ChatGPT, Cursor, and any agent that speaks the Model Context Protocol can query SupplyMaven directly.

SupplyMaven is the only MCP server providing real-time supply chain disruption intelligence. The data comes from government agencies (EIA, FRED, CBP, NOAA), global vessel tracking, and commodity markets — not surveys or estimates.

Quick Start

Claude Desktop / Claude Code

Add this 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"
    }
  }
}

No API key needed for free tier. For paid access, add "headers": {"Authorization": "Bearer sm_live_..."}

ChatGPT / OpenAI Agents

Use the MCP endpoint URL when configuring an external tool source in the OpenAI platform or ChatGPT App Directory:

Endpoint: https://supplymaven.com/api/mcp
Transport: Streamable HTTP
Auth: None (free tier) or Bearer token (paid)

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();
// 7 supply chain intelligence tools ready to use

Test 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}'

Available Tools

get_supply_chain_riskFree tier

Global Disruption Index (GDI) composite score. 0-100, higher = more risk.

Free tier limitation: Rounded to nearest 5

get_pillar_scoresPaid only

Individual scores for Energy (25%), Materials (25%), Transportation (30%), and Macro (20%) pillars.

get_manufacturing_indexFree tier

Patent-pending Supply Manufacturing Index (SMI). Weather-adjusted electricity demand across 8 US grid regions. 6-24h early warning of manufacturing shifts.

Free tier limitation: National composite only, rounded

get_commodity_pricesFree tier

Spot prices for tracked commodities across energy, metals, agriculture, and industrial categories.

Free tier limitation: 5 of 50+ commodities

get_port_congestionPaid only

Vessel counts, congestion scores, and stationary vessel ratios for 38 global ports.

get_disruption_alertsFree tier

News-driven supply chain disruption alerts scored by severity and routed to GDI pillars.

Free tier limitation: Critical severity only

get_sector_demandPaid only

Industrial vs. commercial electricity demand ratios across 8 US grid regions. Reveals data center growth contamination.

Free Tier vs. API Pro

Free (No Key Required)

GDI composite score (rounded, delayed 24h)
National SMI composite (rounded)
5 key commodity prices
Critical-severity alerts only
100 requests per day

API Pro ($499/month)

Exact real-time GDI score
All 5 pillar scores with weights
All 8 regional SMI scores
50+ commodity prices
38-port congestion data
All severity alerts
Sector demand breakdown
10,000 requests per day

Data Sources

All data comes from verified institutional sources. No surveys, no sentiment, no self-reported supplier questionnaires.

US Energy Information Administration (EIA)

Federal Reserve (FRED)

US Customs & Border Protection

NOAA / Aviation Weather

Datalastic (Vessel Tracking)

Commodities-API (50+ Markets)

GNews (Supply Chain Alerts)

38 Global Ports Monitored

Use Cases

Procurement AI Copilots

Your AI assistant checks supply chain risk before generating purchase orders. "Should we accelerate this order?" gets answered with real data, not guesswork.

Trading & Quant Models

Manufacturing activity signals up to 24 hours ahead of government reports. Commodity price feeds and port congestion data for systematic strategies.

Enterprise Risk Dashboards

Embed real-time GDI scores in internal tools. When your ERP chatbot is asked "what's our supply chain exposure?" it answers with live data.

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. Any MCP-compatible agent can query SupplyMaven automatically.

Do I need an API key?

No. The free tier works with no authentication. Just point your MCP client at supplymaven.com/api/mcp and start querying. API Pro keys are available for full real-time access.

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?

Electricity demand: hourly. Commodity prices: every 3 hours. Port congestion: multiple times daily. FRED economic indicators: on their publication schedule. The GDI recalculates whenever new data arrives from any pillar.

Is there a rate limit?

Free tier: 100 requests per day. API Pro: 10,000 per day. Enterprise plans available for higher volumes.

Questions? Reach out at support@supplymaven.com

Subscribe to API Pro Learn About SupplyMaven