{
  "markdown": "# mcp-sputnikx-market\n\n[![npm](https://img.shields.io/npm/v/mcp-sputnikx-market)](https://www.npmjs.com/package/mcp-sputnikx-market)\n[![MCP](https://img.shields.io/badge/MCP-compatible-blue)](https://modelcontextprotocol.io)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n\nMCP server for **SputnikX** — EU trade intelligence, customs analytics, salary data, agent identity, and commerce API. Connect any AI assistant to 63M+ Eurostat records via [Model Context Protocol](https://modelcontextprotocol.io).\n\n## Data Sources\n\n| Source | Records | Coverage | Update |\n|--------|---------|----------|--------|\n| **Eurostat COMEXT** | 63M+ | EU27, 260 partners, HS2-CN8, 2005-2025 | Monthly |\n| **Latvia Customs** | 15M+ | KN8-level, declarations, 2005-2025 | Monthly |\n| **EU Salary** | 70K+ | 44 countries, 21 NACE sectors, AI risk scores | Annual |\n| **Fusion Engine** | Cross-source | Trade + Customs + Salary + Macro (ECB/FRED) | Real-time |\n| **SoulLedger** | 130K+ agents | Trust scoring, behavioral DNA, ERC-8004 | Real-time |\n\n## Quick Start\n\n### Claude Desktop\n\n```json\n{\n  \"mcpServers\": {\n    \"sputnikx\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-sputnikx-market\"],\n      \"env\": {\n        \"SPUTNIKX_API_KEY\": \"sk_live_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add sputnikx -- npx -y mcp-sputnikx-market\nexport SPUTNIKX_API_KEY=sk_live_your_key_here\n```\n\n### Cursor / VS Code / Windsurf\n\n```json\n{\n  \"mcp\": {\n    \"servers\": {\n      \"sputnikx\": {\n        \"command\": \"npx\",\n        \"args\": [\"-y\", \"mcp-sputnikx-market\"],\n        \"env\": { \"SPUTNIKX_API_KEY\": \"sk_live_your_key_here\" }\n      }\n    }\n  }\n}\n```\n\n## 22 Tools\n\n### EU Trade Analytics\n\n| Tool | Description |\n|------|-------------|\n| `query_trade` | 9 query types: overview, countries, timeline, top_partners, top_products, balance, wood_products, heatmap, product_detail |\n| `query_customs` | Latvia customs: classifications, trends, top commodities, country analysis, tariff lookup, seasonal patterns |\n| `salary_overview` | EU salary DB metadata and coverage |\n| `salary_ai_risk` | AI automation exposure scores (ISCO + NACE, OECD 2023) |\n| `salary_lv_wages` | Latvia wages by year, NACE sector, region, gender |\n\n### Fusion Engine (Cross-Source Intelligence)\n\n| Tool | Description | x402 Price |\n|------|-------------|------------|\n| `fusion_query` | Universal query across Trade + Customs + Salary + Macro | $0.50 |\n| `fusion_market_intel` | Market intelligence combining all data sources | $1.00 |\n| `fusion_country_profile` | Country economic profile (trade + salary + macro) | $1.00 |\n| `fusion_deep_analysis` | LLM-powered cross-source synthesis | $5.00 |\n\n### Commerce\n\n| Tool | Description |\n|------|-------------|\n| `search_products` | Product catalog (heating pellets, wood products) |\n| `get_prices` | Real-time EUR pricing with price_per_kg |\n| `check_availability` | Stock by warehouse location |\n| `calculator` | Heating fuel calculator (kW, insulation, climate) |\n| `create_quote` | Quote with line items + 21% VAT |\n| `place_order` | Order with idempotency key (max EUR 50,000) |\n| `order_status` | Track order by ID |\n\n### SoulLedger (Agent Identity)\n\n| Tool | Description |\n|------|-------------|\n| `soul_profile` | Agent trust score + 7D behavioral DNA |\n| `soul_verify` | Cryptographic hash-chain verification |\n| `soul_leaderboard` | Agent trust rankings |\n| `soul_bounties` | Bounty marketplace (USDC rewards) |\n\n### Intelligence\n\n| Tool | Description |\n|------|-------------|\n| `prediction_signals` | Prediction market signals (paper trading) |\n| `list_skills` / `run_skill` | CRM agent skills (oracle, spider, strategist) |\n\n## Trade Query Types\n\n```\noverview       — High-level stats: total records, countries, date range\ncountries      — EU27 countries with data availability\ntimeline       — Monthly trade volume time series\ntop_partners   — Largest trading partners by EUR value\ntop_products   — Largest HS2 categories by EUR value\nbalance        — Trade balance (export - import) over years\nwood_products  — HS4 wood trade breakdown (chapter 44)\nheatmap        — Cross-country comparison for a product\nproduct_detail — Deep HS2 chapter analysis\n```\n\n## Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `SPUTNIKX_API_KEY` | Yes | — | API key (get from admin panel or register agent) |\n| `SPUTNIKX_API_URL` | No | `https://sputnikx.xyz` | API base URL |\n| `SPUTNIKX_TENANT` | No | `siltums` | Tenant: `siltums` or `woodpoint` |\n| `SPUTNIKX_TIMEOUT` | No | `30000` | Request timeout (ms) |\n| `MCP_HTTP_PORT` | No | — | Enable Streamable HTTP transport |\n\n## Payment (x402)\n\nPaid endpoints support [x402 micropayments](https://www.x402.org/) — USDC on Base chain.\n\n| Tier | Price Range | Examples |\n|------|-------------|---------|\n| Free | $0 | health, product feed, OpenAPI, soul directory |\n| Basic | $0.001-$0.01 | catalog, prices, salary overview |\n| Standard | $0.05-$0.10 | trade analytics, customs, seasonality, HHI |\n| Premium | $0.50-$5.00 | fusion queries, deep analysis, agent skills |\n\n## Example Prompts\n\n- *\"Show Latvia's top 5 trading partners for wood products in 2024\"*\n- *\"What's the Herfindahl index for HS44 imports into Germany?\"*\n- *\"Compare AI automation risk across EU manufacturing sectors\"*\n- *\"Give me a country profile for Poland — trade, salary, macro combined\"*\n- *\"Calculate heating pellet needs: 25kW boiler, 7 months, good insulation\"*\n- *\"Check if 'Mikhail Petrov' appears on EU sanctions lists\"*\n\n## Discovery\n\n- [OpenAPI Spec](https://sputnikx.xyz/api/openapi.json)\n- [Agent Card](https://sputnikx.xyz/.well-known/agent-card.json)\n- [LLM Documentation](https://sputnikx.xyz/llms.txt)\n- [SoulLedger](https://soul.sputnikx.xyz)\n\n## License\n\nMIT\n",
  "bytes": 5818,
  "sha": "80a32d381e98e5cb90d5df7afa7ff1b66eb14000927d5a6aa4a515b572480ab8",
  "repo_slug": "drivenbymyai-max/mcp-sputnikx-market",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_xyz_sputnikx_market_facca81d/readme"
}