# Returnolio [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/thomasbodri/returnolio-mcp-server  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/returnolio-2

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

## Tools
Capabilities this server exposes over MCP:

- **get_stock_score** — The score for one stock, with its five pillars: Quality, Earnings-Power, Value Margin-of-Safety, Momentum and Smart Money
- **compare_stocks** — Several stocks side by side
- **screen_stocks** — Companies that pass your filters
- **search_tickers** — Find a ticker by name
- **get_top10** — The monthly Top 10
- **get_moonshot** — The Moonshot Detected picks
- **get_market_overview** — The headline indexes and a macro snapshot: rates, inflation, jobs
- **get_calendar** — Earnings, events and IPOs
- **my_watchlist** — Your own watchlist
- **my_portfolio** — Your own portfolio, as numbers only
- **get_app_link** — A link to the matching page in the Returnolio app

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "returnolio": {
    "url": "https://mcp.returnolio.com/mcp"
  }
}
```

## Documentation

## What Returnolio MCP server does

Returnolio MCP server exposes Returnolio's stock research through the Model Context Protocol for signed-in users. The available data covers individual company scores, comparisons, filtered screens, ticker lookup, monthly selections, market conditions, corporate events, and a user's saved watchlist or portfolio.

The research tools are read-only. They cannot place trades, move money, or edit watchlists, portfolios, or other user data. Portfolio results are returned as numbers only. Responses include a link to the corresponding view in the Returnolio application, where applicable, and carry Returnolio's financial-publisher disclaimer rather than investment advice.

## How it works

The hosted service is available at `https://mcp.returnolio.com/mcp`. A user connects an MCP client, signs in with a Returnolio account, and then calls the tools available under that account's plan. The plan determines which tools return results.

Returnolio MCP server uses OAuth for sign-in. The web application issues access tokens, while the server verifies them using an Ed25519 public key. Calls from the server to Returnolio's gateway include a signature covering the request path, query string, and token. The gateway checks the user's plan again, applies rate and result-size limits, and attaches the relevant disclaimer.

Operational protections include per-user and per-server session limits, idle timeouts, and limits on opening sessions. Structured JSON logs record events while removing or masking tokens and email addresses.

## Setup and configuration

For Claude, add a custom connector under Settings, Connectors, and paste the hosted MCP URL. Sign in with a Returnolio account after connecting. Instructions for other MCP clients are linked from Returnolio's MCP documentation.

The repository can also be run locally. Copy `.env.example` to `.env`, provide `MCP_JWT_PUBLIC_KEY` and `MCP_SERVICE_SECRET`, install dependencies with `npm ci`, run `npm test`, and start the service with `npm start`. The service refuses to start if the public key or service secret is invalid or missing. A local process without a Returnolio gateway can start, but its tool calls are rejected.

## Tools and capabilities

Returnolio MCP server provides these tools:

- `get_stock_score` returns one company's score and its Quality, Earnings-Power, Value Margin-of-Safety, Momentum, and Smart Money pillars.
- `compare_stocks` places several stocks side by side.
- `screen_stocks` finds companies matching supplied filters.
- `search_tickers` looks up a ticker by company name.
- `get_top10` returns the monthly Top 10.
- `get_moonshot` returns Moonshot Detected picks.
- `get_market_overview` returns headline indexes and a macro snapshot covering rates, inflation, and jobs.
- `get_calendar` returns earnings, events, and IPOs.
- `my_watchlist` reads the signed-in user's watchlist.
- `my_portfolio` reads the user's portfolio as numbers.
- `get_app_link` returns a link to the corresponding Returnolio application page.

## Limitations and notes

The Returnolio MCP server does not provide trading or account-editing operations. Access is tied to a signed-in user and constrained by the user's Returnolio plan. The hosted gateway also enforces rate limits, session controls, and result-size caps.

Returnolio describes itself as a financial publisher, not an investment adviser. The research should not be treated as a recommendation to buy or sell. Self-hosting the repository does not provide useful tool responses by itself; a Returnolio gateway must be available behind the service.

_Full upstream README: https://allmcps.com/mcp/returnolio-2/readme_