English Français العربية

Returnolio

Registre officiel Recherche et web

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

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http returnolio 'https://mcp.returnolio.com/mcp'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "returnolio": {
            "type": "http",
            "url": "https://mcp.returnolio.com/mcp"
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Returnolio MCP server
  2. Connect
  3. Tools
  4. How it is built
  5. Run it yourself
  6. Security

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

cp .env.example .env   # fill in MCP_JWT_PUBLIC_KEY and MCP_SERVICE_SECRET
npm ci
npm test               # typecheck, build and every test
npm 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

Questions fréquentes

Qu'est-ce que Returnolio ?

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

Comment installer Returnolio ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http returnolio 'https://mcp.returnolio.com/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Returnolio ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

Returnolio est-il open source ?

Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.

Qui maintient Returnolio ?

Il est publié par thomasbodri. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.