Trading Signals Mcp

io.github.gdietsch由 GitHub 帳號 gdietsch 發布v0.1.15更新於 Nov 14, 2026

Trading tools for agents: AI trade brief, pre-trade check, event gate, insider buys. Remote or x402

發布方自己的服務:SIGNALS Loyalty Agent Platform

已驗證Streamable HTTP可網頁執行金融安全與監控資料與分析

概覽

AI 產生的概覽

為助理提供唯讀的市場與交易情報:期貨事件風險檢查、宏觀事件研究、SEC 內部人與 13F 資料、代幣安全評級和量化計算器。

可以做什麼
  • 執行交易前與事件風險檢查:GO/CAUTION/NO_GO 結論、事件閘門、盤前簡報、AI 交易簡報
  • 研究宏觀資料發布與持倉:CPI/NFP/FOMC 後走勢的事件研究、CFTC COT 篩選、公債殖利率與標售
  • 查詢 SEC 文件:Form 4 內部人買進與集中買進、13F 持倉與持有人
  • 篩查加密資產:Base 與 Solana 代幣評級、巨鯨資金流、錢包付款就緒度、OFAC 制裁篩查
  • 依自備 OHLCV K 線計算:VWAP 通道、開盤區間、ATR 停損與部位規模、開盤區間突破回測
適用情境
適合在期貨或加密交易決策前,讓助理快速取得有來源的背景資訊,或不必自行串接多個 API 就能取得美國政府宏觀、持倉與 SEC 文件資料。在代理付款或兌換前做代幣安全與制裁核查時也很有用。
執行需求
遠端端點無需安裝;選用 API 金鑰透過 Authorization Bearer 標頭傳送(免費額度每月 100 次,否則僅有少量匿名每日額度)。本機 npm 套件需要 Node.js 18.17+ 以及 X402_PRIVATE_KEY 環境變數,對應一個持有 USDC 的專用 Base 錢包;MAX_USD_PER_CALL 與 TRADING_SIGNALS_BASE_URL 為選用項。
安裝前請注意
本機套件透過 X402_PRIVATE_KEY 簽署付款授權,在 Base 主網上按次以 USDC 付費,應使用專用的低餘額錢包並保持 MAX_USD_PER_CALL 較低;用戶端設定檔隨後會包含私鑰,請勿提交或分享。工具皆為唯讀、從不下單,但輸出僅供參考,不構成投資建議,資料可能延遲或有誤。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Trading Signals Mcp,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.gdietsch%2Ftrading-signals-mcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "trading-signals": {
      "type": "http",
      "url": "https://signals.incomefather.com/mcp"
    }
  }
}

README

Trading Signals MCP

An MCP server that gives Claude, Cursor, LangChain and any other MCP-capable agent one-line access to the Trading Signals Toolkit: a $0.10 GO / CAUTION / NO_GO pre-trade check, a futures event-risk gate, session brief and macro event study built from US government macro data (BLS, Federal Reserve, Treasury, CFTC), SEC Form 4 insider buys and cluster buys, Base token safety verdicts, and small quant calculators. Each tool call pays for itself automatically over x402 in USDC on Base, from a wallet you control, with a per-call spend cap. You can also try the HTTP API with a free API key (100 calls/month, no card) from the pricing page.

Copy-paste quickstarts (curl, JavaScript and Python x402 clients, Claude Desktop / Cursor / Cline configs, LangChain, OpenAI Agents SDK): gdietsch/trading-signals-examples. Guides: signals.incomefather.com/guides.

Hosted remote server (no install, no wallet)

The same 21 tools are also served as a remote MCP server (Streamable HTTP):

https://signals.incomefather.com/mcp
  • No key: small anonymous daily allowance (AI trade brief 1 per day).
  • Free key (100 calls/month, no card) or Starter/Pro key from /pricing: send Authorization: Bearer tsk_…, or append ?key=tsk_… to the URL in clients that can't set headers.

Cursor / Claude Code / Windsurf (mcp.json):

json
{  "mcpServers": {    "trading-signals": {      "url": "https://signals.incomefather.com/mcp",      "headers": { "Authorization": "Bearer tsk_your_key" }    }  }}

