The thesis
Investment thesis
The standing investment case for a stock: the thesis, its testable claims with the condition that breaks each, the bear case, catalysts, whether it still holds.
TOOL
get_thesiscurl https://mcp.optimistfi.com/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_thesis","arguments":{"entity":"AAPL"}}}'When a model calls it
Models choose a tool from its description. This is the one the server publishes:
The standing investment case for a stock: the thesis, its testable claims with the condition that breaks each, the bear case, catalysts, whether it still holds. Use when the user asks: what's the bull case for X; what would break X's thesis; is X's story holding up. response_mode=plain for beginners. Not for: valuation → answer. Args: entity; view.
- what's the bull case for X
- what would break X's thesis
- is X's story holding up
For something else: answer.
Parameters
entitystringrequired
The company: a ticker (AAPL, BRK.B), a company name (Apple) or an SEC CIK.
viewstringdefault "case"
"case" (default): the thesis, its testable claims, the bear case and catalysts; "review": the case re-checked against the latest filings; "story": whether the company's own narrative in its releases matches its reported numbers.
response_modestringdefault "standard"
standard- the full read with the investment case
plain- a short beginner-friendly explanation at the reading_level grade
Accepts standard, plain.
reading_levelinteger
With response_mode plain, who the explanation is written for: 5 a complete beginner, 10 a general reader, 13 an informed investor (unset reads as 13, with precise figures).
Accepts 5, 10, 13.
Response
A real response to the example call, trimmed: lists cut to two items, long text cut short. The result's content holds the answer as JSON text; parsed, it reads:
{
"entity": {
"ticker": "AAPL",
"name": "Apple Inc.",
"cik": "0000320193"
},
"type": "thesis",
"as_of": "2026-08-28T17:34:53Z",
"confidence": "estimated",
"source": {
"name": "OptimistFi investment thesis (grounded in SEC filings)",
"url": "https://optimistfi.com/stocks/AAPL",
"license": "computed"
},
"data": {
"thesis": "Apple converts a dominant installed base and tightly integrated hardware + software ecosystem into high-margin recurring services and cash flow, which fund buybacks, R&D and new product categories and preserve pricing power.",
"claims": [
{
"id": "ecosystem_services_margin",
"claim": "Apple's ecosystem-driven Services and recurring-revenue mix will sustain and modestly expand operating margins because the installed base increases high-margin attach and subscription revenue.",
"why_it_matters": "If true, the company preserves pricing power and operating-income growth even if iPhone unit growth slows; if false, margins and valuation come under pressure.",
"rests_on": "operating_income",
"supporting_evidence": [
"OperatingIncome increased from 123,216,000,000 (FY2024) to 133,050,000,000 (FY2025)",
"GrossProfit increased from 180,683,000,000 (FY2024) to 195,201,000,000 (FY2025)"
],
"challenging_evidence": [
"Regulatory or antitrust actions that force changes to the App Store revenue model (e.g., EU/US rules limiting fees or third-party app distribution) that reduce Services take-rates",
"Major competitive shifts where Android ecosystems materially close the services monetization gap (Google, Microsoft, large platform shifts)"
],
"metrics_and_events": [
"Quarterly operating_income and gross_profit trends (GAAP)",
"Reported Services revenue and Services gross margin (segment metrics)",
"… 1 more"
],
"status": "supported",
"confidence": "medium",
"sources": [
"https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=320193&type=10-K"
],
"grounded": true
},
{
"id": "iphone_cycle_and_revenue",
"claim": "iPhone product cycles and premium positioning remain the primary cash-and-profit engine such that product cadence and premium pricing drive total revenue and fund ecosystem expansion.",
"why_it_matters": "Sustained iPhone ASP and replacement cycles keep overall revenue and cash flow healthy; a persistent decline in ASPs or replacement rates would force reliance on Services and new categories earlier than expected.",
"rests_on": "revenue",
"supporting_evidence": [
"Total Revenue rose from 391,035,000,000 (FY2024) to 416,161,000,000 (FY2025), implying continued strength in core product sales",
"Multi-year revenue trend: 383,285,000,000 (FY2023) → 391,035,000,000 (FY2024) → 416,161,000,000 (FY2025)"
],
"challenging_evidence": [
"A sustained shift of premium smartphone demand to lower-priced Android competitors reducing iPhone ASP (competition from Samsung/Chinese OEMs)",
"A structural slowdown in replacement cycles (longer device lifetimes or macro-driven deferred upgrades)"
],
"metrics_and_events": [
"FY/quarter revenue (GAAP) and company disclosure of iPhone unit sales / ASP (if reported)",
"September iPhone launch cycle results and commentary in the following quarter",
"… 1 more"
],
"status": "supported",
"confidence": "medium",
"sources": [
"https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=320193&type=10-K"
],
"grounded": true
},
"… 2 more"
],
"company_thesis": "Apple's durable value comes from (1) a large, sticky installed base that raises lifetime revenue per user through Services and Wearables, (2) tight hardware/software integration that sustains premium pricing and switching costs, and (3) very large, stable operating cash flow t…",
"security_overlay": "The stock price already embeds continued iPhone volume resilience plus accelerating Services/margin expansion and persistent capital returns. To outperform, Apple must show Services growth and new-device adoption that sustain operating-income expansion and keep operating cash …",
"paragraph": "Apple's business is driven by a dominant installed base and integrated products: iPhone still generates the bulk of revenue but high-margin Services and fast-growing Wearables raise revenue per user and protect pricing. The company converts that ecosystem into steady, very lar…",
"central_debate": "Can Services growth, wearables and new devices (AR/VR/AI integration) offset maturity in iPhone unit growth enough to sustain Apple's historical margin, cash-flow and EPS trajectory?",
"bull_case": "Services and wearables materially increase ARPU (average revenue per user) from Apple's massive installed base while new device categories (AR/AI hardware) gain traction; together with disciplined buybacks funded by large operating cash flow, this produces durable margin expan…",
"bear_case": "iPhone unit and ASP declines outpace Services growth; regulatory or platform changes (App Store economics) materially reduce Services margins; competition in new categories fails to produce meaningful revenue, forcing margin and cash-flow compression and eliminating the buybac…",
"invalidation": "A structural break in ecosystem monetization or product premium — specifically, regulatory or competitive changes that materially reduce Services take-rates and iPhone ASPs, causing operating-income to stop growing despite product launches.",
"catalysts": [
"Quarterly earnings releases (operating_income, operating_cash_flow, Services revenue disclosure)",
"September iPhone launch results and following quarter's revenue/mix commentary",
"… 2 more"
],
"segments": [
"Smartphones (iPhone)",
"Services (App Store, subscriptions, cloud services)",
"… 2 more"
],
"open_questions": [
"Segment-level revenue and margin breakdowns for Services and Wearables for FY2025 (not provided in the data)",
"Unit sales and ASP trends for iPhone (units and ASPs are not in the provided fields)",
"… 1 more"
],
"last_evaluated": "2026-08-28",
"threshold_unverified": true
}
}Fields are explained in Reading a response.
Errors
A call the server cannot run (a missing or invalid argument) comes back with
isError: true and the reason in words. A company or market the server cannot match comes back as a result naming what was not found. See Errors and limits.