TickerRisk MCP server

TickerRisk MCP Server

Check an options trade for hidden catalysts before you sell premium — from inside Claude, ChatGPT, or Cursor.

An MCP server that lets an AI assistant answer questions like "is it safe to sell a 30-day put on HPE?" with real event data instead of a guess.

The problem it solves: a fat option premium is usually the market pricing in a known upcoming event — an earnings report, an FDA decision, a court date — not free money. Some screeners flag earnings; few check the wider event calendar. This one scores every candidate across earnings, FDA, legal, SEC and clinical events landing inside the expiry window, and filters out the traps.

You:    Is it safe to sell a 4-week put on INTC?

Claude: [calls scan_ticker]
        INTC scores 100/100 (HIGH) over a 4-week window. Earnings land in 4 days,
        inside your expiry. The premium is pricing that gap — 279% annualized on
        the $88 put is compensation for event risk, not an edge.

Why this is different

Risk is horizon-dependent, and that is the whole point. The same stock:

Sell a weekly and you are fine. Sell a monthly on the same ticker and you have sold straight through an earnings report. A screener that shows one number cannot tell you that.

Install

Claude Desktop

Add to your claudedesktopconfig.json:

macOS/Linux — ~/Library/Application Support/Claude/claudedesktopconfig.json Windows — %APPDATA%\Claude\claudedesktopconfig.json

{
  "mcpServers": {
    "tickerrisk": {
      "command": "uvx",
      "args": ["tickerrisk-mcp"]
    }
  }
}

Restart Claude Desktop. You should see the TickerRisk tools in the tool menu.

Claude Code

claude mcp add tickerrisk -- uvx tickerrisk-mcp

Cursor

In ~/.cursor/mcp.json:

{
  "mcpServers": {
    "tickerrisk": { "command": "uvx", "args": ["tickerrisk-mcp"] }
  }
}

From source

git clone https://github.com/Tickerrisk/tickerrisk-mcp
cd tickerrisk-mcp
pip install -e .
tickerrisk-mcp

Tools

scanticker(ticker, expiryweeks=4)

Returns a 0–100 catalyst-risk score (higher = riskier) with the events driving it: earnings date and whether it falls in the window, FDA/clinical milestones, legal filings, SEC events, implied volatility, IV Rank, and the expected move.

Bands: ≥70 HIGH · 45–69 MEDIUM · <45 LOW

findwheelcandidates(week, risk, maxrisk, minput_oi, sector, limit)

Scans the S&P 500 for cash-secured puts and returns only names whose catalyst score over the option's own expiry window is under max_risk. Flags any candidate whose earnings land before expiry.

findcoveredcalls(week, risk, maxrisk, mincall_oi, sector, limit)

Same gating for the call side. Income is computed from time value only, so in-the-money strikes do not show inflated yields.

comparetickers(tickers, expiryweeks=4)

Side-by-side catalyst risk for up to 25 symbols on one horizon.

Access and authentication

No signup needed to start. Access follows tickerrisk.com's normal model:

read cached data and stay available

• First 24 hours — full access, no account, keyed to your IP
• After that — a free account at tickerrisk.com adds 14 days
• The strategy scanners (findwheelcandidates, findcoveredcalls, compare_tickers)

Shortened. The full README is on GitHub.