Claude (web/desktop): Settings → Connectors → Add custom connector → https://signals.incomefather.com/mcp. ChatGPT: Settings → Apps & Connectors → Advanced settings → Developer mode → Create → same URL, no authentication. Privacy · Terms

Grok Build: this repo is a Grok Build plugin (.grok-plugin/plugin.json and .mcp.json). It connects to the hosted MCP above. No install and no wallet. The local npx -y x402-trading-signals-mcp path in Setup is a separate, optional alternative that pays per call from your own USDC wallet; it is not auto-started by the plugin, because it needs X402_PRIVATE_KEY in your client environment.

Cursor: .cursor-plugin/plugin.json and mcp.json package the same hosted MCP for the official Cursor Marketplace. The Grok Build files above are unchanged.

The local package below pays per call over x402 from your own wallet instead.

Tools and prices

ToolPrice (USDC)What it returns
ai_trade_brief$0.08AI-written structured brief for ES/NQ/CL/GC/ZN from the toolkit's own data: bias, confidence, key levels, risks, catalysts (ET), trade-plan notes, GO/CAUTION/NO_GO tradeability. Not charged if the AI is unavailable
pre_trade_check$0.10One GO / CAUTION / NO_GO verdict with plain reasons for ES/NQ/CL/GC/ZN: event gate + session brief + SEC insider activity (+ optional Base token verdict)
event_gate$0.01safeToTrade + next high-impact US release (CPI, NFP, PPI, FOMC, Treasury auctions)
event_study$0.02What happened last time: ES/NQ/RTY/ZN moves +5/+15/+30/+60 min after the last N CPI, jobs, FOMC, PPI, retail sales, GDP or PCE releases, percentiles, max adverse move and a suggested stop width
session_brief$0.03Upcoming releases, latest BLS values, Treasury 2y/10y/2s10s, CFTC COT positioning, holidays, verdict
token_verdict$0.01Call before buying a Base ERC-20: safe / caution / avoid + A-F with honeypot simulation and taxes, owner/mint/proxy/blacklist/pause flags, liquidity and LP lock, top-10 holders, launch snipers and bundles
solana_token_verdict$0.01Call before buying a Solana mint: safe / caution / avoid + A-F with mint and freeze authority, Token-2022 traps, liquidity and LP lock, live sell test, top-10 holders, creator stake and linked insider (sniper/bundle) wallets
whale_flow$0.02Are big wallets buying or dumping a Base or Solana token? Large DEX trades (1-24h) in the top 3 pools: whale buy/sell USD, net flow, accumulation / distribution signal, hourly flow, largest trades, top accumulators and distributors. No CEX in/outflows
wallet_pay_readiness$0.01Can this Base or Solana wallet pay a USDC amount? Balances, canPay (x402 / direct transfer), shortfalls, USDC blacklist or frozen flags, wallet type and open token approvals, with ok / review / cannot_pay
sanctions_screen$0.01OFAC sanctions screen for a crypto address (any chain) and/or a name (fuzzy score): clear / match / possible_match with matched SDN or Consolidated entries, list publish date and sources. Informational, not legal advice
insider_buys$0.01SEC Form 4 open-market insider purchases for one ticker
insider_clusters$0.02Tickers with several distinct insiders buying in the last N days
sec_13f_holdings$0.02Latest SEC 13F holdings for a fund manager (CIK or name): top positions, value, % of portfolio and quarter-over-quarter new / added / trimmed / exited
sec_13f_holders$0.02Which notable fund managers (Berkshire, Pershing Square, Bridgewater and ~24 more) hold a stock, with quarter-over-quarter change
token_pre_trade$0.015One GO / CAUTION / STOP answer before buying a Solana or Base token: token verdict + OFAC screen of the counterparty wallet and token authorities + wallet pay-readiness, cheaper than the separate calls
cot_screener$0.02Weekly CFTC COT positioning across 45 futures markets: large-speculator net, % of open interest, weekly change, 3-year percentile, crowded long / short flags, biggest shifts
treasury_desk$0.01US rates snapshot: Treasury par curve with 2s10s / 3m10y / 5s30s and 1d/1w/1m changes, upcoming auctions with ET close times, recent results with bid-to-cover and dealer share vs prior auctions
vwap_bands$0.005VWAP + standard-deviation bands from your bars
opening_range$0.005Opening range, breakout state and targets from your bars
atr_stop$0.005Wilder ATR, stop price and position size
backtest_opening_range_breakout$0.02Opening-range-breakout backtest on your bars

