@dehy-mcp/server

The MCP server for live SEC insider intelligence.

@dehy-mcp/server plugs DEHY's real-time SEC filing pipeline directly into any AI assistant that speaks the Model Context Protocol — Claude Desktop, Claude Code, Cursor, Continue, the OpenAI desktop app, Perplexity Comet, anywhere MCP lands next.

Ask your AI assistant "give me the Dehy view on NVDA" and it answers with structured data — insider trades scored 0–100, institutional flow with quarter-over-quarter deltas, executive transitions, Congress PTRs, fundamentals, and the price chart — all in one round-trip.

What this gives your assistant

21 read-only tools on top of the DEHY REST API, organized by what the model would reach for.

Per-ticker briefings

| Tool | What it surfaces | | --- | --- | | get_ticker_view | The killshot. One call returns issuer profile, price history, recent Form 4s with DEHY Scores, top 20 institutional holders with QoQ deltas, material 8-Ks, 13D/G activist stakes, last 4 earnings reports, Insider Conviction Index, and SEC Company Facts fundamentals (revenue TTM, EPS, market cap inputs). ~8,950 US-listed tickers. | | get_watchlist_intel | Per-user briefing scoped to the API key — every material SEC event over the last 7 days on every watched ticker, plus upcoming earnings in the next 14 days. |

Filings & DEHY Score

| Tool | What it surfaces | | --- | --- | | list_recent_filings | Newest Form 4 / 144 / 10-K / 10-Q / 8-K filings, with attached DEHY Score where available. | | get_filing | Full payload for one filing by accession number — header, issuer, reporter, every transaction row, sub-scores. | | get_filing_diff | AI-annotated section-by-section diff between two consecutive 10-Q / 10-K filings (added / removed / strengthened / weakened material). | | top_dehy_scores | Highest-conviction Form 4s across the universe. | | get_insider_alpha | A filer's historical batting average — median 30 / 90 / 180-day forward returns, 90-day win rate. | | get_reporter_leaderboard | ~1,150 reporters ranked by realized timing. Sortable by decisive score, win-rate, or activity; filterable to buyers / sellers. |

Compliance-grade insider surface

| Tool | What it surfaces | | --- | --- | | get_insider_register | Officers trading under Rule 10b5-1 plans in a rolling 24-month window. Each row carries plan-attributed notional, transaction count, largest plan sale, and a cadence-CV flag for irregular execution. | | get_csuite_changes | Recent CEO / CFO / COO / Chair / Director transitions parsed from 8-K Item 5.02. High-confidence filter on by default. |

Institutional flow (13F)

| Tool | What it surfaces | | --- | --- | | get_13f_changes | Largest institutional position changes for the latest reporting period — NEW / CLOSED / INCREASED / DECREASED. | | get_13f_filer | Profile for one manager by CIK — name, address, latest holdings, quarter-by-quarter history. | | get_13f_owners | Every 13F filer reporting a given security, ranked by USD value. Looked up by CUSIP. |

Macro & CFTC

| Tool | What it surfaces | | --- | --- | | get_cot_markets | Latest CFTC Commitments of Traders snapshot — non-commercial vs commercial positioning across futures markets. | | get_cot_history | Weekly positioning time-series for one market (up to 10 years). | | get_macro_commodities | Live WTI / Brent / nat gas / dollar index with 24h % change. | | get_macro_stress_signals | Active energy-stress signals — moments when commodities crossed a 4–6% 24h threshold, a tier-1 geopolitical event landed, or both. | | get_macro_stress_context | Full context payload for one stress signal — triggers, anchor prices, historical analogs. | | get_macro_events | Recent classified macro events (geopolitical + price shocks), regardless of signal attachment. |

Other

| Tool | What it surfaces | | --- | --- | | get_congress_trades | Recent Periodic Transaction Reports from US House Members. Filterable by ticker, member, transaction type. Senate ingest pending. | | get_earnings_upcoming | Projected upcoming earnings release dates for every US public issuer, computed from median report cadence. |

Each tool's input schema, description, and example call is advertised to the model on connection — no documentation lookup needed.

Install

You need a DEHY API key. Mint one at dehy.io/settings. Then add to your MCP client config.

Claude Desktop

Edit claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/):

{
  "mcpServers": {
    "dehy": {
      "command": "npx",
      "args": ["-y", "@dehy-mcp/server"],
      "env": {
        "DEHY_API_KEY": "dh_live_..."
      }
    }
  }
}

Restart Claude Desktop. The 21 DEHY tools appear in the tools panel.

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "dehy": {
      "command": "npx",
      "args": ["-y", "@dehy-mcp/server"],
      "env": { "DEHY_API_KEY": "dh_live_..." }
    }
  }
}

Claude Code

claude mcp add dehy --env DEHY_API_KEY=dh_live_... -- npx -y @dehy-mcp/server

Any other MCP-aware client

Standard stdio transport. Spawn npx -y @dehy-mcp/server with DEHY_API_KEY in the environment.

Example prompts

"Give me the Dehy view on NVDA."

"Who's selling under 10b5-1 plans right now?"

"Any recent CFO changes in tech this month?"

"Show me the highest DEHY Scores this week."

"What's on my watchlist today?"

"Diff Apple's latest 10-K Risk Factors against the prior one."

"Which hedge funds just opened new positions this quarter?"

"How has hedge-fund positioning in gold changed over the last six months?"

"Has the insider with CIK 0001582779 had good timing on his prior sells?"

"Who in Congress traded $NVDA recently?"

The assistant picks the right DEHY tool (or chains several in parallel), makes the call, and renders the result.

Configuration

| Env var | Purpose | Required | | --- | --- | --- | | DEHY_API_KEY | Bearer token from dehy.io/settings | Yes | | DEHY_API_BASE_URL | Override the API base — defaults to https://dehy.io/api/v1 | No |

What this is not

• It's not an alpha generator. Tools are read-only — no orders, no positions, no auto-trading. You ask the AI questions; the AI gets honest data. The DEHY Score is a triage signal for what to read first, not a price-prediction claim. The published methodology documents the live backtest.
• It's not the underlying ingestion pipeline. That lives at github.com/dehyzzayd/dehy-fin. This package is the thin adapter that exposes the public REST API over the MCP protocol.
• It's not a replacement for a Bloomberg terminal. It's the part of the terminal a curious investor or junior analyst would actually use, surfaced where they already work — for $99/month instead of $24,000/year.

License

MIT.