English Français العربية

io.github.drivenbymyai-max/sputnikx-market

السجل الرسمي التجارة الإلكترونية

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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
إعداد 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>"
            }
        }
    }
}

متغيرات البيئة

  • SILTUMS_API_KEY إلزامي سري Siltums API key for authentication (obtain from admin panel)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو io.github.drivenbymyai-max/sputnikx-market؟

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

كيف أثبّت io.github.drivenbymyai-max/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 من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.drivenbymyai-max/sputnikx-market إلى مفتاح API؟

نعم. يتطلب SILTUMS_API_KEY، وتضبطها في إعداداته.

هل io.github.drivenbymyai-max/sputnikx-market مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.drivenbymyai-max/sputnikx-market؟

ينشره drivenbymyai-max. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.