Failed calls (bad input, upstream outage) return an error and are not charged.

Setup

You need Node.js 18.17+ and a dedicated Base wallet private key holding a few dollars of USDC on Base mainnet (no ETH needed; the facilitator pays gas).

Env varRequiredDefaultMeaning
X402_PRIVATE_KEYyes (to call tools)–0x-prefixed private key of the paying wallet
MAX_USD_PER_CALLno0.50Hard cap per call; anything pricier is refused before signing
TRADING_SIGNALS_BASE_URLnohttps://signals.incomefather.comAPI base URL

Run it directly:

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

Claude Desktop

claude_desktop_config.json (Settings → Developer → Edit 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 (global) or .cursor/mcp.json (project):

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

bash
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)

python
# pip install langchain-mcp-adapters langgraph "langchain[anthropic]"import asyncio, osfrom langchain_mcp_adapters.client import MultiServerMCPClientfrom 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())

How payment works

Each tool calls one HTTPS route. The API answers 402 Payment Required with the exact USDC amount; this server signs an EIP-3009 transferWithAuthorization for that amount (only USDC on Base mainnet, only up to MAX_USD_PER_CALL) and retries. Paid results include a _payment field with the settlement transaction and a BaseScan link. Without X402_PRIVATE_KEY the server still starts and lists its tools; calling one returns a clear "no wallet configured" error and charges nothing.

Security

  • Use a dedicated, low-balance wallet. Create a fresh wallet just for this, fund it with only what you are willing to spend (for example $2–$5 of USDC on Base), and never use a key that holds other funds.
  • The key stays on your machine: it is read from the environment, used only to sign payment authorizations locally, and never sent to the API or logged.
  • Keep MAX_USD_PER_CALL low. The default ($0.50) allows every tool; set 0.05 to block the $0.10 bundle.
  • Your MCP client config file now contains a private key: don't commit or share it.

Development

bash
npm installnpm 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)

Disclaimer

Informational only, not investment advice. Data comes from public sources (US government agencies, SEC EDGAR, Base mainnet) and may be delayed, incomplete or wrong. You are responsible for your own trading decisions and for the funds in the wallet you configure.

MIT License.

來源:README.md,提交 6311b69

工具

21

ai_trade_brief

AI Trade Brief

AI-written summary of the toolkit's own market data for ES/NQ/CL/GC/ZN (event-risk calendar check, session context, Treasury yields, CFTC positioning, SEC insider activity, and the macro event study for the next high-impact release): headline, summary, upcoming catalysts in ET, key reference levels, risk factors, a deterministic event-risk status (GO/CAUTION/NO_GO), and the input facts. If the AI upstream is unavailable the call fails. Read-only, never places orders. Informational only, not investment advice.

輸入參數pricesymbol必填window

pre_trade_check

Pre-Trade Check (bundle)

One GO / CAUTION / NO_GO event-risk status with plain reasons for a futures contract: event-risk calendar check + session context (US macro calendar, Treasury yields, CFTC positioning, holidays) + SEC Form 4 insider activity (for `ticker`, else top market-wide insider clusters) + optional Base token verdict (`token`). Read-only, never places orders. Informational only, not investment advice.

輸入參數tokensymbol必填tickerwindow

token_pre_trade

Token Pre-Trade Pack

One GO / CAUTION / STOP status for a token: the Solana or Base token safety verdict, an OFAC sanctions screen of the token's mint/freeze authority or owner and of an optional counterparty wallet, and that wallet's pay-readiness (balances, canPay, shortfalls, approvals) for a USDC amount, with plain reasons. Combines those checks in one call. Heuristic, not an audit or legal advice. Read-only, never places orders. Informational only, not investment advice.

輸入參數chaintoken必填amountwalletwalletChain

cot_screener

CFTC COT Positioning Screener

Weekly CFTC Commitments of Traders screener across 45 futures markets (equity indexes, VIX, Treasuries, SOFR, crude, natgas, gold, silver, copper, grains, livestock, softs, FX, BTC, ETH): large-speculator net position, % of open interest, weekly change, 3-year percentile, crowded_long / crowded_short flags, biggest weekly shifts and net flips, plus the next release time. Read-only, never places orders. Informational only, not investment advice.

輸入參數extremesymbolsthresholdassetClass

treasury_desk

Treasury Auction and Yields Desk

US rates snapshot: Treasury par yield curve 1m-30y with 2s10s, 3m10y, 2s5s and 5s30s spreads and 1-day/1-week/1-month changes in bp; upcoming Treasury auctions with ET close time and minutes-to (reopenings labeled); recent auction results with high yield, bid-to-cover and indirect/direct/dealer shares versus the prior six auctions of the same security, plus a strong/average/weak demand label. Read-only, never places orders. Informational only, not investment advice.

輸入參數daysbillsresults

event_gate

Event-Risk Gate

safeToTrade verdict plus the next high-impact US release (BLS CPI/NFP/PPI, FOMC, Treasury auctions) within a minutes window. US public-domain agency data. Read-only, never places orders. Informational only, not investment advice.

輸入參數window

event_study

Macro Event Study (what happened last time)

How ES/NQ/RTY/ZN moved +5/+15/+30/+60 min after each of the last N CPI, NFP (jobs), FOMC, PPI, retail sales, GDP or PCE releases (% and approx. points, ETF proxies from IEX historical data), with median/mean/80th/90th-percentile absolute moves, max adverse move, % of releases with a >0.5% 30-min move, up/down counts and the 80th-percentile absolute 15-minute move as a typical range size. Read-only, never places orders. Informational only, not investment advice.

輸入參數event必填pricesymbollookback

session_brief

Futures Session Brief

Session brief for ES/NQ/CL/GC/ZN: upcoming US high-impact releases with ET times and minutes-to, latest/prior BLS values, Treasury 2y/10y/2s10s with daily change, CFTC COT net positioning with 3y percentile, holiday/early-close flags, and a safeToTrade verdict. Read-only, never places orders. Informational only, not investment advice.

輸入參數symbol必填window

token_verdict

Base Token Verdict

Call before an agent buys, swaps into, lists or accepts a Base ERC-20. Returns safe / caution / avoid plus an A-F grade with plain reasons: buy-then-sell honeypot simulation with taxes, owner, mint, proxy, blacklist, pause and tax-change flags, liquidity across DEXes and LP lock, top-10 holder concentration, launch-window snipers and same-block bundles, and the deployer. Not a security audit. Read-only, never places orders. Informational only, not investment advice.

輸入參數address必填

solana_token_verdict

Solana Token Verdict

Call before an agent buys or accepts a Solana SPL or Token-2022 mint (memecoins, pump.fun launches, airdrops). Returns safe / caution / avoid plus an A-F grade with plain reasons: mint and freeze authority, Token-2022 traps (transfer fee, hook, permanent delegate), liquidity across DEXes and LP lock/burn, a live ~$1k sell test, top-10 holders, creator holdings and launch count, and linked insider (sniper/bundle) wallets. Not a security audit. Read-only, never places orders. Informational only, not investment advice.

輸入參數mint必填

whale_flow

Crypto Whale Flow

Call before chasing or fading a Base or Solana token move, to see if big wallets are buying or dumping. Large DEX trades from the last 1-24h in the token's top 3 pools: whale buy vs sell USD, net flow and % of liquidity, accumulation / distribution signal, hourly flow, largest trades with wallets, top accumulators and distributors. Solana adds Jupiter buy/sell volume. No CEX in/outflows. Read-only, never places orders. Informational only, not investment advice.

輸入參數chainhourstoken必填minUsd

wallet_pay_readiness

Wallet Pay-Readiness

