MarketTwits news + Russian market data (x402)

x402-markettwits-mcp

従量課金制の x402-markettwits-news API に対応する MCP サーバー（stdio）です。MarketTwits の英語の市場ニュースに加え、 ロシアの市場データ（ロシア銀行の為替レートと政策金利、MOEX の株価、指数、値上がり・値下がり銘柄、Rosstat の燃料価格）、 一般公開されている Telegram チャンネル、Wildberries の商品価格を提供します。

各 API エンドポイントは 1 つの MCP ツールです（31 個）。各呼び出しの料金は Base 上で USDC 0.001～0.005 ドルです。お客様が設定したウォレットから、x402 を通じて自動的に支払われます。課金されるのは成功したレスポンスのみです。無効なパラメーター（400）、見つからないリソース（404）、上流の障害（502）は無料です。

要件

• Node.js 20 以降
• Base 上に少額の USDC を保有する専用のホットウォレット（ETH は不要です。支払いはガス代無料の EIP-3009 承認をファシリテーターが決済します）。3 ドルで 300～2,000 回呼び出せます。メインウォレットの秘密鍵は絶対に使用しないでください。

設定

Env	デフォルト値
X402_PRIVATE_KEY	—	ホットウォレットの 0x プレフィックス付き秘密鍵（または、鍵を格納したファイルへのパスを指定する X402_PRIVATE_KEY_FILE）。設定しない場合、ツールは価格を含む payment_required エラーを返します
X402_MAX_PAYMENT_USD	0.02	1 回あたりの上限額。この額を超える支払いを求める 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