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 集成