Skip to content
MCP server

Returnolio

Read-only stock research server: company scores, monthly Top 10, screener and portfolio

Install
Pricing
Freemium
Platforms
Web, API
Runs
Remotely
Version
1.1.1
Listing updated
2 days ago

About Returnolio

Returnolio is a freemium MCP server for finance and payments. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://mcp.returnolio.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "returnolio": {
      "url": "https://mcp.returnolio.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (11)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Freemium, from $9 a month

Free plan; Core $9/mo billed yearly, Analyst $24, Pro $39

Prices change. Check returnolio.com before you buy.

Returnolio 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 to Returnolio

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments