io.github.drivenbymyai-max/sputnikx-market
编码与调试by drivenbymyai-max
为 AI agents 提供 EU 贸易分析、商品目录、订单管理及 heating fuel calculator。
什么是 io.github.drivenbymyai-max/sputnikx-market?
为 AI agents 提供 EU 贸易分析、商品目录、订单管理及 heating fuel calculator。
README
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
{
"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
常见问题
io.github.drivenbymyai-max/sputnikx-market 是什么?
为 AI agents 提供 EU 贸易分析、商品目录、订单管理及 heating fuel calculator。
相关 Skills
网页构建器
by anthropics
面向复杂 claude.ai HTML artifact 开发,快速初始化 React + Tailwind CSS + shadcn/ui 项目并打包为单文件 HTML,适合需要状态管理、路由或多组件交互的页面。
✎ 在 claude.ai 里做复杂网页 Artifact 很省心,多组件、状态和路由都能顺手搭起来,React、Tailwind 与 shadcn/ui 组合效率高、成品也更精致。
网页应用测试
by anthropics
用 Playwright 为本地 Web 应用编写自动化测试,支持启动开发服务器、校验前端交互、排查 UI 异常、抓取截图与浏览器日志,适合调试动态页面和回归验证。
✎ 借助 Playwright 一站式验证本地 Web 应用前端功能,调 UI 时还能同步查看日志和截图,定位问题更快。
前端设计
by anthropics
面向组件、页面、海报和 Web 应用开发,按鲜明视觉方向生成可直接落地的前端代码与高质感 UI,适合做 landing page、Dashboard 或美化现有界面,避开千篇一律的 AI 审美。
✎ 想把页面做得既能上线又有设计感,就用前端设计:组件到整站都能产出,难得的是能避开千篇一律的 AI 味。
相关 MCP Server
GitHub
编辑精选by GitHub
GitHub 是 MCP 官方参考服务器,让 Claude 直接读写你的代码仓库和 Issues。
✎ 这个参考服务器解决了开发者想让 AI 安全访问 GitHub 数据的问题,适合需要自动化代码审查或 Issue 管理的团队。但注意它只是参考实现,生产环境得自己加固安全。
Context7 文档查询
编辑精选by Context7
Context7 是实时拉取最新文档和代码示例的智能助手,让你告别过时资料。
✎ 它能解决开发者查找文档时信息滞后的问题,特别适合快速上手新库或跟进更新。不过,依赖外部源可能导致偶尔的数据延迟,建议结合官方文档使用。
by tldraw
tldraw 是让 AI 助手直接在无限画布上绘图和协作的 MCP 服务器。
✎ 这解决了 AI 只能输出文本、无法视觉化协作的痛点——想象让 Claude 帮你画流程图或白板讨论。最适合需要快速原型设计或头脑风暴的开发者。不过,目前它只是个基础连接器,你得自己搭建画布应用才能发挥全部潜力。