# io.github.gdietsch/trading-signals-mcp

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

- name: io.github.gdietsch/trading-signals-mcp
- version: 0.1.15
- connection class: R0 (autonomous)
- trust: 94/100
- quality: 89/100 (new)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.gdietsch%2Ftrading-signals-mcp
- tools: https://api.protogrid.dev/v1/servers/io.github.gdietsch%2Ftrading-signals-mcp/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "trading-signals-mcp": {
      "type": "http",
      "url": "https://signals.incomefather.com/mcp",
      "headers": {
        "Authorization": "Bearer ${TRADING_SIGNALS_MCP_TOKEN}"
      }
    }
  }
}
```

Placeholders to fill: `${TRADING_SIGNALS_MCP_TOKEN}`.

## Trust

- hygiene: 100
- liveness: 100
- freshness: 100
- provenance: 80
- drivers: +repository +namespace-matches-repo +reachable +uptime-100% +updated-0d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 89/100 (new)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 100 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 21 of 21 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 5,903 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump
- pass `tools.hidden_text`: no hidden text in tool names, descriptions, schemas or annotations

### stability: n/a (weight 15)

- n/a `stability.changes`, `stability.rug_pull`, `stability.new_links`: tool history recorded for 2 of the 7 days needed

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: dependencies not resolved yet

- tools: 21, about 5,903 tokens to load them all
- tool set hash: c8c78f18a0b164f2d61b45627387a20f
- tools last changed: 2026-11-14T00:53:08.706Z
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.gdietsch/trading-signals-mcp.svg)](https://protogrid.dev/servers/io.github.gdietsch/trading-signals-mcp)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-11-14 `whale_flow` added
  - 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.
- 2026-11-14 `solana_token_verdict` changed (description) **meaning changed**
  - before: Safe / caution / avoid verdict (plus A-F grade and plain reasons) for a Solana SPL or Token-2022 mint: mint and freeze authority (renounced or not), supply, Token-2022 risk extensions (transfer fee, transfer hook, permanent delegate, non-transferable, default-frozen, pausable), DEX liquidity, first-pool age, holder concentration and a live ~$1k sell-route test to USDC with price impact. Includes a timestamp and sources. Heuristic, not a security audit. Read-only, never places orders. Informational only, not investment advice.
  - after: 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.
- 2026-11-14 `token_verdict` changed (description) **meaning changed**
  - before: A-F safety verdict for a Base ERC-20: metadata and supply, owner/renounced, upgradeable-proxy check, Uniswap/Aerodrome liquidity vs WETH/USDC, buy→sell honeypot simulation with taxes, known-holder concentration. Read from Base mainnet. Read-only, never places orders. Informational only, not investment advice.
  - after: 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.
- 2026-11-11 `backtest_opening_range_breakout` changed (description, annotations) **meaning changed**
  - before: 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. Works with no key (small daily allowance) or with a Trading Signals Toolkit API key (free 100 calls/month, Starter, Pro). Pay-per-call equivalent: $0.02 USDC over x402. Informational only, not investment advice.
  - after: 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.
- 2026-11-11 `atr_stop` changed (description, inputSchema, annotations) **meaning changed**
  - before: Wilder ATR, ATR-multiple stop price and position size from account risk %. Works with no key (small daily allowance) or with a Trading Signals Toolkit API key (free 100 calls/month, Starter, Pro). Pay-per-call equivalent: $0.005 USDC over x402. Informational only, not investment advice.
  - after: Wilder ATR, an ATR-multiple price level, and position size from account risk %. Read-only, never places orders. Informational only, not investment advice.
- 2026-11-11 `opening_range` changed (description, annotations) **meaning changed**
  - before: Opening range (first N minutes) high/low/size for the latest session in your bars, breakout state, first breakout and 1x/2x extension targets. Works with no key (small daily allowance) or with a Trading Signals Toolkit API key (free 100 calls/month, Starter, Pro). Pay-per-call equivalent: $0.005 USDC over x402. Informational only, not investment advice.
  - after: 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.
- 2026-11-11 `vwap_bands` changed (description, annotations) **meaning changed**
  - before: VWAP with standard-deviation bands from your OHLCV bars (session-anchored or full), z-score and band position. Works with no key (small daily allowance) or with a Trading Signals Toolkit API key (free 100 calls/month, Starter, Pro). Pay-per-call equivalent: $0.005 USDC over x402. Informational only, not investment advice.
  - after: 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.
- 2026-11-11 `sec_13f_holders` added
  - 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.
- 2026-11-11 `sec_13f_holdings` added
  - 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.
- 2026-11-11 `insider_clusters` changed (description)
  - before: 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. Works with no key (small daily allowance) or with a Trading Signals Toolkit API key (free 100 calls/month, Starter, Pro). Pay-per-call equivalent: $0.02 USDC over x402. Informational only, not investment advice.
  - after: 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.

Full history: https://api.protogrid.dev/v1/servers/io.github.gdietsch%2Ftrading-signals-mcp/changes

## Dependencies

- npm x402-trading-signals-mcp@0.1.15: pending

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0.

## Remotes

- https://signals.incomefather.com/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

- npm x402-trading-signals-mcp@0.1.15 secrets: X402_PRIVATE_KEY

## Tools (21)

- `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.
- `atr_stop`: Wilder ATR, an ATR-multiple price level, and position size from account risk %. Read-only, never places orders. Informational only, not investment advice.
- `backtest_opening_range_breakout`: 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.
- `cot_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.
- `event_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.
- `event_study`: 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.
- `insider_buys`: 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.
- `insider_clusters`: 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.
- `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.
- `pre_trade_check`: 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.
- `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.
- `sec_13f_holders`: 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.
- `sec_13f_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.
- `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.
- `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.
- `token_pre_trade`: 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.
- `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.
- `treasury_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.
- `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.
- `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.
- `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.
