Deep Values
Server Details
Value investing for US stocks: SEC filings, 13F guru holdings, intrinsic value, AI briefings.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 30 tools
Most tools map to a clearly distinct resource (filings vs fundamentals vs news vs indicators_*), and the descriptions work hard to separate lookalikes such as brief vs research vs intrinsic_value. However, several pairs are functionally near-duplicates: guru_moves vs smart_money_changes describe the same material-13F-move feed, account vs keys_me return the same key/quota/balance payload, and mirror_brief is explicitly described as '/verdict flattened into a brief'. An agent can still be steered right by the prose, but only by reading long descriptions closely.
Everything is snake_case, which is consistent, but the pattern mixes bare resource nouns (account, brief, filings, verdict, theses) with noun_verb compounds (companies_search, webhooks_list, keys_me, credits_checkout) and inconsistent namespace forms — guru/gurus/guru_moves/guru_portfolio vs smart_money_changes/smart_money_holdings. Singular vs plural resource prefixes (account vs companies_, guru vs gurus) make the family grouping unpredictable.
At 30 tools this is a heavy surface for an agent to select from, well past the comfortable 3-15 range, and a meaningful fraction is redundant (guru_moves/smart_money_changes, account/keys_me, verdict/mirror_brief). Each tool corresponds to a real API endpoint so the breadth is defensible, but consolidation into fewer, parameterized tools would materially improve navigability.
Coverage of the core value-investing domain is strong: company search/overview, fundamentals, filings and point-in-time as-filed data, valuation (intrinsic_value/brief/verdict), research, 13F/guru data, macro indicators, news/sentiment/theses, plus billing and key management. The main gap is lifecycle asymmetry in the non-read areas — webhooks_list exists with no create/delete counterpart, and there is no write path for keys or account management beyond keys_create. Minor gaps an agent can mostly work around.
Available Tools
30 toolsaccountAccount info + current quota usageARead-onlyInspect
Returns the calling key, its scopes, environment, and today's usage across all 3 buckets. Self-billing: counts as 1 metadata call. (GET https://app.deepvalues.ai/api/v1/account — no charge; needs a connected account or a dv_sk_ key)
Inputs: no named parameters.
ai_contextDrop-in AI grounding context (DIFFERENTIATED)ARead-onlyInspect
Returns a system prompt + structured context block, scoped to one ticker. Drop it into OpenAI/Anthropic/any LLM SDK to ground your chatbot in current Deep Values data without months of plumbing. Bills 3 metadata units. (GET https://app.deepvalues.ai/api/v1/ai-context/{ticker}, e.g. https://app.deepvalues.ai/api/v1/ai-context/AAPL — 0.02 credits per call; works with no credentials up to 1 call(s)/day per address) Missing data? Call request_data.
Inputs: ticker (required), token_budget.
as_filedPoint-in-time fundamentals: what was filed as of a date, before restatementARead-onlyInspect
Call this when the question is about what was known on a past date (a backtest, an audit, "what did the 10-K say at the time"), not about the current restated figures. Returns, for each fiscal period filed on or before date, the value as it stood on that date (the original filing, or a later filing for the same period if it came before date), the filing date, the XBRL tag, a sec.gov link, and restated_after_date when a later filing changed it. Values are as printed, not split-adjusted. Inputs: ticker (path), date (YYYY-MM-DD, required), metrics (comma-separated snake_case names, default revenues,net_income,eps_diluted,operating_cash_flow,free_cash_flow,stockholders_equity,total_debt,shares_outstanding), period (annual|quarterly), limit (periods, default 4). Example: GET /as-filed/AAPL?date=2020-02-01&metrics=revenues,net_income. If the company had filed none of it by date, the answer has no periods, the flag nothing_filed_by_date and earliest_filed (the first filing date on record). A 503 as-filed-unavailable means there is no as-filed history for the company to answer from; it is not charged, and GET /fundamentals has the current figures. 0.02 credits. (GET https://app.deepvalues.ai/api/v1/as-filed/{ticker}, e.g. https://app.deepvalues.ai/api/v1/as-filed/AAPL?date=2020-02-01 — 0.02 credits per call; works with no credentials up to 5 call(s)/day per address) Missing data? Call request_data.
Inputs: date (required), ticker (required), limit, period, +1 more.
briefOne-call valuation brief: intrinsic value, margin of safety, verdict, guru holdersARead-onlyInspect
Call this first when asked whether a listed company looks cheap or expensive, what it is worth, or which well-known investors own it: one call returns the intrinsic value per share (with each valuation method as an input), the owner-earnings value, the margin of safety against the current price, a deterministic verdict sentence about where the price sits against our value range, the top tracked 13F holders and their last move, and the company profile. Every number carries its unit, period, as-of date and a sec.gov source link, and checks lists the sanity checks it passed. A value built from statements filed in another currency and converted to USD carries fx (original currency, rate, rate date) and passes currency_consistent; when the currency is not known the flag currency_unverified says the check did not run. If the valuation fails a check (for example an intrinsic value more than 20x the price, or statements left in a currency other than the USD price), the valuation figures are withheld, withheld is true, checks.failed names the check, and the call is not charged. Input: ticker (path), e.g. GET /brief/KO. The first brief each UTC day is at no charge per key and per keyless address; after that 0.25 credits. Same price as /research, a different product: brief is computed at call time from current figures; /research returns the latest written multi-analyst briefing. Data and analysis, not investment advice. (GET https://app.deepvalues.ai/api/v1/brief/{ticker}, e.g. https://app.deepvalues.ai/api/v1/brief/AAPL — 0.25 credits per call; works with no credentials up to 1 call(s)/day per address) Missing data? Call request_data.
Inputs: ticker (required).
companies_searchCompany searchCRead-onlyInspect
Company search (GET https://app.deepvalues.ai/api/v1/companies — 0.001 credits per call ($0.005 when paid per call over x402); works with no credentials up to 25 call(s)/day per address) Missing data? Call request_data.
Inputs: q, limit.
company_overviewCompany overviewARead-onlyInspect
Company overview (GET https://app.deepvalues.ai/api/v1/companies/{ticker}/overview, e.g. https://app.deepvalues.ai/api/v1/companies/AAPL/overview — 0.001 credits per call ($0.005 when paid per call over x402); works with no credentials up to 25 call(s)/day per address) Missing data? Call request_data.
Inputs: ticker (required).
credits_checkoutGet a Stripe Checkout URL that tops up this key’s balanceAInspect
Creates a one-time Stripe Checkout Session for a credit pack, bound to the calling live key’s account. When the payment completes the credits land on that balance; poll GET /keys/me. This is what a 402 topUp.checkoutEndpoint points at. No charge, consumes no quota. (POST https://app.deepvalues.ai/api/v1/credits/checkout — no charge; needs a connected account or a dv_sk_ key)
Inputs: pack (required).
credits_packsCredit packs on saleARead-onlyInspect
Lists the prepaid credit packs this key can buy (1 credit = $1.00). No charge. (GET https://app.deepvalues.ai/api/v1/credits/checkout — no charge; needs a connected account or a dv_sk_ key)
Inputs: no named parameters.
filingsSEC filings (10-K, 10-Q, 8-K, etc)BRead-onlyInspect
SEC filings (10-K, 10-Q, 8-K, etc) (GET https://app.deepvalues.ai/api/v1/filings/{ticker}, e.g. https://app.deepvalues.ai/api/v1/filings/AAPL — 0.001 credits per call ($0.005 when paid per call over x402); works with no credentials up to 25 call(s)/day per address) Missing data? Call request_data.
Inputs: ticker (required), form, limit.
fundamentalsIncome + balance + cashflowBRead-onlyInspect
Income + balance + cashflow (GET https://app.deepvalues.ai/api/v1/fundamentals/{ticker}, e.g. https://app.deepvalues.ai/api/v1/fundamentals/AAPL — 0.001 credits per call ($0.005 when paid per call over x402); works with no credentials up to 25 call(s)/day per address) Missing data? Call request_data.
Inputs: ticker (required), limit, period.
guruOne guru: bio + top holdingsARead-onlyInspect
One guru: bio + top holdings (GET https://app.deepvalues.ai/api/v1/gurus/{slug}, e.g. https://app.deepvalues.ai/api/v1/gurus/warren-buffett — 0.01 credits per call; works with no credentials up to 5 call(s)/day per address) Missing data? Call request_data.
Inputs: slug (required).
guru_movesMaterial guru moves, newest filing first, each with its verdictARead-onlyInspect
The Follow the Pros feed. Every material 13F move — new position, full exit, a share count that moved by 25%, or a position of $100M or more — ordered by the date the filing became public, with a deterministic verdict line on each row. The verdict is identical for every caller: it compares the price when the investor traded, the price now and Deep Values' intrinsic value band, and it never predicts a return or recommends an action. Every row carries the company's legal name beside the ticker (name, e.g. "Occidental Petroleum"), or null where we hold none — null rather than the ticker echoed back, so a caller can tell a real name from a placeholder. Rows whose EDGAR filing date we do not yet hold fall back to when the row reached us and say so with filed_at_known: false. (GET https://app.deepvalues.ai/api/v1/gurus/moves — 0.01 credits per call; works with no credentials up to 5 call(s)/day per address) Missing data? Call request_data.
Inputs: limit, slugs, filed_since.
guru_portfolioOne guru's full portfolio at a quarterARead-onlyInspect
One guru's full portfolio at a quarter (GET https://app.deepvalues.ai/api/v1/gurus/{slug}/portfolio, e.g. https://app.deepvalues.ai/api/v1/gurus/warren-buffett/portfolio — 0.01 credits per call; works with no credentials up to 5 call(s)/day per address) Missing data? Call request_data.
Inputs: slug (required), as_of.
gurusCurated guru rosterBRead-onlyInspect
60 hand-picked institutional investors — every name a serious value investor would recognize. Filter by style. (GET https://app.deepvalues.ai/api/v1/gurus — 0.01 credits per call; works with no credentials up to 5 call(s)/day per address) Missing data? Call request_data.
Inputs: limit, style.
indicators_buffettBuffett Indicator with zone classificationBRead-onlyInspect
US corporate equities ÷ GDP, with zones (significantly undervalued through significantly overvalued) and historical percentile. (GET https://app.deepvalues.ai/api/v1/indicators/buffett — 0.001 credits per call ($0.005 when paid per call over x402); works with no credentials up to 25 call(s)/day per address) Missing data? Call request_data.
Inputs: history_years.
indicators_shiller_peShiller PE with historical percentileBRead-onlyInspect
Shiller PE with historical percentile (GET https://app.deepvalues.ai/api/v1/indicators/shiller-pe — 0.001 credits per call ($0.005 when paid per call over x402); works with no credentials up to 25 call(s)/day per address) Missing data? Call request_data.
Inputs: history_years.
intrinsic_valueDCF + Owner Earnings + Damodaran intrinsic valueARead-onlyInspect
Per-method intrinsic value per share (DCF on free cash flow, owner earnings, Damodaran two-stage), their equal-weight blend, Monte Carlo bounds and the implied gap to the current price, and the lead value the DeepValues apps headline (lead_method, lead_intrinsic_value, lead_upside_pct, values.lead_intrinsic_value_per_share): Owner Earnings, or the DCF and then Damodaran when Owner Earnings has no positive value. The blend is checked against the price before it is served: if it fails a check (not positive, more than 20x the price, a price older than five days, no price, or currency_consistent: statements left in a currency other than the USD price), the valuation fields are null, withheld is true, checks.failed names the check and the call is not charged. A value under 0.05x the price is served with the flag iv_far_below_price. A value built from statements converted to USD carries fx (from the filer's currency, to USD, rate, rate_date, rate_type) on values.intrinsic_value_per_share and each method input; currency_unverified in checks.flags means the statement currency is not known for this ticker, so the check did not run. A method with no value is null in methods, never 0, and methods_unavailable says why (code, family: negative_cash_flow, financial_company, withheld or missing_inputs, and the pipeline's reason). For a one-call answer with holders and a verdict, use /brief/{ticker}. (GET https://app.deepvalues.ai/api/v1/intrinsic-value/{ticker}, e.g. https://app.deepvalues.ai/api/v1/intrinsic-value/AAPL — 0.02 credits per call; works with no credentials up to 5 call(s)/day per address) Missing data? Call request_data.
Inputs: ticker (required).
keys_createMint an API key — no account, session or browser neededAInspect
The one endpoint that needs no key. Send {} for a dv_sk_test_ sandbox key (real data, small daily quota, never billed, no /research). Send {"email":"…"} for a dv_sk_live_ key on a new prepaid account; the first key for an email carries 1 starter credit ($1.00). Send it with an existing key as the bearer to mint a sibling key on the same account (rotation). The raw key is returned once. The email is a contact label, not a credential. Limited to 10 keys per address per day. The raw key is in the result once: keep it and send it as Authorization: Bearer on REST calls (or have the host re-add this server with that header). With a key already configured, mints a sibling on the same account. (POST https://app.deepvalues.ai/api/v1/keys — no charge; needs no credentials)
Inputs: email, label.
keys_meThis key: exact credit balance, remaining quota, environmentARead-onlyInspect
Returns the calling key, the exact balance of the ledger behind it (balanceMicro: integer micro-credits, 1 credit = $1.00 = 1,000,000), what is left in each daily quota bucket, and the environment. No charge, and consumes no quota. (GET https://app.deepvalues.ai/api/v1/keys/me — no charge; needs a connected account or a dv_sk_ key)
Inputs: no named parameters.
mirror_briefAn impersonal brief on one filed move, for an agent to act onARead-onlyInspect
The same move as /verdict, flattened into a brief: what the investor did, when, at what price, against our value band, plus the verdict sentence. It carries NO quantity and NO instruction — sizing reads "not provided; the reader decides". It describes a public filing and a published value range; it is not advice and not a prediction. (GET https://app.deepvalues.ai/api/v1/mirror-brief/{ticker}, e.g. https://app.deepvalues.ai/api/v1/mirror-brief/AAPL?guru=warren-buffett — 0.01 credits per call; works with no credentials up to 5 call(s)/day per address) Missing data? Call request_data.
Inputs: guru (required), ticker (required), quarter.
newsSentiment-scored newsBRead-onlyInspect
Sentiment-scored news (GET https://app.deepvalues.ai/api/v1/news/{ticker}, e.g. https://app.deepvalues.ai/api/v1/news/AAPL — 0.001 credits per call ($0.005 when paid per call over x402); works with no credentials up to 25 call(s)/day per address) Missing data? Call request_data.
Inputs: ticker (required), since, sentiment.
pricingMachine-readable price list and the ways to payARead-onlyInspect
Every endpoint’s per-call price (credits, USD and atomic USDC), the allowances included at no charge, the daily quotas, and how an agent pays without a human: x402 in USDC — per call with no key, or as a prepaid top-up of a key — when it is switched on, or a Stripe Checkout link a human pays. Also served at /api/v1/pricing.json. Needs no key, costs nothing, consumes no quota. (GET https://app.deepvalues.ai/api/v1/pricing — no charge; needs no credentials)
Inputs: no named parameters.
request_dataTell us what data you needed and did not findAInspect
Name the dataset, field, company or analysis you wanted and why. No charge, needs no key, never metered, and read every week: the most-asked-for data is what gets added next. Do not send personal data (emails and phone numbers are removed). GET the same URL for the field list. At most 10 requests per address per day. (POST https://app.deepvalues.ai/api/v1/request-data — no charge; needs no credentials)
Inputs: want (required), why, kind, tool, +2 more.
researchAI multi-analyst research briefing (HEADLINE)ARead-onlyInspect
Full briefing, bull case, bear case, valuation, investment plan and intrinsic-value range as one structured JSON document. 0.25 credits ($0.25) per successful call, ai_research quota 50/day. Returns the latest completed briefing for the ticker — the same one its public company page shows; a fresh run cannot be started through the API yet (404 when none exists). Not in the sandbox. Keyless trial: with no key and no payment, each IP gets one call every 7 days at no charge (header X-DV-Keyless-Trial says when the next one opens; a 404 or 5xx does not use it). After that, send a live key, or pay this one call with x402 (no key needed); the 402 says the trial was used and when it resets (keyless_trial.resets_at). Same price as /brief, a different product: /brief is a short valuation answer computed at call time; this is the full written briefing. (GET https://app.deepvalues.ai/api/v1/research/{ticker}, e.g. https://app.deepvalues.ai/api/v1/research/AAPL — 0.25 credits per call; one call with no credentials per address every 7 days, at no charge (the keyless research trial); after that it needs a connected account or a dv_sk_ key) Missing data? Call request_data.
Inputs: ticker (required), language.
sentimentValue-investor sentiment rollup (not WSB noise)BRead-onlyInspect
Value-investor sentiment rollup (not WSB noise) (GET https://app.deepvalues.ai/api/v1/sentiment/{ticker}, e.g. https://app.deepvalues.ai/api/v1/sentiment/AAPL — 0.001 credits per call ($0.005 when paid per call over x402); works with no credentials up to 25 call(s)/day per address) Missing data? Call request_data.
Inputs: ticker (required), source, window.
smart_money_changesMaterial guru moves in a time windowARead-onlyInspect
All 13F position changes meeting the materiality threshold (new positions, full exits, ≥25% share-count shifts, OR ≥$100M position size) across our entire 60-guru roster, in the requested window. (GET https://app.deepvalues.ai/api/v1/smart-money/changes, e.g. https://app.deepvalues.ai/api/v1/smart-money/changes?since=2026-Q1 — 0.01 credits per call; works with no credentials up to 5 call(s)/day per address) Missing data? Call request_data.
Inputs: since (required), status, filed_since, min_position_usd.
smart_money_holdingsWhich curated gurus hold this tickerARead-onlyInspect
Returns every guru from our 60-name roster who held the requested ticker as of the latest 13F-HR quarter (or a specific historical quarter). Each row includes shares, USD value, % of portfolio, and the auto-classified delta vs the prior quarter. (GET https://app.deepvalues.ai/api/v1/smart-money/holdings, e.g. https://app.deepvalues.ai/api/v1/smart-money/holdings?ticker=AAPL — 0.01 credits per call; works with no credentials up to 5 call(s)/day per address) Missing data? Call request_data.
Inputs: ticker (required), quarter_end.
thesesStructured human investment thesesARead-onlyInspect
Public investment theses with structured metadata — sentiment, conviction, price target, anchored DVI run. Filter by ticker, conviction, or sentiment. (GET https://app.deepvalues.ai/api/v1/theses — 0.01 credits per call; works with no credentials up to 5 call(s)/day per address) Missing data? Call request_data.
Inputs: limit, ticker, sentiment, min_conviction.
verdictThe verdict line for one filed moveARead-onlyInspect
One guru's disclosed move in one ticker, with the sentence Deep Values publishes about it and every number behind it: the company's legal name beside the ticker (name, null where we hold none), the three dates (traded by, filed, seen), the quarter-end close, the current price, and the intrinsic value band. value is the callable band (the lead value ±25%: Owner Earnings, else the DCF, else Damodaran) and is null whenever the verdict is not a call; estimates always carries what the valuation methods actually said, their lowest and highest central estimate, so a reader told we cannot call it can see why. One of six deterministic states — below_value, inside_band, above_value, ran_ahead, too_uncertain, no_value — computed the same way for every caller. The band is Deep Values' lead intrinsic value (the one the apps headline: Owner Earnings first) plus or minus 25%, and too_uncertain ("Our estimates disagree too much to call this one.") replaces the three band states when the methods' own central estimates are more than 3x apart, or one of them is not positive: the lead value still exists, but value is null because it is not a range anyone should be told a price sits inside; estimates shows how far apart the methods are. It is distinct from no_value, which means no valuation was computed at all. Before the band is published its mid is checked against the current price (positive, at most 20x the price, a price under five days old; under 0.05x is served with the flag iv_far_below_price) and for currency (currency_consistent: the statements behind it are in USD, the price's currency, or were converted to USD; a converted band carries fx on values.value_band_mid naming the original currency and rate; when the currency is not known the answer carries the flag currency_unverified instead); on a failure value and estimates are null, the verdict reads no_value, withheld is true, checks.failed names the check, and the call is not charged. (GET https://app.deepvalues.ai/api/v1/verdict/{ticker}, e.g. https://app.deepvalues.ai/api/v1/verdict/AAPL?guru=warren-buffett — 0.02 credits per call; works with no credentials up to 5 call(s)/day per address) Missing data? Call request_data.
Inputs: guru (required), ticker (required), quarter.
webhooks_listList webhook subscriptionsARead-onlyInspect
List webhook subscriptions (GET https://app.deepvalues.ai/api/v1/webhooks — no charge; needs a connected account or a dv_sk_ key)
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Intrinsic stock value from SEC filings: DCF, EPV, Graham, moat signals. Deterministic, not guessed.
US stock market data for AI agents: SEC filings, financials, insider trades, 13F, options, macro.
SEC filings, company financials, holdings, earnings calls, stock prices, options and macro data.
US stock quotes, analyst targets, superinvestor 13F, insider buys and earnings from SEC filings
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceProvides derived financial intelligence for AI agents, including insider activity analysis, earnings surprises, institutional moves, stock screening with a proprietary composite value score, and macro indicators.MIT
- FlicenseNot gradedqualityBmaintenanceEnables AI assistants to retrieve model-based intrinsic value estimates, valuation status and quality scores for 40,000+ listed stocks, compare and screen them, and manage watchlists.-

EvidInvestofficial
AlicenseNot gradedqualityCmaintenanceSEC-filed financial statements back to 1985 for US-listed companies, plus global coverage, every number cited to its filing with an accession number. 59 tools for income statements, balance sheets, cash flow, growth rates, valuation (DCF, reverse DCF, comparables, fair-value range), SEC filing and earnings-call search, supply chains, 13F holders, options positioning and thesis monitoring.MIT
secapi-mcpofficial
AlicenseAqualityDmaintenanceEnables AI clients to search and analyze SEC filings, financial statements, insider trades, and institutional holdings through natural language tools.96 npm1MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.