Read-only stock research: company scores, the Monthly Top 10, the screener and your own portfolio.
Scored across 25 tools
Six tool pairs are byte-for-byte duplicates in purpose with near-identical descriptions: compare_companies/compare_stocks, get_stock_score/get_company_snapshot, get_top10/get_top10_edition, get_live_track_record/get_top10_track_record, get_portfolio_snapshot/my_portfolio, get_watchlist/my_watchlist, screen_companies/screen_stocks. Nothing in those descriptions tells the agent which alias to pick, so misselection is essentially guaranteed. The genuinely distinct tools (valuation vs score history vs core economic profit vs methodology) are well separated, but the alias layer pollutes the whole set.
Most names follow verb_noun (get_, compare_, screen_, resolve_, search_), which is readable and predictable. But the set mixes two noun vocabularies for the same resource (companies vs stocks), and two possessive names (my_portfolio, my_watchlist) break the verb_noun pattern without signalling any behavioural difference.
At 25 tools this is already at the heavy end for a read-only data connector, and roughly six of them are pure aliases that add no capability. The effective surface is closer to 18 tools, so a third of the listing is dead weight an agent must filter out.
Coverage of the read-only domain is strong: scoring, history, valuation, economic profit, methodology, calendar, market overview, Top 10, track record, watchlist and portfolio are all present, and get_app_link plus get_capabilities explicitly handle the mutation/advice dead ends. The deliberate absence of prices, market value and any write operations is documented and redirected rather than silently missing.
Compare Returnolio scores and pillar breakdowns for up to 5 tickers side by side. The response includes an app link to the full comparison. Read-only.
Inputs: tickers (required).
Compare Returnolio scores and pillar breakdowns for up to 5 tickers side by side. The response includes an app link to the full comparison. Read-only.
Inputs: tickers (required).
Return the exact Returnolio app link for an action this read-only connector cannot perform (anything that places trades, changes holdings or watchlists, manages alert subscriptions, or asks for personalized advice). Use this whenever the user wants to DO something the connector cannot do: it says the connector is read-only and gives the precise link, including a note to open it in a browser if it is not clickable.
Inputs: action (required).
Get upcoming market events across the Returnolio-covered universe: earnings, IPOs, dividends, or stock splits. Teaser list, capped; the full filterable calendar with history is in the app. The response includes an app link to it. Read-only.
Inputs: type.
List what this connector can do: its tools, the contract names and the older names they answer to, the response envelope, and the data_status values. Read-only, makes no data request and spends nothing.
Inputs: no named parameters.
Get Returnolio's score for one company with the pillar breakdown, each with the underlying values. How the pillars combine into the headline number is not published. A company outside coverage, not listed yet or not yet scored comes back with a data_status and the reason, and nothing is counted against the plan's monthly analyses. The response includes an app link to the full analysis. Read-only.
Inputs: ticker (required).
Get one company's core economic profit by fiscal year, as an amount of money in US dollars (converted from the filing currency) with revenue, operating profit after tax and cost of capital, kept separate from the normalized 0 to 100 score. Missing values are null, not zero. Opens the company like get_company_snapshot does. The response includes an app link to the company page. Read-only.
Inputs: ticker (required), years.
Get the live track record of Returnolio's Top 10 portfolio against the S&P 500 since inception (rebased to 100, at most one point a week), trailing returns, and the past editions this plan can open. Measured live results only. Information only, not a recommendation; past performance does not guarantee future results. The response includes an app link to the full track record. Read-only.
Inputs: no named parameters.
Get a compact market-state summary: the macro snapshot (rates, inflation, jobs and similar). Index levels, yields, forex, crypto, commodities and analyst forecasts are in the app, not in this connector. The response includes an app link to the full market view. Read-only.
Inputs: no named parameters.
List Returnolio's published methodology pages (score, quality, core economic profit, margin of safety, fair value, momentum, smart money, Top 10 selection), or one by topic. Returns links only; the pages are the source. How the pillars combine into the headline score is not published. Read-only, makes no data request and spends nothing.
Inputs: topic.
Get the Moonshot Detected companies, the momentum picks inside Returnolio's monthly Top 10, from the newest edition your plan can open. Paid plans get the newest edition; the free plan gets the edition three months behind it, and the response names the edition it is. The response includes an app link to the full list. Read-only.
Inputs: no named parameters.
Get the signed-in user's own Returnolio portfolio: holdings aggregated with weighted-average cost basis (split-adjusted), each with shares, cost basis and Returnolio score, plus total cost. No prices, market value or profit/loss; those are in the app. This is a mechanical numbers-only readout, NOT analysis, a rating, or investment advice. To edit holdings, the user does it in the app. The response includes an app link to the portfolio.
Inputs: no named parameters.
Get one company's Returnolio score and pillar values over time, one point a month, up to 60 months. A pillar value that is null is unknown, not zero, and a point can carry a headline score while a pillar is null, so read each value on its own. How the pillars combine into the headline number is not published. Opens the company like get_company_snapshot does. The response includes an app link to the company page. Read-only.
Inputs: ticker (required), months.
Get Returnolio's score for one stock with the full pillar breakdown: Quality, Earnings-Power, Value Margin-of-Safety, Momentum and Smart Money, each with the underlying values behind it. How the pillars combine into the headline number is not published. The response includes an app link to the full analysis. Read-only.
Inputs: ticker (required).
Get Returnolio's monthly Top 10 list with a one-line thesis per company. Paid plans get the newest edition; the free plan gets the edition three months behind the newest published one, and the response names the edition it is. The response includes an app link to the full rationale for each pick. Read-only.
Inputs: no named parameters.
Get the latest Top 10 edition this plan may read, with a one-line thesis per company. The response names the edition it is: paid plans get the newest, the free plan gets the edition three months behind the newest published one. The response includes an app link to the full rationale for each company. Read-only.
Inputs: no named parameters.
Get the live track record of Returnolio's Top 10 portfolio against the S&P 500 since inception: both lines rebased to 100 (at most one point a week), the portfolio's trailing returns, and the past editions this plan can open (edition month, rank, ticker, company, sector). Information only, not a recommendation; past performance does not guarantee future results. The response includes an app link to the full track record and each edition's rationale. Read-only.
Inputs: no named parameters.
Get what Returnolio's model says about one company's valuation: the margin of safety and the cash-flow upside in percent, or the plain reason there is none. These are model estimates, not forecasts or price targets, and no confidence interval is given because none is computed. Opens the company like get_company_snapshot does. The response includes an app link where fair value is drawn on the chart. Read-only.
Inputs: ticker (required).
Get the signed-in user's own Returnolio watchlist (their followed tickers) with their Returnolio score. No prices; those are in the app. Read-only mechanical readout, not advice. To add or remove tickers, the user does it in the app. The response includes an app link to the watchlist.
Inputs: no named parameters.
Get the signed-in user's own Returnolio portfolio: holdings aggregated with weighted-average cost basis (split-adjusted), each with shares, cost basis and Returnolio score, plus total cost. No prices, market value or profit/loss; those are in the app. This is a mechanical numbers-only readout, NOT analysis, a rating, or investment advice. To edit holdings, the user does it in the app. The response includes an app link to the portfolio.
Inputs: no named parameters.
Get the signed-in user's own Returnolio watchlist (their followed tickers) with their Returnolio score. No prices; those are in the app. Read-only mechanical readout, not advice. To add or remove tickers, the user does it in the app. The response includes an app link to the watchlist.
Inputs: no named parameters.
Resolve a company name or ticker to candidates (up to 10). Each candidate says whether Returnolio covers and scores it; scores are null, with a reason, where there is none. When nothing is in coverage, the response says which case it is: not listed yet or no match. The response includes an app link to the stock universe. Read-only.
Inputs: q (required).
Screen the Returnolio universe and return up to 15 top-scored names. This is a teaser, not a bulk export; the full screener with all filters is in the app. The response includes an app link to it. Read-only.
Inputs: sector, min_score.
Screen the Returnolio universe and return up to 15 top-scored names. This is a teaser, not a bulk export; the full screener with all filters is in the app. The response includes an app link to it. Read-only.
Inputs: sector, min_score.
Find tickers by company name or partial symbol (up to 10 results). The response includes an app link to the stock universe, where each company opens its full analysis. Read-only.
Inputs: q (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Read-only US stock research: scores with their math, statements, ratios and playbooks, all dated.
Read-only impersonal market research: portfolio rankings, ticker scores, signals, daily briefs.
Read-only stock research; OAuth unlocks your own portfolio, watchlist, and Smart Alerts.
Read-only value-investing fund, holdings, financial, options, and insider research.
Add one secure layer between your agents and this server.
