Returnolio

com.returnolioPublished by returnolio.comOfficial publisherv1.1.1Updated Oct 24, 2026

Read-only stock research: company scores, the Monthly Top 10, the screener and your own portfolio.

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Remote, read-only MCP server that lets an assistant read Returnolio stock research: company scores, Top 10 picks, screener results, market overview and your…

What you can do
  • Look up and compare company scores, including the five pillars, and find tickers by name
  • Screen stocks against filters and read the monthly Top 10 and Moonshot picks
  • Read the market overview with headline indexes and macro data, plus the earnings, events and IPO calendar
  • Read the signed-in user's own watchlist and portfolio as numbers only
  • Return a link to the matching page in the Returnolio app
When to use it
Useful when you want an assistant to answer questions about individual stocks, compare candidates, run screening ideas or summarize market and calendar context, and to bring your own Returnolio watchlist and portfolio into the conversation.
Requirements
A remote endpoint at mcp.returnolio.com/mcp added as a custom connector; OAuth sign-in with a Returnolio account; an active Returnolio plan determines which tools answer. No API keys or environment variables are needed for the hosted service.
Before you install
Sign-in is OAuth and the server sees your Returnolio account data, including your watchlist and portfolio; results depend on your plan and are rate limited. All tools are read-only and cannot trade or move money, but the output is financial publishing, not investment advice, so treat scores and picks as research rather than recommendations.

Installation

In SourceWeft

  1. Open Returnolio in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.returnolio%2Freturnolio/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "returnolio": {
      "type": "http",
      "url": "https://mcp.returnolio.com/mcp"
    }
  }
}

README

Returnolio MCP server

This is the MCP server behind https://mcp.returnolio.com/mcp. It lets Claude, ChatGPT and other MCP clients read Returnolio's stock research for a signed-in user: company scores, the monthly Top 10, the screener, the market overview, the events calendar, and the user's own watchlist and portfolio.

It is listed in the official MCP Registry as com.returnolio/returnolio.

Connect

In Claude: Settings › Connectors › Add custom connector, then paste https://mcp.returnolio.com/mcp. You sign in with your Returnolio account. A Returnolio plan decides which tools answer. Setup for other clients is at https://returnolio.com/docs/features/mcp

Tools

All tools are read-only. None of them can trade, move money or change your data.

ToolWhat it returns
get_stock_scoreThe score for one stock, with its five pillars: Quality, Earnings-Power, Value Margin-of-Safety, Momentum and Smart Money
compare_stocksSeveral stocks side by side
screen_stocksCompanies that pass your filters
search_tickersFind a ticker by name
get_top10The monthly Top 10
get_moonshotThe Moonshot Detected picks
get_market_overviewThe headline indexes and a macro snapshot: rates, inflation, jobs
get_calendarEarnings, events and IPOs
my_watchlistYour own watchlist
my_portfolioYour own portfolio, as numbers only
get_app_linkA link to the matching page in the Returnolio app

Every answer carries a link to the same view in the app. Returnolio is a financial publisher, not an investment adviser: nothing here is a recommendation to buy or sell.

How it is built

The server is thin on purpose. It holds no database credentials and makes no product decisions. Each tool call goes to the Returnolio web app's gateway, which checks the user's plan again, applies rate limits, caps result sizes and attaches the disclaimer.

  • Sign-in: OAuth. Access tokens are signed by the web app with an Ed25519 private key. This server holds only the public key, so it can check a token but cannot make one.
  • Calls to the gateway carry a signature over the path, the query string and the token, so a token copied by hand cannot be replayed against the gateway.
  • Limits: live sessions per user and per server, an idle timeout, and rate limits on opening sessions. All are set by environment variables (src/config.ts).
  • Fails closed: the server will not start without a valid public key and service secret. It logs the variable's name, never its value.
  • Logs: one JSON line per event. Tokens and email addresses are dropped or masked (src/log.ts).

Run it yourself

bash
cp .env.example .env   # fill in MCP_JWT_PUBLIC_KEY and MCP_SERVICE_SECRETnpm cinpm test               # typecheck, build and every testnpm start

Without a Returnolio gateway behind it the server starts, but every tool call is refused. The code is here so you can read how it handles your sign-in and your data.

Security

Please report a vulnerability as described at https://returnolio.com/.well-known/security.txt

Source: README.md at commit c5afe9c

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

2
  1. v1.1.1LatestOct 9, 2026
  2. v1.1.0Sep 27, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.