# stocks-llm (remote · stocks-llm.com)

Plain-English stock search joining congress and insider purchases with SEC fundamentals. Not advice.

- Trust score: 63/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

- remote · `stocks-llm.com`: 63/100 (this document), [markdown](https://verifymcp.io/servers/com-stocks-llm-stocks-llm/stocks-llm.md), [page](https://verifymcp.io/servers/com-stocks-llm-stocks-llm/stocks-llm)

## Channel facts

- Endpoint: `https://stocks-llm.com/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `0.1.1`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-21.

- **Endpoint Security**: 63/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 3 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 52/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 7351 tokens (~2450/item across 3 items; 3 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 13/100
  - Stability observed for 4 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 3 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 4 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 60/100
  - Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28.

## Install

### How do I install the stocks-llm MCP server?

stocks-llm is a hosted endpoint at https://stocks-llm.com/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http com-stocks-llm-stocks-llm 'https://stocks-llm.com/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "com-stocks-llm-stocks-llm": {
      "url": "https://stocks-llm.com/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "com-stocks-llm-stocks-llm": {
      "type": "http",
      "url": "https://stocks-llm.com/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.com-stocks-llm-stocks-llm]
url = "https://stocks-llm.com/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "com-stocks-llm-stocks-llm": {
      "type": "remote",
      "url": "https://stocks-llm.com/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add com-stocks-llm-stocks-llm --url 'https://stocks-llm.com/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  com-stocks-llm-stocks-llm:
    url: "https://stocks-llm.com/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "com-stocks-llm-stocks-llm": {
      "Transport": "http",
      "Url": "https://stocks-llm.com/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add com-stocks-llm-stocks-llm -t streamable-http -u 'https://stocks-llm.com/mcp'
```

### Other

```json
{
  "mcpServers": {
    "com-stocks-llm-stocks-llm": {
      "type": "http",
      "url": "https://stocks-llm.com/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-21 (score 63, +1)

No change was recorded against any check on this day. Stability & Change Management went from 10 to 13. That category is still filling its 30-day observation window: 3 days of observed history at the previous scan, 4 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-19 (score 62, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-18 (score 61, 0)

- [functional improvement] Stability: unverified → 0.03

### 2026-11-17 (score 61)

First indexed and scored.

## MCP tools (3)

### `search_companies` (~5558 tokens)

Natural-language / thematic search over the stocks-llm knowledge base of US public companies: S&P 500 + NASDAQ-100 + Dow Jones + Russell 1000 + Russell 2000 (deduped — effectively the Russell 3000 plus the Dow), spanning large-, mid-, AND small-cap companies, plus the major US exchange-traded funds (ETFs). UK public companies: the FTSE 350 (FTSE 100 + FTSE 250), listed on the London Stock Exchange. Data: SEC EDGAR filings + market-data fundamentals, each figure dated. Informational only, NOT financial advice. Matches a plain-English THEME (e.g. "high-power semiconductor devices", "GLP-1 diabetes drugs") against each company's enriched business summary, products/technologies and theme tags — not just its sector. Returns real DB companies with dated performance numerics (price + price_as_of, market_cap, price_return_1y, revenue_growth_yoy, net_margin) and dividend facts. Use `sort` to RANK the matched set and the filters to narrow it.

Input parameters:

- `below_price_target` (boolean): true = only companies whose MEAN ANALYST PRICE TARGET is above the last close ("trading below their analyst price target"). Rows carry price_target_mean + price_target_as_of; always give the target i…
- `cluster_buying` (boolean): SPEC BF.2: true = only companies with an OPEN-MARKET insider CLUSTER buy — at least 3 DISTINCT insiders each with a SEC Form 4 code-P purchase of the same stock within a rolling 30-day window (scanne…
- `composite_screen` (string): SPEC EJ.7: run ONE named screen whose selection combines several sources, and which stocks-llm.com also publishes as a page — the same set in the same order. Do not approximate one from a single filt…
- `congress_buying` (boolean): SPEC AP: true = only companies with at least one disclosed U.S. House STOCK-Act (PTR) PURCHASE in the trailing ~90 days (override with congress_window_days). Disclosures lag the trade by up to 45 day…
- `congress_selling` (boolean): SPEC AP: true = only companies with at least one disclosed U.S. House STOCK-Act (PTR) SALE in the trailing ~90 days. Sales may be planned / non-discretionary — never a bearish signal.
- `congress_window_days` (integer): Trailing window in days for congress_buying / congress_selling (default 90, 1..365). The congress_* SORTS use their own fixed 90/180-day windows.
- `dir` (string): SPEC CR.1 sort DIRECTION. Omit for the key default. dir="desc" with sort=pe_ratio = "highest / most expensive P/E"; dir="asc" with sort=price_return_1y = "worst performing". Ignored for congress / sh…
- `filing_change_section` (string): SPEC BF.7: optional scope for has_recent_filing_change — "risk_factors" for new risk disclosures, "mdna" for MD&A changes. Omit to match either section.
- `has_recent_filing_change` (boolean): SPEC BF.7: true = only companies with a successfully-generated, source-cited summary of CHANGES between their two most recent comparable SEC filings (10-K/10-Q). Pair with filing_change_section. get_…
- `held_by_manager` (string): SPEC BF.6: restrict to companies for which an investment manager whose NAME contains this substring reported an SEC Form 13F-HR holding (e.g. held_by_manager="BlackRock", "Berkshire", "Vanguard"). Ca…
- `in_djia` (boolean): SPEC HJ.3: true = only companies flagged as constituents of the Dow Jones Industrial Average. Send true or omit — false is not "not in the index", it is the absence of the filter. Membership as of th…
- `in_nasdaq100` (boolean): SPEC HJ.3: true = only companies flagged as constituents of the NASDAQ-100. Send true or omit — false is not "not in the index", it is the absence of the filter. Membership as of the last quarterly i…
- `in_russell1000` (boolean): SPEC HJ.3: true = only companies flagged as constituents of the Russell 1000. Send true or omit — false is not "not in the index", it is the absence of the filter. Membership as of the last quarterly…
- `in_russell2000` (boolean): SPEC HJ.3: true = only companies flagged as constituents of the Russell 2000. Send true or omit — false is not "not in the index", it is the absence of the filter. Membership as of the last quarterly…
- `in_sp500` (boolean): SPEC HJ.3: true = only companies flagged as constituents of the S&P 500. Send true or omit — false is not "not in the index", it is the absence of the filter. Membership as of the last quarterly inde…
- `insider_buying` (boolean): SPEC Y: true = only companies with at least one OPEN-MARKET insider PURCHASE (SEC Form 4 code P) in the trailing ~90 days. Use for "recent insider buying / insiders buying" queries. Excludes option e…
- `insider_selling` (boolean): SPEC Y: true = only companies with at least one OPEN-MARKET insider SALE (SEC Form 4 code S) in the trailing ~90 days. Sales may be planned / non-discretionary (Rule 10b5-1) — never present as a bear…
- `insider_window_days` (integer): Trailing window in days for insider_buying / insider_selling (default 90, 1..365). Only affects those two filters.
- `limit` (integer): Max results (default 10, hard cap 50).
- `market` (string): Scope the search to one market. Defaults to US when omitted. An unknown value is returned as a tool error naming the known markets, never silently defaulted — a machine client that asked for a market…
- `max_debt_to_equity` (number): Ceiling on debt-to-equity. Each row states its own basis: filed borrowings (leases excluded) / equity at a dated balance sheet where we derived it, else the market-data vendor figure with its date. N…
- `max_dividend_yield` (number): CEILING on indicated dividend yield (PERCENT): only companies at or BELOW this value. Send it WITH min_dividend_yield for a two-sided range — "indicated dividend yield between X and Y" is ONE call wi…
- `max_fcf_margin` (number): CEILING on free-cash-flow margin (PERCENT): only companies at or BELOW this value. Send it WITH min_fcf_margin for a two-sided range — "free-cash-flow margin between X and Y" is ONE call with min_fcf…
- `max_free_cash_flow_absolute` (number): CEILING on free cash flow (absolute dollars, latest fiscal year): only companies at or BELOW this value. Send it WITH min_free_cash_flow_absolute for a two-sided range — "free cash flow (absolute dol…
- `max_gross_margin` (number): CEILING on gross margin (PERCENT): only companies at or BELOW this value. Send it WITH min_gross_margin for a two-sided range — "gross margin between X and Y" is ONE call with min_gross_margin=X and…
- `max_market_cap` (number): Ceiling on market cap in USD (e.g. 2000000000 for "small-cap" <= $2B). Pair with min_market_cap for a band. Null-safe (missing cap excluded).
- `max_net_margin` (number): CEILING on net profit margin (PERCENT): only companies at or BELOW this value. Send it WITH min_net_margin for a two-sided range — "net profit margin between X and Y" is ONE call with min_net_margin=…
- `max_operating_cash_flow` (number): CEILING on operating cash flow (absolute dollars, latest fiscal year): only companies at or BELOW this value. Send it WITH min_operating_cash_flow for a two-sided range — "operating cash flow (absolu…
- `max_operating_margin` (number): CEILING on operating margin (PERCENT): only companies at or BELOW this value. Send it WITH min_operating_margin for a two-sided range — "operating margin between X and Y" is ONE call with min_operati…
- `max_pb_ratio` (number): Ceiling on price/book.
- `max_pe_ratio` (number): Ceiling on P/E (trailing, or latest fiscal year where pe_ratio_note says so).
- `max_peg_ratio` (number): CEILING on PEG ratio: only companies at or BELOW this value. Send it WITH min_peg_ratio for a two-sided range — "PEG ratio between X and Y" is ONE call with min_peg_ratio=X and max_peg_ratio=Y, never…
- `max_price_return_1y` (number): CEILING on 1-year price return (PERCENT): only companies at or BELOW this value. Send it WITH min_price_return_1y for a two-sided range — "1-year price return between X and Y" is ONE call with min_pr…
- `max_price_target_mean` (number): CEILING on mean analyst price target (in USD): only companies at or BELOW this value. Send it WITH min_price_target_mean for a two-sided range — "mean analyst price target between X and Y" is ONE cal…
- `max_revenue_cagr_3y` (number): CEILING on 3-year revenue CAGR (PERCENT): only companies at or BELOW this value. Send it WITH min_revenue_cagr_3y for a two-sided range — "3-year revenue CAGR between X and Y" is ONE call with min_re…
- `max_roa` (number): CEILING on return on assets (PERCENT): only companies at or BELOW this value. Send it WITH min_roa for a two-sided range — "return on assets between X and Y" is ONE call with min_roa=X and max_roa=Y,…
- `min_debt_to_equity` (number): Floor on debt-to-equity (same definition) for "most leveraged" queries.
- `min_dividend_streak` (number): Floor on dividend_streak_years — consecutive recent fiscal years with a paid, non-decreasing per-share dividend (from SEC XBRL; a FLOOR, not the full history).
- `min_dividend_yield` (number): FLOOR on indicated dividend yield (PERCENT). THIS IS THE KEY FOR A YIELD THRESHOLD: "3% or more dividend" is min_dividend_yield=3, not 0.03, and not sort=dividend_yield (a ranking answers "the highes…
- `min_fcf_margin` (number): FLOOR on free-cash-flow margin (PERCENT). "free cash flow margin above 15%" is min_fcf_margin=15. This is the RATIO; for a threshold in DOLLARS use min_free_cash_flow_absolute. Companies missing the…
- `min_free_cash_flow_absolute` (number): FLOOR on free cash flow (absolute dollars, latest fiscal year). "more than $1B of free cash flow" is min_free_cash_flow_absolute=1000000000. DOLLARS, not a margin. Companies missing the metric are ex…
- `min_gross_margin` (number): FLOOR on gross margin (PERCENT). "gross margin above 60%" is min_gross_margin=60. Companies missing the metric are excluded (null-safe).
- `min_market_cap` (number): Floor on market cap in USD (e.g. 10000000000 for $10B+).
- `min_net_margin` (number): FLOOR on net profit margin (PERCENT). "net margin above 20%" is min_net_margin=20. Accepts a negative floor. Companies missing the metric are excluded (null-safe).
- `min_operating_cash_flow` (number): FLOOR on operating cash flow (absolute dollars, latest fiscal year). "over $500M of operating cash flow" is min_operating_cash_flow=500000000. Companies missing the metric are excluded (null-safe).
- `min_operating_margin` (number): FLOOR on operating margin (PERCENT). "operating margin over 30%" is min_operating_margin=30. Companies missing the metric are excluded (null-safe).
- `min_pb_ratio` (number): Floor on price/book for "premium-valued" queries.
- `min_pe_ratio` (number): Floor on P/E (trailing, or latest fiscal year where pe_ratio_note says so) for "expensive / high-multiple" queries.
- `min_peg_ratio` (number): FLOOR on PEG ratio. THIS IS THE KEY FOR A PEG THRESHOLD: "PEG below 1" is max_peg_ratio=1 and "PEG above 2" is min_peg_ratio=2. The figure is OUR derived PEG — trailing P/E divided by the compound an…
- `min_price_return_1y` (number): FLOOR on 1-year price return (PERCENT). THIS IS THE KEY FOR A SHARE-PRICE THRESHOLD over the trailing year: "stocks up more than 10%" is min_price_return_1y=10. Do NOT reach for a revenue or earnings…
- `min_price_target_mean` (number): FLOOR on mean analyst price target (in USD). A floor on the mean analyst target in dollars per share. For "trading BELOW its target" use below_price_target, which compares the target to the price — t…
- `min_purity` (string): Minimum purity tier for theme_category (default "significant"). pure_play = the category IS the core business; significant = a major named segment; adjacent = supplies into/serves the category; incid…
- `min_revenue_cagr_3y` (number): FLOOR on 3-year revenue CAGR (PERCENT). "revenue compounding at 20%+ over three years" is min_revenue_cagr_3y=20. This is the 3-year CAGR, a different figure from min_revenue_growth_yoy (this year al…
- `min_revenue_growth_yoy` (number): FLOOR on year-over-year revenue growth PERCENT ("triple digit growth" = 100). Use this rather than putting the threshold in `query`: a text search matches whichever companies use the words, not every…
- `min_roa` (number): FLOOR on return on assets (PERCENT). "return on assets over 10%" is min_roa=10. Distinct from min_roe. Companies missing the metric are excluded (null-safe).
- `min_roe` (number): Floor on return-on-equity PERCENT (e.g. 15).
- `min_roic` (number): Floor on return-on-invested-capital PERCENT. Each row states its own basis: NOPAT / (debt + equity - cash) from its 10-K fiscal year where we derived it (EBIT = pre-tax income + interest expense wher…
- `min_short_interest_pct_outstanding` (number): SPEC EI.3: minimum reported FINRA short interest as a PERCENT OF SHARES OUTSTANDING at the latest settlement date (send 30 for "over 30% short interest", NOT 0.30). Percent of shares OUTSTANDING, not…
- `pays_dividend` (boolean): true = only companies flagged as paying a dividend.
- `profitable` (boolean): true = only companies with a positive net margin.
- `query` (string, required): The theme / what the company does, in plain words (e.g. "cloud infrastructure", "silicon carbide power devices").
- `sector` (string): Restrict to one exact GICS sector.
- `sort` (string): How to rank the semantically-matched set. "relevance" (default), or one of: price_return_1y, revenue_growth_yoy, market_cap, net_margin, gross_margin, operating_margin, roe, roa, roic, fcf_margin, di…
- `theme_category` (string): SPEC AG.3: restrict to companies STRUCTURALLY classified into this fixed taxonomy category (enrichment-time purity classification, not free-text matching). Use whenever the user asks for companies IN…

### `get_company_profile` (~1373 tokens)

Full enriched profile for ONE company (mirrors the /company/{ticker} page): name, ticker, sector, the LLM business summary + one-line pitch, key fundamentals (price + as-of date, market cap, margins, ROE/ROA, valuation), dividend facts, competitors, plus its latest SEC filings — the DATED evidence you cite. May also include `insider_cluster_buying`: a dated open-market cluster-buy DISCLOSURE fact (≥3 distinct insiders each buying, SEC code P, within a 30-day window; disclosed Form 4 activity, not a prediction or buy signal; only when one qualifies). May also include `sector_percentiles`: where the company's metrics (P/E, margins, ROE, growth, yield, absolute FCF) sit relative to covered peers in the same sector, each with a summary + peer count + as-of date (a relative position, not a valuation/quality judgment; only when rankable). May also include `long_term_picture`: business quality, price vs fundamentals, long-run trend and cash returned as x/10 from the published Top 10 pillars, with a summary sentence (a published formula, not advice). May also include `valuation_context`: today's P/E, P/S, P/FCF against the company's own fiscal-year range and a reverse DCF's implied free-cash-flow growth (a simple model, not a price target). May also include `dividend_safety`: a single-fiscal-year dividend-coverage assessment from SEC XBRL (earnings + free-cash-flow payout ratios; outcome supported/stretched/not_assessable/stale_dividend_data; past coverage, not a forecast; only when the company paid a dividend). `stale_dividend_data` means the latest fiscal year with a reported dividend payment is OLDER than the latest year of reported accounts (`latest_financials_fiscal_year`), so no ratio is given — do not infer from it that the dividend was cut, nor that the data is missing. May also include `filing_changes`: an AI-assisted, source-bounded comparison of the two most-recent same-form SEC filings (Risk Factors / MD&A additions, removals, wording changes) with each side's…

Input parameters:

- `name` (string): Company name (used if ticker is unknown).
- `ticker` (string): Ticker, e.g. NVDA (preferred).

### `compare_companies` (~255 tokens)

Head-to-head comparison of TWO companies (mirrors the /compare/{a}-vs-{b} page): the same real, dated side-by-side metrics — price, market cap, P/E, PEG, margins, ROE/ROA, debt/equity, revenue growth, dividend yield + streak, beta, 1-year return — plus each company's one-line pitch. A metric absent for either company is returned as null (never fabricated). Both tickers must be in the covered universe: US public companies: S&P 500 + NASDAQ-100 + Dow Jones + Russell 1000 + Russell 2000 (deduped — effectively the Russell 3000 plus the Dow), spanning large-, mid-, AND small-cap companies, plus the major US exchange-traded funds (ETFs). UK public companies: the FTSE 350 (FTSE 100 + FTSE 250), listed on the London Stock Exchange. Data: SEC EDGAR filings + market-data fundamentals, each figure dated. Informational only, NOT financial advice.

Input parameters:

- `ticker_a` (string, required): First ticker, e.g. AAPL.
- `ticker_b` (string, required): Second ticker, e.g. MSFT.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/com-stocks-llm-stocks-llm/stocks-llm#diagnostics

## Score history

- 2026-11-21: 63
- 2026-11-20: 62
- 2026-11-19: 62
- 2026-11-18: 61
- 2026-11-17: 61

## Common questions

### What is the stocks-llm MCP server?

stocks-llm is an MCP server listed in the public MCP registry as com.stocks-llm/stocks-llm. Plain-English stock search joining congress and insider purchases with SEC fundamentals. Not advice. This page covers its hosted endpoint (https://stocks-llm.com/mcp).

### Is the stocks-llm MCP server safe to use?

stocks-llm scores 63 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the stocks-llm MCP server expose?

stocks-llm exposes 3 tools: search_companies, get_company_profile, compare_companies. Their descriptions and schemas cost roughly 7,186 tokens of context every time the server is loaded.

### Does the stocks-llm MCP server require authentication?

No. We connected to stocks-llm without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the stocks-llm MCP server still maintained?

stocks-llm is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What did VerifyMCP test on the stocks-llm MCP server?

VerifyMCP ran 12 checks on stocks-llm, covering TLS certificate, HTTPS, HSTS header, DNSSEC and 8 more. One item could not be completed, a gap on our side rather than a finding about stocks-llm: Authorization. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- Remote endpoint: https://stocks-llm.com/mcp
- Website: https://stocks-llm.com/mcp-integration?utm_source=mcp-registry&utm_medium=directory
- Changelog RSS feed: https://verifymcp.io/servers/com-stocks-llm-stocks-llm/stocks-llm.xml
- Changelog JSON feed: https://verifymcp.io/servers/com-stocks-llm-stocks-llm/stocks-llm/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/com-stocks-llm-stocks-llm/stocks-llm.json
- HTML version of this page: https://verifymcp.io/servers/com-stocks-llm-stocks-llm/stocks-llm
