English Français العربية

io.github.drivenbymyai-max/sputnikx-market

Registre officiel E-commerce

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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
Configuration JSON (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>"
            }
        }
    }
}

Variables d'environnement

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

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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

Questions fréquentes

Qu'est-ce que io.github.drivenbymyai-max/sputnikx-market ?

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

Comment installer io.github.drivenbymyai-max/sputnikx-market ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add sputnikx-market -e 'SILTUMS_API_KEY=<your siltums_api_key>' -- npx -y mcp-sputnikx-market@1.0.2. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.drivenbymyai-max/sputnikx-market ?

Oui. Il attend SILTUMS_API_KEY, à renseigner dans sa configuration.

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

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.drivenbymyai-max/sputnikx-market ?

Il est publié par drivenbymyai-max. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.