MarketTwits news + Russian market data (x402)

x402-markettwits-mcp

用于按次付费 x402-markettwits-news API 的 MCP 服务（stdio）：提供英文 MarketTwits 市场新闻，以及俄罗斯市场数据（俄罗斯央行外汇汇率和关键利率、MOEX 报价、指数和涨跌幅榜、Rosstat 燃油价格）、公开 Telegram 频道和 Wildberries 商品价格。

每个 API 端点对应一个 MCP 工具（共 31 个）。每次调用固定收费 $0.001–$0.005，使用 Base 上的 USDC 支付，并通过 x402 从你配置的钱包自动付款。只有成功的响应会收费；无效参数（400）、未找到（404）和上游故障（502）均免费。

要求

• Node.js 20+
• Base 上的专用热钱包，并存有少量 USDC（无需 ETH：付款通过 EIP-3009 授权实现免 Gas，由 facilitator 结算）。$3 足以支付 300–2,000 次调用。切勿使用主钱包的密钥。

配置

环境变量	默认值
X402_PRIVATE_KEY	—	热钱包的私钥，需以 0x 开头（或将 X402_PRIVATE_KEY_FILE 设置为存放该私钥的文件路径）。未设置时，工具会返回包含价格的 payment_required 错误
X402_MAX_PAYMENT_USD	0.02	每次调用的上限：若 402 请求的金额更高，则会在签名前拒绝
X402_BASE_URL	https://x402-markettwits-news.onrender.com	API 基础 URL
X402_TOOLS_SOURCE	auto	auto = 从在线 /openapi.json 获取工具（新端点会自动出现），失败时回退到内置快照；bundled / live 可强制指定其中一种
X402_NETWORK	eip155:8453	测试网部署时使用 eip155:84532（Base Sepolia）

Claude Desktop

claude_desktop_config.json（Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "markettwits": {
      "command": "npx",
      "args": ["-y", "x402-markettwits-mcp"],
      "env": { "X402_PRIVATE_KEY": "0x...", "X402_MAX_PAYMENT_USD": "0.02" }
    }
  }
}

Cursor

~/.cursor/mcp.json（或项目中的 .cursor/mcp.json）：

{
  "mcpServers": {
    "markettwits": {
      "command": "npx",
      "args": ["-y", "x402-markettwits-mcp"],
      "env": { "X402_PRIVATE_KEY": "0x..." }
    }
  }
}

Claude Code

claude mcp add markettwits --env X402_PRIVATE_KEY=0x... -- npx -y x402-markettwits-mcp

Docker

docker build -t x402-markettwits-mcp .
docker run -i --rm -e X402_PRIVATE_KEY x402-markettwits-mcp

工具

工具	端点	价格
get_latest_news / get_important_news / search_news	/news/latest, /news/important, /news/search	$0.0015
get_news_since	/news/since（游标轮询）	$0.001
check_news_alert / check_new_high_alert	/news/alerts/check, /news/alerts/new	$0.002 / $0.0025
summarize_news / summarize_recent_news	/news/summary, /news/summary/recent	$0.004 / $0.0035
get_top_topics / get_trending_topics	/news/top-topics, /news/topics/trending	$0.0025 / $0.002
get_news_movers / get_country_news	/news/movers, /news/country	$0.0025 / $0.002
get_data_surprises / get_news_sentiment / get_news_digest	/news/data-surprises, /news/sentiment, /news/digest	$0.003 / $0.0025 / $0.005
get_cbr_fx_rates / get_cbr_key_rate	/ru/fx, /ru/key-rate	$0.001
get_moex_quote / get_moex_index / get_moex_movers	/moex/quote, /moex/index, /moex/movers（延迟约 15 分钟）	$0.0015 / $0.0015 / $0.002
get_ru_fuel_prices	/ru/fuel（Rosstat 每周数据）	$0.0015
get_telegram_channel_latest / search_telegram_channels	/tg/channel/latest, /tg/search	$0.002 / $0.003
get_product_info / compare_products / monitor_product_price / get_product_price_history	/product/*（Wildberries）	$0.002 / $0.003 / $0.0025 / $0.002
check_price_alert	/alerts/price（Wildberries；Ozon 当前被屏蔽 → 502，免费）	$0.0025
check_news_keyword_alert	/alerts/news（按关键词查询自某个 ID/时间以来新增的重要新闻）	$0.002
check_fx_rate_alert	/alerts/fx（CBR 汇率超出最低/最高区间）	$0.0015
get_daily_ru_market_digest	/digest/daily（关键利率、USD/EUR/CNY、燃油、头条新闻）	$0.005

每个工具都会返回 JSON：{ ok: true, endpoint, data, payment: { price_usd, transaction, payer, ... } }，或返回 { ok: false, error, ... }，并设置 isError: true。错误代码如下：

• payment_required：未设置密钥
• price_above_cap
• invalid_params：400
• not_found：404
• upstream_unavailable：502
• payment_rejected：例如 USDC 余额不足
• config_error
• network_error

开发

npm ci
npm test       # tools/list over MCP + mocked 402 flow (no real payments)
npm run gen    # refresh openapi.snapshot.json from the live API