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