Skip to main content
Glama
TickerRisk MCP Server

TickerRisk MCP Server

by Tickerrisk

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:

Ticker

1-week window

4-week window

Why it changes

AAPL

51 (MEDIUM)

97 (HIGH)

Earnings sit in week 3

KO

22 (LOW)

62 (MEDIUM)

Earnings enter the window

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.

Related MCP server: RiskLens MCP

Install

Claude Desktop

Add to your claude_desktop_config.json:

macOS/Linux — ~/Library/Application Support/Claude/claude_desktop_config.json Windows — %APPDATA%\Claude\claude_desktop_config.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

Tool

What it answers

scan_ticker

"How risky is selling an option on X over the next N weeks?"

find_wheel_candidates

"What cash-secured puts can I sell this week without an earnings trap?"

find_covered_calls

"What calls can I sell against shares I already own?"

compare_tickers

"Which of these stocks is safest to sell premium on right now?"

scan_ticker(ticker, expiry_weeks=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

find_wheel_candidates(week, risk, max_risk, min_put_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.

find_covered_calls(week, risk, max_risk, min_call_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.

compare_tickers(tickers, expiry_weeks=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:

  • 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 (find_wheel_candidates, find_covered_calls, compare_tickers) read cached data and stay available

To authenticate an existing account, set a token:

{
  "mcpServers": {
    "tickerrisk": {
      "command": "uvx",
      "args": ["tickerrisk-mcp"],
      "env": { "TICKERRISK_TOKEN": "your-jwt-here" }
    }
  }
}

Environment variables

Variable

Default

Purpose

TICKERRISK_TOKEN

(none)

JWT for an existing account

TICKERRISK_BASE_URL

https://tickerrisk.com

Override the API host

TICKERRISK_TIMEOUT

45

Request timeout in seconds

Data and limitations

Being straight about what this is and is not:

  • Catalyst data — earnings dates, SEC filings, court records (CourtListener), ClinicalTrials.gov, and news. Public sources, so incomplete or delayed entries happen.

  • Option premiums are indicative, not live NBBO. Quotes are roughly 15 minutes delayed and estimated where no bid exists (marked in the output). Always confirm in your broker before trading.

  • Outside US market hours (9:30–16:00 ET) quotes go stale and candidate lists thin out. This is upstream data reality, not a bug.

  • The score is not a prediction. It measures scheduled event exposure and volatility. A LOW score does not mean a stock cannot drop; it means no known catalyst was found in that window.

Not financial advice. For research only.

How it compares

Being accurate about this, because the differentiator is narrower than most tools claim:

Earnings-date checking is not unique. Barchart's options screener has a "Flag Earnings" option that marks contracts whose next earnings date falls on or before expiration. Market Chameleon tracks biotech catalysts and links them to option chains. If earnings alone is what you need, those are mature tools with real-time data and far more filters — use them.

What this tool does differently is combine five event types — earnings, FDA decisions, legal filings, SEC events and clinical milestones — into a single 0–100 score tied to your expiry window, and filter on it by default rather than showing an optional flag column. Court records as an options-risk input in particular is something we have not found elsewhere.

So: if you want the deepest screener, use Barchart or Option Samurai. If you want one number that answers "is there anything scheduled inside this expiry", that is what this is.

License

MIT


mcp-name: io.github.PasiutusVovere/tickerrisk-mcp

Available Tools

4 tools
compare_tickersA

Compare catalyst risk across several stocks at once, over the same expiry window.

Use this when someone is choosing between tickers to sell options on, or asks which of several stocks is the safest bet for a given expiry.

Faster than scanning one at a time. Only returns tickers already in the cache (all S&P 500 names are); anything missing is listed so it can be scanned individually with scan_ticker.

Args: tickers: Comma-separated symbols, e.g. "AAPL, MSFT, NVDA". Up to 25. expiry_weeks: Expiry horizon in weeks (1-52), applied to every ticker.

Inputs: tickers (required), expiry_weeks. Returns: result

find_covered_callsA

Find covered-call candidates that have no hidden catalyst in the expiry window.

Use this when someone asks what calls to sell against shares they own, for covered-call income ideas, or how to generate yield on a stock position.

Same catalyst gating as the wheel scanner. Income is computed from TIME VALUE only, so in-the-money strikes do not show inflated yields.

Args: week: Expiry bucket — "this", "next", "two", "three", "month", or "all". risk: "conservative" (further out of the money, more likely to keep the shares), "balanced", or "aggressive" (nearer the money, more premium, more likely to be called away). max_risk: Maximum catalyst-risk score to allow, 0-100. min_call_oi: Minimum call open interest, for tradeable results. sector: Optional GICS sector filter. Empty means all sectors. limit: How many candidates to return (1-25).

Inputs: risk, week, limit, sector, +2 more. Returns: result

find_wheel_candidatesA

Find cash-secured put candidates (the wheel strategy) that have no hidden catalyst in the expiry window.

Use this when someone asks what puts to sell this week, for wheel or cash-secured-put ideas, for "safe premium" to collect, or which stocks pay well without an earnings report coming up.

Scans the whole S&P 500 and returns only names whose catalyst-risk score over the option's own expiry window is under max_risk — so candidates with earnings, FDA decisions or legal events inside the window are filtered out rather than surfaced as fake high-yield opportunities.

Args: week: Expiry bucket — "this" (1-7 days), "next" (8-14), "two", "three", "month" (1-35), or "all" (up to 45 days). "all" returns the most results. risk: How close to the money to sell — "conservative" (~0.20 delta, further out, safer), "balanced" (~0.30), or "aggressive" (~0.40, more premium, more assignment risk). max_risk: Maximum catalyst-risk score to allow, 0-100. 55 is a sensible default; lower it to 40 for a stricter list. min_put_oi: Minimum put open interest, to keep results actually tradeable. Keep at 100 during market hours. sector: Optional GICS sector filter, e.g. "Technology", "Health Care", "Financials". Empty means all sectors. limit: How many candidates to return (1-25).

Inputs: risk, week, limit, sector, +2 more. Returns: result

scan_tickerA

Check how risky it is to sell or buy an option on a stock, over a specific expiry window.

Use this whenever someone asks whether it is safe to sell a put or a covered call on a ticker, whether a premium is "too good", what could gap a stock before expiry, or what catalysts are coming up for a company.

Returns a 0-100 catalyst-risk score (higher = riskier) plus the specific events driving it: earnings dates, FDA decisions, legal filings, SEC events, and the implied-volatility expected move. The key idea is that risk depends on the expiry window — a stock can be LOW risk for a 1-week option and HIGH risk for a 6-week option that spans an earnings report.

Args: ticker: Stock symbol, e.g. "AAPL", "HPE", "KO". expiry_weeks: How many weeks until the option expires (1-52). Match this to the actual trade being considered. Defaults to 4 (~30 DTE, the typical premium-selling horizon).

Inputs: ticker (required), expiry_weeks. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.6/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool targets a clearly distinct action: scan_ticker (single-ticker risk), compare_tickers (batch comparison), find_wheel_candidates (put screening), and find_covered_calls (call screening). The single-vs-batch and put-vs-call boundaries are explicit in the descriptions, leaving little room for misselection.

    Naming Consistency5/5

    All four names follow a consistent verb_noun snake_case pattern (scan_ticker, compare_tickers, find_wheel_candidates, find_covered_calls). The plural 'tickers' in compare is minor and still readable.

    Tool Count4/5

    Four tools is a lean but coherent surface where each earns its place, though it sits at the thin end of the ideal range. No obvious redundancy or bloat.

    Completeness4/5

    The workflow is well covered: single scan, multi-ticker comparison, and both screener directions (puts and calls), with missing tickers flagged for individual scanning. Minor gaps exist around analyzing existing positions or custom non-cached tickers, but agents can work around them.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables biopharma catalyst research by aggregating signals from ClinicalTrials.gov, PubMed, SEC EDGAR, openFDA, and Yahoo Finance, with a single tool to audit a ticker/drug combination and return a forensic verdict.
      10
      34 npm
      5
      ISC
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables risk analysis of US public companies by analyzing 8-K filings and insider activity using live SEC EDGAR data.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides macro-economic event data, earnings reports, and market overviews as MCP tools, enabling AI agents to query calendars, check event proximity, and assess trade safety.
      27 PyPI
      2
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables users to look up public company earnings dates and reporting windows by providing identifiers like ticker, domain, or CIK. It returns fiscal year end, next reporting date, and an outreach window, helping plan investor communications.
      5
      474 npm
      MIT