trading-signals-mcp

Trading Signals MCP

Claude、Cursor、LangChain、その他のMCP対応エージェントから、Trading Signals Toolkitに1行でアクセスできるMCPサーバーです。米国政府のマクロ経済データ（BLS、Federal Reserve、Treasury、CFTC）、SEC Form 4のインサイダー購入および複数人による購入、Baseトークンの安全性判定、小規模なクオンツ計算ツールをもとに、取引前チェック（GO／CAUTION／NO_GO、$0.10）、先物のイベントリスク判定、セッション概要、マクロイベント分析を提供します。各ツールの呼び出し料金は、ユーザーが管理するウォレットからUSDCでBase上のx402を介して自動的に支払われます。呼び出しごとの上限額も設定できます。また、料金ページから無料のAPIキーを取得すれば、HTTP APIもお試しいただけます（月100回、カード不要）。

ツールと料金

ツール	料金（USDC）	返される内容
pre_trade_check	$0.10	ES/NQ/CL/GC/ZNについて、わかりやすい理由付きのGO／CAUTION／NO_GO判定を1つ返します：イベント判定＋セッション概要＋SECインサイダー取引活動（任意でBaseトークン判定も追加）
event_gate	$0.01	safeToTrade＋次回の影響度の高い米国指標発表（CPI、NFP、PPI、FOMC、Treasury入札）
event_study	$0.02	前回発表時の動き：直近N回のCPI、雇用統計、FOMC、PPI、小売売上高、GDP、PCE発表後+5/+15/+30/+60分のES/NQ/RTY/ZNの値動き、パーセンタイル、最大逆行幅、推奨ストップ幅
session_brief	$0.03	今後の指標発表、BLSの最新値、Treasury 2年債／10年債／2年債・10年債スプレッド、CFTC COTのポジション、休場日、判定
token_verdict	$0.02	Base ERC-20のA～F判定：オーナー、プロキシ、流動性、ハニーポットシミュレーション、税
insider_buys	$0.01	1銘柄のSEC Form 4に基づくインサイダーの公開市場での購入
insider_clusters	$0.02	過去N日以内に複数の異なるインサイダーが購入した銘柄
vwap_bands	$0.005	入力したバーから算出したVWAPと標準偏差バンド
opening_range	$0.005	入力したバーから算出したオープニングレンジ、ブレイクアウト状態、目標値
atr_stop	$0.005	Wilder ATR、ストップ価格、ポジションサイズ
backtest_opening_range_breakout	$0.02	入力したバーを使ったオープニングレンジブレイクアウトのバックテスト

失敗した呼び出し（不正な入力、上流サービスの停止）はエラーを返し、課金されません。

セットアップ

Node.js 18.17以降と、Baseメインネット上に数ドル分のUSDCを保有する専用Baseウォレットの秘密鍵が必要です（ETHは不要です。ガス代はファシリテーターが支払います）。

環境変数	必須	デフォルト	意味
X402_PRIVATE_KEY	はい（ツールを呼び出す場合）	–	支払い用ウォレットの0xプレフィックス付き秘密鍵
MAX_USD_PER_CALL	いいえ	0.50	呼び出しごとの上限額。これを超える料金の呼び出しは署名前に拒否されます
TRADING_SIGNALS_BASE_URL	いいえ	https://signals.incomefather.com	APIのベースURL

直接実行する場合：

X402_PRIVATE_KEY=0xYOUR_DEDICATED_WALLET_KEY npx -y x402-trading-signals-mcp

Claude Desktop

claude_desktop_config.json（設定 → 開発者 → 設定を編集）：

{
  "mcpServers": {
    "trading-signals": {
      "command": "npx",
      "args": ["-y", "x402-trading-signals-mcp"],
      "env": {
        "X402_PRIVATE_KEY": "0xYOUR_DEDICATED_WALLET_KEY",
        "MAX_USD_PER_CALL": "0.50"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクト）：

{
  "mcpServers": {
    "trading-signals": {
      "command": "npx",
      "args": ["-y", "x402-trading-signals-mcp"],
      "env": {
        "X402_PRIVATE_KEY": "0xYOUR_DEDICATED_WALLET_KEY",
        "MAX_USD_PER_CALL": "0.50"
      }
    }
  }
}

Claude Code

claude mcp add trading-signals \
  --env X402_PRIVATE_KEY=0xYOUR_DEDICATED_WALLET_KEY \
  --env MAX_USD_PER_CALL=0.50 \
  -- npx -y x402-trading-signals-mcp

LangChain（langchain-mcp-adapters）

# pip install langchain-mcp-adapters langgraph "langchain[anthropic]"
import asyncio, os
from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent

async def main():
    client = MultiServerMCPClient({
        "trading-signals": {
            "command": "npx",
            "args": ["-y", "x402-trading-signals-mcp"],
            "transport": "stdio",
            "env": {**os.environ, "X402_PRIVATE_KEY": os.environ["X402_PRIVATE_KEY"], "MAX_USD_PER_CALL": "0.50"},
        }
    })
    tools = await client.get_tools()
    agent = create_react_agent("anthropic:claude-sonnet-4-5", tools)
    out = await agent.ainvoke({"messages": "Run a pre-trade check for NQ with ticker NVDA."})
    print(out["messages"][-1].content)

asyncio.run(main())

支払いの仕組み

各ツールは1つのHTTPSルートを呼び出します。APIは正確なUSDC金額を含む 402 Payment Required を返します。このサーバーはその金額に対するEIP-3009 transferWithAuthorization に署名し（Baseメインネット上のUSDCのみ、MAX_USD_PER_CALL 以下に限ります）、再試行します。支払い済みの結果には、決済トランザクションとBaseScanへのリンクを含む _payment フィールドが付与されます。X402_PRIVATE_KEY を設定しなくてもサーバーは起動してツール一覧を表示しますが、ツールを呼び出すと「ウォレットが設定されていません」という明確なエラーが返され、課金されません。

セキュリティ

• 専用の少額残高ウォレットを使用してください。 この用途専用の新しいウォレットを作成し、使ってもよい金額だけを入金してください（たとえば、Base 上の USDC を 2～5 ドル分）。ほかの資金が入っているキーは絶対に使用しないでください。
• キーはお使いのマシンから外に出ません。環境変数から読み込まれ、支払い承認への署名にローカルでのみ使用されます。API に送信されたり、ログに記録されたりすることはありません。
• MAX_USD_PER_CALL は低い値に設定してください。デフォルト（$0.50）ではすべてのツールを利用できます。0.05 に設定すると、$0.10 のバンドルはブロックされます。
• MCP クライアントの設定ファイルには、現在秘密鍵が含まれています。コミットしたり共有したりしないでください。

開発

npm install
npm run build   # syntax/import check (plain ESM, no compile step)
npm test        # starts the server over stdio, lists tools, checks unpaid/capped errors (spends nothing)

免責事項

情報提供のみを目的としており、投資助言ではありません。データは公開情報源（米国政府機関、SEC EDGAR、Base メインネット）から取得しており、遅延、不完全、または誤りが含まれる場合があります。取引の判断、および設定したウォレット内の資金については、ご自身の責任となります。

MIT ライセンス。