English Français العربية

io.github.drivenbymyai-max/sputnikx-market

Official registry E-commerce

EU trade analytics, product catalog, orders, and heating fuel calculator for AI agents.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package mcp-sputnikx-market
Claude Code 
claude mcp add sputnikx-market -e 'SILTUMS_API_KEY=<your siltums_api_key>' -- npx -y mcp-sputnikx-market@1.0.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "sputnikx-market": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-sputnikx-market@1.0.2"
            ],
            "env": {
                "SILTUMS_API_KEY": "<your siltums_api_key>"
            }
        }
    }
}

Environment variables

  • SILTUMS_API_KEY required secret Siltums API key for authentication (obtain from admin panel)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. mcp-sputnikx-market
  2. Data Sources
  3. Quick Start
  4. 22 Tools
  5. Trade Query Types
  6. Environment Variables
  7. Payment (x402)
  8. Example Prompts
  9. Discovery
  10. License

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

SourceRecordsCoverageUpdate
Eurostat COMEXT63M+EU27, 260 partners, HS2-CN8, 2005-2025Monthly
Latvia Customs15M+KN8-level, declarations, 2005-2025Monthly
EU Salary70K+44 countries, 21 NACE sectors, AI risk scoresAnnual
Fusion EngineCross-sourceTrade + Customs + Salary + Macro (ECB/FRED)Real-time
SoulLedger130K+ agentsTrust scoring, behavioral DNA, ERC-8004Real-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
ToolDescription
query_trade9 query types: overview, countries, timeline, top_partners, top_products, balance, wood_products, heatmap, product_detail
query_customsLatvia customs: classifications, trends, top commodities, country analysis, tariff lookup, seasonal patterns
salary_overviewEU salary DB metadata and coverage
salary_ai_riskAI automation exposure scores (ISCO + NACE, OECD 2023)
salary_lv_wagesLatvia wages by year, NACE sector, region, gender
Fusion Engine (Cross-Source Intelligence)
ToolDescriptionx402 Price
fusion_queryUniversal query across Trade + Customs + Salary + Macro$0.50
fusion_market_intelMarket intelligence combining all data sources$1.00
fusion_country_profileCountry economic profile (trade + salary + macro)$1.00
fusion_deep_analysisLLM-powered cross-source synthesis$5.00
Commerce
ToolDescription
search_productsProduct catalog (heating pellets, wood products)
get_pricesReal-time EUR pricing with price_per_kg
check_availabilityStock by warehouse location
calculatorHeating fuel calculator (kW, insulation, climate)
create_quoteQuote with line items + 21% VAT
place_orderOrder with idempotency key (max EUR 50,000)
order_statusTrack order by ID
SoulLedger (Agent Identity)
ToolDescription
soul_profileAgent trust score + 7D behavioral DNA
soul_verifyCryptographic hash-chain verification
soul_leaderboardAgent trust rankings
soul_bountiesBounty marketplace (USDC rewards)
Intelligence
ToolDescription
prediction_signalsPrediction market signals (paper trading)
list_skills / run_skillCRM 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

VariableRequiredDefaultDescription
SPUTNIKX_API_KEYYes—API key (get from admin panel or register agent)
SPUTNIKX_API_URLNohttps://sputnikx.xyzAPI base URL
SPUTNIKX_TENANTNosiltumsTenant: siltums or woodpoint
SPUTNIKX_TIMEOUTNo30000Request timeout (ms)
MCP_HTTP_PORTNo—Enable Streamable HTTP transport

Payment (x402)

Paid endpoints support x402 micropayments — USDC on Base chain.

TierPrice RangeExamples
Free$0health, product feed, OpenAPI, soul directory
Basic$0.001-$0.01catalog, prices, salary overview
Standard$0.05-$0.10trade analytics, customs, seasonality, HHI
Premium$0.50-$5.00fusion 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

Frequently asked questions

What is io.github.drivenbymyai-max/sputnikx-market?

EU trade analytics, product catalog, orders, and heating fuel calculator for AI agents.

How do I install io.github.drivenbymyai-max/sputnikx-market?

It runs on your machine. In Claude Code: claude mcp add sputnikx-market -e 'SILTUMS_API_KEY=<your siltums_api_key>' -- npx -y mcp-sputnikx-market@1.0.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.drivenbymyai-max/sputnikx-market need an API key?

Yes. It expects SILTUMS_API_KEY, which you set in its configuration.

Is io.github.drivenbymyai-max/sputnikx-market open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.drivenbymyai-max/sputnikx-market?

It is published by drivenbymyai-max. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.