io.github.drivenbymyai-max/sputnikx-market

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

22 Tools

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

• OpenAPI Spec
• Agent Card
• LLM Documentation
• SoulLedger

License

MIT