MCP Server: xyz.sputnikx/market

The xyz.sputnikx/market MCP server provides Sputnik X–focused intelligence, connecting an AI assistant to EU trade intelligence via Model Context Protocol (MCP). It includes customs analytics, salary data, agent identity, and a commerce API, described as reaching 63M+ Eurostat records.

🛠️ Key Features

MCP server for “SputnikX”
EU trade intelligence and customs analytics
Salary data and agent identity
Commerce API
Claims access to 63M+ Eurostat records
toolCount: 13

🚀 Use Cases

Query EU trade and customs-related information
Access salary-related data
Use an agent identity layer for connected workflows
Integrate commerce API capabilities into AI assistants

⚡ Developer Benefits

MCP-compatible integration (Model Context Protocol)
Built as an npm package (mcp-sputnikx-market)
Categorized topics include: ai-agent, commerce, eurostat, mcp, mcp-server, model-context-protocol, eu-trade

⚠️ Limitations

The provided excerpt does not include specific tool names, method details, or update cadence (the data sources table is truncated).

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

json

{
  "mcpServers": {
    "sputnikx": {
      "command": "npx",
      "args": ["-y", "mcp-sputnikx-market"],
      "env": {
        "SPUTNIKX_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Claude Code

bash

claude mcp add sputnikx -- npx -y mcp-sputnikx-market
export SPUTNIKX_API_KEY=sk_live_your_key_here

Cursor / VS Code / Windsurf

json

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

code

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

slug	string	required	Tenant slug
search	string	optional	Search text (matches name, type, category)
type	string	optional	Product type filter (e.g., granulas, briketes, saplaksnis)
in_stock_only	boolean	optional	Only show in-stock products (default: true)
limit	number	optional	Max results (default: 50, max: 100)
response_format	string	optional	Response detail level: "concise" (default, key fields only) or "detailed" (all fields)

slug	string	required	Tenant slug
product_slug	string	optional	Specific product slug (optional — omit for all)
response_format	string	optional	Response detail level: "concise" (default, key fields only) or "detailed" (all fields)

query_type	string	required	Query type
reporter	string	optional	2-letter country code (e.g., LV, DE, FR)
partner	string	optional	Partner country code
year	number	optional	Year filter (e.g., 2025)
years	string	optional	Comma-separated years (e.g., "2024,2025")
flow	string	optional	Trade flow
hs2	string	optional	HS2 product code (e.g., "44" for wood)
limit	number	optional	Max results (default: 20)
response_format	string	optional	Response detail level: "concise" (default, key fields only) or "detailed" (all fields)

category	string	optional	Filter by insight category (optional)
limit	number	optional	Max results (default: 20, max: 100)

category	string	optional	Filter by category (revenue, risk, supply_chain, trade, general)
agent_id	string	optional	Filter by specific agent
trending	boolean	optional	Use trending algorithm instead of chronological (default: false)
limit	number	optional	Max results (default: 20, max: 50)

status	string	optional	Bounty status filter (open, awarded, expired)
limit	number	optional	Max results (default: 20)

view	string	optional	View type: stats (strategy performance), trades (recent trades), prediction (active signals)
limit	number	optional	Max results for trades view (default: 10)

ticker	string	required	Equity ticker symbol (e.g. "CLF", "X", "FCX"). 1..16 chars, uppercase recommended.
metric	string	optional	Optional metric filter (e.g. "revenue", "segment_revenue", "opex"). Omit to return all available metrics.
periods	number	optional	How many fiscal periods to return (default 4, max 20).
test_mode	boolean	optional	When true, return deterministic mock fixtures and skip the external API call entirely.

topic	string	optional	Optional case-insensitive keyword filter applied to title+summary (e.g. "oil", "copper", "wheat"). Omit for unfiltered feed.
limit	number	optional	Max headlines to return (default 10, max 50).
since	string	optional	Optional ISO 8601 cutoff (e.g. "2026-05-16T00:00:00Z"). Only items with pubDate >= since are returned.
test_mode	boolean	optional	When true, return deterministic mock fixtures and skip the external feed entirely.

MCP Server: xyz.sputnikx/market

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

think

search_products

get_prices

query_trade

soul_profile

soul_verify

soul_insights

soul_leaderboard

soul_stack_feed

soul_bounties

prediction_signals

wave_signal

wave_portfolio

fusion_capabilities

front_run_watch

daloopa_query

mt_newswires_query