Skip to main content
Glama

mcp-sputnikx-market

npm MCP License: MIT

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

Related MCP server: customs-mcp-server

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

License

MIT

Available Tools

19 tools
calculatorAInspect

Calculate heating fuel needs from boiler specs. Returns required kg, bags, and pallets of granulas. Formula: kW * 350 * tempFactor * monthsFactor * insulationFactor.

Inputs: boiler_kw, insulation, desired_temp, heating_months.

check_availabilityAInspect

Check product stock across warehouse locations. Returns quantities (bags, pallets) per location. Pass product_id or product_slug for a specific product, or omit both for all in-stock products.

Inputs: product_id, product_slug.

create_quoteAInspect

Create a draft quote (piedavajums) with line items. Auto-calculates totals with 21% VAT. Returns quote number and pricing breakdown. Requires "quote" scope API key.

Inputs: items (required), client_name (required), notes, client_email, +1 more.

get_pricesAInspect

Get current product prices in EUR with calculated price_per_kg. Returns all in-stock products or a specific product by slug.

Inputs: product_slug.

list_skillsAInspect

List available CRM agent skills. Returns skill catalog with names, descriptions, pricing, and example tasks. Available agents: oracle, spider, tracker, diplomat, sniper, strategist, finansist, gramatvedis.

Inputs: no named parameters.

order_statusAInspect

Check order status by ID. Returns order details, product info, and delivery status.

Inputs: order_id (required).

place_orderAInspect

Place a product order. You MUST provide product_id or product_slug (at least one). Enforces EUR 50,000 max limit. Supports idempotency_key to prevent duplicates. Requires "order" scope API key.

Inputs: quantity (required), customer_name (required), customer_email (required), delivery_address (required), +6 more.

prediction_signalsBInspect

Prediction market signals — paper trading strategy performance, active trades, signal feed from 7-strategy ensemble

Inputs: view, limit.

query_customsBInspect

Query Latvia customs analytics (3.8GB database). KN8 product codes, import/export trends, seasonal patterns, country analysis. Supports: classifications, trends, top_commodities, country_analysis, tariff_lookup, seasonal.

Inputs: query_type (required), q, code, sort, +5 more.

query_tradeBInspect

Query EU trade data (Eurostat COMEXT DS-045409). 28M+ records, 27 EU countries, HS2-CN8 product codes. Supports: overview, countries, timeline, top_partners, top_products, balance, wood_products, heatmap, product_detail.

Inputs: query_type (required), hs2, flow, year, +4 more.

run_skillAInspect

Execute a CRM agent skill. Runs an AI agent (oracle, spider, etc.) with a task description and returns the analysis. Requires "skill" scope API key. Execution typically takes 5-30 seconds.

Inputs: task (required), agent (required), format, tenant.

salary_ai_riskAInspect

AI automation risk scores by ISCO occupation or NACE sector — exposure, complementarity, risk level

Inputs: sector, occupation.

salary_lv_wagesCInspect

Latvia detailed wage data — by sector, occupation, gender gap, regional breakdown

Inputs: year, sector.

salary_overviewCInspect

EU salary database metadata — countries, sectors, occupations coverage

Inputs: no named parameters.

search_productsAInspect

Search in-stock products in the catalog. Returns name, price, type, availability. Filter by type (granulas, briketes, saplaksnis) or name search. Pass slug for single-product lookup.

Inputs: slug, type, search.

soul_bountiesAInspect

Browse open agent bounties — tasks with USDC rewards that agents can claim

Inputs: limit, status.

soul_leaderboardBInspect

Agent trust leaderboard — ranked by trust score with DNA summaries

Inputs: limit.

soul_profileCInspect

Agent identity profile — trust score, behavioral DNA, character traits, SX# passport

Inputs: agent_id (required).

soul_verifyBInspect

Verify agent event hash chain integrity — tamper detection for EU AI Act compliance

Inputs: agent_id (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 19 tools

    Disambiguation3/5

    Most tools have distinct purposes, but there are overlapping areas: search_products, get_prices, and check_availability all deal with product information; query_trade and query_customs both handle trade data; salary_lv_wages and salary_overview both involve salary data. Descriptions help, but the boundaries are not always clear.

    Naming Consistency2/5

    Naming is inconsistent: some tools use verb_noun patterns (search_products, get_prices, check_availability), while others are noun phrases (soul_profile, salary_lv_wages), and 'calculator' is a lone noun. This mix of styles makes it harder to predict tool names.

    Tool Count3/5

    With 19 tools, the server straddles the upper boundary of acceptable scope. It's not overwhelmingly large, but the count feels heavy given that the tools span several unrelated domains, making it harder to navigate.

    Completeness2/5

    The tool surface is incomplete for a cohesive domain. Each cluster has gaps: products lack order cancellation or update; soul tools lack actions like claiming bounties; skills only have list/run, no creation or management. The overall domain is ambiguous, so it's unclear what complete coverage would look like.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides 14 customs and trade operations as MCP tools, enabling AI agents to query tariff, track declarations, screen dual-use items, and generate AI-powered declarations.
      47 npm
      2
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Exposes the Eurostat Statistics API, enabling LLMs to discover, explore, and retrieve official EU statistical data through search, dimension inspection, and data retrieval tools.
      3
      -