# Returnolio

> Returnolio is a freemium MCP server for finance and payments. Read-only stock research server: company scores, monthly Top 10, screener and portfolio. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** Web, API
- **Website:** https://returnolio.com/docs/features/mcp
- **Repository:** https://github.com/thomasbodri/returnolio-mcp-server
- **MCP Registry name:** com.returnolio/returnolio
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-15

## About

Every answer is limited to what your Returnolio plan unlocks, and a request for a locked feature returns a plain message naming the tier that includes it rather than an empty result. The Free plan gets the market overview, the Top 10 and past editions up to three months behind, the Top 10's live track record against the S&P 500, the calendar and a watchlist. The screener, portfolio and compare tools need a paid plan.

Each stock gets a score broken into five pillars: Quality, Earnings-Power, Value Margin-of-Safety, Momentum and Smart Money. The data also covers fair-value estimates, fundamentals, large-investor moves and macro context such as rates, inflation and jobs. Share prices and index levels stay in the app and are not served. Every answer includes a link to the same view in the app.

The server cannot trade or change anything. According to the README, it is a thin layer that holds no database credentials and passes each call to the web app's gateway, which rechecks the plan, rate-limits and attaches a disclaimer. Returnolio calls itself a financial publisher, not an adviser. The server source is on GitHub, though it needs a Returnolio gateway behind it to answer.

## Features

- **Stock scores:** Five-pillar score for a company plus fair value and margin of safety.
- **Monthly Top 10:** The monthly picks and their track record against the S&P 500.
- **Screener and compare:** Filter companies and compare several side by side, on paid plans.
- **Market and calendar:** Macro snapshot and earnings, events and IPOs.
- **Your watchlist and portfolio:** Read your own holdings as numbers only.
- **Plan-aware answers:** Locked features say which tier includes them.
- **Read-only:** No trading and no changes to your account.

## Good for

- Ask an assistant for a stock's score and what drives it
- Compare two or three companies side by side
- Screen for companies matching your filters
- Review last month's Top 10 and its performance
- Check upcoming earnings and IPOs

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http returnolio https://mcp.returnolio.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.returnolio.com/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "returnolio": {
      "type": "http",
      "url": "https://mcp.returnolio.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `get_stock_score`: Score for one stock with its five pillars
- `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`: Headline indexes and macro snapshot
- `get_calendar`: Earnings, events and IPOs
- `my_watchlist`: Your own watchlist
- `my_portfolio`: Your own portfolio, as numbers only
- `get_app_link`: Link to the matching page in the Returnolio app

## FAQ

### Is the MCP server free?

It is included on every plan, including Free, but reaches only what your plan includes.

### Can it place trades?

No. All tools are read-only and cannot trade or change your data.

### Does it give share prices?

No. Share prices and index levels stay in the app.

### How do I connect?

Add https://mcp.returnolio.com/mcp as a connector in your client and sign in with a Returnolio account.

### Is it investment advice?

No. The README says it is not a recommendation to buy or sell.

### Is Returnolio free?

Returnolio has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Returnolio to Claude Code?

Run this command in your terminal: claude mcp add --transport http returnolio https://mcp.returnolio.com/mcp

### What are the best alternatives to Returnolio?

The closest alternatives to Returnolio are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/returnolio
