Metadata-Version: 2.4
Name: supply-chain-mcp-server
Version: 0.1.0
Summary: MCP server for global supply chain and trade data: UN Comtrade, World Bank trade statistics, import/export analysis
Project-URL: Homepage, https://github.com/AiAgentKarl/supply-chain-mcp-server
Project-URL: Repository, https://github.com/AiAgentKarl/supply-chain-mcp-server
License: MIT
Keywords: comtrade,export,import,logistics,mcp,supply-chain,trade
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# supply-chain-mcp-server

MCP server giving AI agents access to global supply chain and trade data. Powered by UN Comtrade, World Bank, and Open Supply Hub — all free APIs.

## Data Sources
- **UN Comtrade** — 200+ countries, 5000+ product categories, 50+ years of data
- **World Bank Trade Statistics** — GDP, trade ratios, development indicators
- **Open Supply Hub** — Global factory/supplier database

## Tools

| Tool | Description |
|------|-------------|
| `get_trade_flow` | Import/export data between countries by product category |
| `get_top_trade_partners` | Ranking of a country's most important trade partners |
| `get_supply_chain_risk` | Risk analysis for critical products (semiconductors, rare earths, etc.) |
| `get_country_trade_stats` | General trade statistics for a country (World Bank) |
| `search_suppliers_by_country` | Find manufacturers/suppliers by country and sector |

## Installation

```bash
pip install supply-chain-mcp-server
```

## Usage with Claude Desktop

```json
{
  "mcpServers": {
    "supply-chain": {
      "command": "supply-chain-mcp-server"
    }
  }
}
```

## Example Queries

- "What is Germany's supply chain risk for semiconductors?"
- "Show me the top 10 trade partners of the USA for imports"
- "What are China's biggest export markets?"
- "Find electronics manufacturers in Vietnam"
- "Analyze the supply chain risk for rare earth elements"

## Use Cases
- **Procurement agents**: Identify suppliers and alternative sources
- **Risk analysis**: Detect critical dependencies before they become crises
- **Market intelligence**: Track trade flow trends
- **ESG research**: Supplier transparency via Open Supply Hub

## License
MIT
