Servidor MCP

Deep Values

ai.deepvalues/deepvalues
Datos y analítica Finanzas e inversión Público y accesible MCP 2025-11-25

Qué hace este MCP

Provides U.S. stock research using SEC filings, financial fundamentals, investor holdings, valuation models, sentiment, news, and AI-generated briefings.

account
Account info + current quota usage
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 — free; needs a connected account or a dv_sk_ key)
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', 'properties': {}, 'additionalProperties': False}
ai_context
Drop-in AI grounding context (DIFFERENTIATED)
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} — 0.005 credits per call; works with no credentials up to 1 call(s)/day per address)
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string'}, 'token_budget': {'type': 'integer', 'default': 6000, 'maximum': 16000, 'minimum': 1000}}, 'additionalProperties': False}
companies_search
Company search
Company search (GET https://app.deepvalues.ai/api/v1/companies — 0.001 credits per call; works with no credentials up to 25 call(s)/day per address)
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', 'properties': {'q': {'type': 'string'}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 100}}, 'additionalProperties': False}
company_overview
Company overview
Company overview (GET https://app.deepvalues.ai/api/v1/companies/{ticker}/overview — 0.001 credits per call; works with no credentials up to 25 call(s)/day per address)
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string'}}, 'additionalProperties': False}
credits_checkout
Get a Stripe Checkout URL that tops up this key’s balance
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. Free, consumes no quota. (POST https://app.deepvalues.ai/api/v1/credits/checkout — free; needs a connected account or a dv_sk_ key)
Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['pack'], 'properties': {'pack': {'type': 'string', 'description': 'Credit pack to buy, e.g. "1000". The `credits_packs` tool lists the packs on sale.'}}, 'additionalProperties': False}
credits_packs
Credit packs on sale
Lists the prepaid credit packs this key can buy (1 credit = $1.00). Free. (GET https://app.deepvalues.ai/api/v1/credits/checkout — free; needs a connected account or a dv_sk_ key)
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', 'properties': {}, 'additionalProperties': False}
filings
SEC filings (10-K, 10-Q, 8-K, etc)
SEC filings (10-K, 10-Q, 8-K, etc) (GET https://app.deepvalues.ai/api/v1/filings/{ticker} — 0.001 credits per call; works with no credentials up to 25 call(s)/day per address)
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['ticker'], 'properties': {'form': {'type': 'string'}, 'limit': {'type': 'integer', 'default': 10, 'maximum': 50}, 'ticker': {'type': 'string'}}, 'additionalProperties': False}
fundamentals
Income + balance + cashflow
Income + balance + cashflow (GET https://app.deepvalues.ai/api/v1/fundamentals/{ticker} — 0.001 credits per call; works with no credentials up to 25 call(s)/day per address)
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['ticker'], 'properties': {'limit': {'type': 'integer', 'default': 5, 'maximum': 20}, 'period': {'enum': ['annual', 'quarterly'], 'type': 'string', 'default': 'annual'}, 'ticker': {'type': 'string'}}, 'additionalProperties': False}
guru
One guru: bio + top holdings
One guru: bio + top holdings (GET https://app.deepvalues.ai/api/v1/gurus/{slug} — 0.005 credits per call; works with no credentials up to 25 call(s)/day per address)
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string'}}, 'additionalProperties': False}
guru_moves
Material guru moves, newest filing first, each with its verdict
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.005 credits per call; works with no credentials up to 25 call(s)/day per address)
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 50, 'maximum': 200}, 'slugs': {'type': 'string', 'description': 'Comma-separated guru slugs; default is every guru.'}, 'filed_since': {'type': 'string', 'format': 'date', 'description': 'Only moves filed on or after this date. Poll with it.'}}, 'additionalProperties': False}
guru_portfolio
One guru's full portfolio at a quarter
One guru's full portfolio at a quarter (GET https://app.deepvalues.ai/api/v1/gurus/{slug}/portfolio — 0.005 credits per call; works with no credentials up to 25 call(s)/day per address)
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string'}, 'as_of': {'type': 'string', 'format': 'date'}}, 'additionalProperties': False}
gurus
Curated guru roster
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.005 credits per call; works with no credentials up to 25 call(s)/day per address)
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 100, 'maximum': 200}, 'style': {'enum': ['value', 'growth', 'activist', 'macro', 'quant'], 'type': 'string'}}, 'additionalProperties': False}
indicators_buffett
Buffett Indicator with zone classification
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; works with no credentials up to 25 call(s)/day per address)
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', 'properties': {'history_years': {'type': 'integer', 'default': 5, 'maximum': 50}}, 'additionalProperties': False}
indicators_shiller_pe
Shiller PE with historical percentile
Shiller PE with historical percentile (GET https://app.deepvalues.ai/api/v1/indicators/shiller-pe — 0.001 credits per call; works with no credentials up to 25 call(s)/day per address)
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', 'properties': {'history_years': {'type': 'integer', 'default': 5, 'maximum': 100}}, 'additionalProperties': False}
intrinsic_value
DCF + Owner Earnings + Damodaran intrinsic value
DCF + Owner Earnings + Damodaran intrinsic value (GET https://app.deepvalues.ai/api/v1/intrinsic-value/{ticker} — 0.005 credits per call; works with no credentials up to 25 call(s)/day per address)
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string'}}, 'additionalProperties': False}
keys_me
This key: exact credit balance, remaining quota, environment
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. Free, and consumes no quota. (GET https://app.deepvalues.ai/api/v1/keys/me — free; needs a connected account or a dv_sk_ key)
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', 'properties': {}, 'additionalProperties': False}
mirror_brief
An impersonal brief on one filed move, for an agent to act on
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} — 0.005 credits per call; works with no credentials up to 25 call(s)/day per address)
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['ticker', 'guru'], 'properties': {'guru': {'type': 'string'}, 'ticker': {'type': 'string'}, 'quarter': {'type': 'string', 'format': 'date'}}, 'additionalProperties': False}
news
Sentiment-scored news
Sentiment-scored news (GET https://app.deepvalues.ai/api/v1/news/{ticker} — 0.001 credits per call; works with no credentials up to 25 call(s)/day per address)
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['ticker'], 'properties': {'since': {'type': 'string', 'format': 'date'}, 'ticker': {'type': 'string'}, 'sentiment': {'enum': ['bullish', 'bearish', 'neutral'], 'type': 'string'}}, 'additionalProperties': False}
research
AI multi-analyst research briefing (HEADLINE)
The differentiated endpoint: full briefing, bull case, bear case, valuation, investment plan, fair-value range. Bills against your ai_research quota (50/day at $99/mo, $0.10 overage). Currently returns cached results only; fresh-trigger via API arriving next release. (GET https://app.deepvalues.ai/api/v1/research/{ticker} — 3 credits per call; needs a connected account or a dv_sk_ key)
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string'}, 'language': {'enum': ['English', 'Chinese'], 'type': 'string', 'default': 'English'}}, 'additionalProperties': False}
sentiment
Value-investor sentiment rollup (not WSB noise)
Value-investor sentiment rollup (not WSB noise) (GET https://app.deepvalues.ai/api/v1/sentiment/{ticker} — 0.001 credits per call; works with no credentials up to 25 call(s)/day per address)
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['ticker'], 'properties': {'source': {'enum': ['reddit', 'stocktwits', 'combined'], 'type': 'string', 'default': 'combined'}, 'ticker': {'type': 'string'}, 'window': {'enum': ['24h', '7d', '30d'], 'type': 'string', 'default': '7d'}}, 'additionalProperties': False}
smart_money_changes
Material guru moves in a time window
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 — 0.005 credits per call; works with no credentials up to 25 call(s)/day per address)
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['since'], 'properties': {'since': {'type': 'string', 'description': 'ISO date OR YYYY-QN format. Filters on the QUARTER a position belongs to (quarter_end), not on when it was filed.'}, 'status': {'enum': ['new', 'added', 'trimmed', 'exited'], 'type': 'string'}, 'filed_since': {'type': 'string', 'format': 'date', 'description': 'Only rows that reached us on or after this date (each row carries filed_at). Use it to poll for genuinely new 13F filings; `since` alone cannot tell a filing from this week from one made months ago in the same quarter.'}, 'min_position_usd': {'type': 'number'}}, 'additionalProperties': False}
smart_money_holdings
Which curated gurus hold this ticker
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 — 0.005 credits per call; works with no credentials up to 25 call(s)/day per address)
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'pattern': '^[A-Z]{1,5}([.-][A-Z]{1,2})?$'}, 'quarter_end': {'type': 'string', 'format': 'date', 'description': 'ISO date; default = latest available'}}, 'additionalProperties': False}
theses
Structured human investment theses
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.005 credits per call; works with no credentials up to 25 call(s)/day per address)
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 50, 'maximum': 200}, 'ticker': {'type': 'string'}, 'sentiment': {'enum': ['bullish', 'bearish', 'neutral'], 'type': 'string'}, 'min_conviction': {'type': 'integer', 'maximum': 5, 'minimum': 1}}, 'additionalProperties': False}
verdict
The verdict line for one filed move
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 blend ±25%) 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' blended intrinsic value 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 blend still exists and is still returned in `value`, but it is not a range anyone should be told a price sits inside. It is distinct from `no_value`, which means no valuation was computed at all. (GET https://app.deepvalues.ai/api/v1/verdict/{ticker} — 0.005 credits per call; works with no credentials up to 25 call(s)/day per address)
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['ticker', 'guru'], 'properties': {'guru': {'type': 'string'}, 'ticker': {'type': 'string'}, 'quarter': {'type': 'string', 'format': 'date', 'description': 'Quarter end; default = the most recent quarter we hold.'}}, 'additionalProperties': False}
webhooks_list
List webhook subscriptions
List webhook subscriptions (GET https://app.deepvalues.ai/api/v1/webhooks — free; needs a connected account or a dv_sk_ key)
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Añadido
webhooks_list
5 de October de 2026 a las 02:40
Añadido
filings
5 de October de 2026 a las 02:40
Añadido
fundamentals
5 de October de 2026 a las 02:40
Añadido
company_overview
5 de October de 2026 a las 02:40
Añadido
companies_search
5 de October de 2026 a las 02:40
Añadido
news
5 de October de 2026 a las 02:40
Añadido
sentiment
5 de October de 2026 a las 02:40
Añadido
indicators_shiller_pe
5 de October de 2026 a las 02:40
Añadido
indicators_buffett
5 de October de 2026 a las 02:40
Añadido
theses
5 de October de 2026 a las 02:40
Añadido
guru_portfolio
5 de October de 2026 a las 02:40
Añadido
guru
5 de October de 2026 a las 02:40
Añadido
gurus
5 de October de 2026 a las 02:40
Añadido
mirror_brief
5 de October de 2026 a las 02:40
Añadido
verdict
5 de October de 2026 a las 02:40
Añadido
guru_moves
5 de October de 2026 a las 02:40
Añadido
smart_money_changes
5 de October de 2026 a las 02:40
Añadido
smart_money_holdings
5 de October de 2026 a las 02:40
Añadido
intrinsic_value
5 de October de 2026 a las 02:40
Añadido
research
5 de October de 2026 a las 02:40
Añadido
ai_context
5 de October de 2026 a las 02:40
Añadido
account
5 de October de 2026 a las 02:40
Añadido
credits_checkout
5 de October de 2026 a las 02:40
Añadido
credits_packs
5 de October de 2026 a las 02:40
Añadido
keys_me
5 de October de 2026 a las 02:40