Before an agent pays: can this Base or Solana wallet pay a given USDC amount? Returns ETH/SOL and USDC balances, canPay for x402 (gasless for the payer) and for a direct transfer, shortfalls, USDC blacklist / frozen-account flags, wallet type (EOA, smart contract, EIP-7702) and open token approvals to well-known spenders (Base routers, Permit2, bridges) or SPL delegates (Solana), with an ok / review / cannot_pay status. Read live from public RPC. Read-only, never places orders. Informational only, not investment advice.

輸入參數chainamountaddress必填

sanctions_screen

OFAC Sanctions Screen

Screen a crypto address (any chain: EVM/Base/Ethereum, Bitcoin, Tron, Solana and more, via OFAC's listed digital currency addresses) and/or a person or entity name (fuzzy, scored 0-100) against the official US Treasury OFAC SDN and Consolidated sanctions lists. Returns clear / match / possible_match, the matched entries (name, programs, aliases), list publish date, timestamp and sources. Not legal or compliance advice. Read-only, never places orders. Informational only, not investment advice.

輸入參數nameaddressminScore

insider_buys

SEC Insider Buys (ticker)

SEC Form 4 open-market insider purchases (code P) for one ticker: insider, role, shares, price, value, dates, per-insider totals and a cluster flag. From SEC EDGAR. Read-only, never places orders. Informational only, not investment advice.

輸入參數daysticker必填

insider_clusters

SEC Insider Cluster Buys (market-wide)

Listed tickers where several distinct insiders made open-market purchases (Form 4 code P) in the last N days, with buyers, roles, totals and VWAP. From SEC EDGAR. Read-only, never places orders. Informational only, not investment advice.

輸入參數daysminBuyers

sec_13f_holdings

SEC 13F Fund Holdings

Latest SEC Form 13F-HR holdings for one fund manager, by CIK or name (e.g. berkshire, pershing square, bridgewater): top positions with ticker, CUSIP, shares, value and % of portfolio, portfolio totals, and quarter-over-quarter changes (new, added, trimmed, exited) vs the prior 13F, with period, filing date and EDGAR links. As filed, up to 45 days after quarter end; not current positions. Read-only, never places orders. Informational only, not investment advice.

輸入參數ciktopname

sec_13f_holders

SEC 13F Notable Holders of a Stock

Which notable fund managers (Berkshire Hathaway, Pershing Square, Bridgewater, Baupost, Duquesne, Appaloosa, Soros, Tiger Global, Coatue, ARK and ~17 more) hold a stock in their latest SEC 13F-HR: shares, value, % of each portfolio and quarter-over-quarter change (new, added, trimmed, exited). As filed, up to 45 days after quarter end. Read-only, never places orders. Informational only, not investment advice.

輸入參數ticker必填

vwap_bands

VWAP + Bands

VWAP with standard-deviation bands from your OHLCV bars (session-anchored or full), z-score and band position. Read-only, never places orders. Informational only, not investment advice.

輸入參數tzbars必填bandsanchorincludeSeries

opening_range

Opening Range

Opening range (first N minutes) high/low/size for the latest session in your bars, breakout state, first breakout and 1x/2x extension targets. Read-only, never places orders. Informational only, not investment advice.

輸入參數tzbars必填minutessessionEndsessionStart

atr_stop

ATR Stop + Position Size

Wilder ATR, an ATR-multiple price level, and position size from account risk %. Read-only, never places orders. Informational only, not investment advice.

輸入參數bars必填sideentryperiodriskPctmultiplierpointValueaccountSize

backtest_opening_range_breakout

Opening-Range-Breakout Backtest

Opening-range-breakout backtest on your intraday bars: trades, win rate, avg R, total R, profit factor, max drawdown, exits, long/short split and recent trades. Read-only, never places orders. Informational only, not investment advice.

輸入參數rrtzbars必填stopminutesdirectionsessionEndcostPerTradesessionStart

版本歷史

3
  1. v0.1.15最新Nov 14, 2026
  2. v0.1.12Nov 11, 2026
  3. v0.1.5Nov 11, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Signals 整合