Communitygithub.com

mihaitv/redstone-mcp

Performance, risk, comparisons, backtests and screening for US stocks and ETFs, with charts.

What is redstone-mcp?

redstone-mcp is a Claude Code agent skill that performance, risk, comparisons, backtests and screening for US stocks and ETFs, with charts.

Works with✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/mihaitv/redstone-mcp/tree/main

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

Redstone Markets MCP server

Performance, risk, comparisons, backtests and screening for US stocks and ETFs, with charts.

Redstone Markets has free return and risk analytics for about 2,900 US-listed stocks and 1,200 US ETFs. Its MCP server gives AI assistants the same figures: a ticker's returns and risk, side-by-side comparisons, portfolio backtests, screens, and the portfolios people have shared on Redstone.

The server runs at redstonemarkets.com, so there is nothing to install or host. This repository holds its docs, its connection config and the Redstone agent skill.

Endpointhttps://redstonemarkets.com/api/mcp
TransportStreamable HTTP
AccessPublic and read-only, with no account or API key
Registry namecom.redstonemarkets/redstone
Server cardhttps://redstonemarkets.com/.well-known/mcp/server-card.json
Docshttps://redstonemarkets.com/about#ai-assistants
Logohttps://redstonemarkets.com/web-app-manifest-512x512.png

Add the server

Claude

Connect Redstone from Claude's connector directory, then turn it on in a chat under + → Connectors.

In Claude Code:

claude mcp add --transport http redstone https://redstonemarkets.com/api/mcp

ChatGPT

Connect Redstone from ChatGPT's plugin directory.

Cursor

Add this to ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one:

{
  "mcpServers": {
    "redstone": {
      "url": "https://redstonemarkets.com/api/mcp"
    }
  }
}

This repository is also a Cursor plugin (.cursor-plugin/plugin.json), which adds the server and the skill together.

Other MCP clients

Add https://redstonemarkets.com/api/mcp as a remote MCP server over Streamable HTTP, with no sign-in. VS Code, for example, reads this from .vscode/mcp.json:

{
  "servers": {
    "redstone": {
      "type": "http",
      "url": "https://redstonemarkets.com/api/mcp"
    }
  }
}

A client that only runs local (stdio) servers can reach it through mcp-remote: npx mcp-remote https://redstonemarkets.com/api/mcp.

Tools

ToolWhat it does
get_security_metricsOne stock or ETF: YTD, 1-year and 5-year annualized returns, max drawdown, volatility, Sharpe, Sortino, beta, alpha and dividend yield, with a 1-year and 5-year chart.
compare_securities2 to 5 stocks or ETFs side by side: returns, drawdown, volatility, Sharpe, beta, dividend yield and how correlated they are, on one chart.
backtest_portfolioA weighted portfolio of 2 to 20 stocks and ETFs, rebalanced quarterly: returns over YTD, 1 and 5 years, max drawdown, volatility, Sharpe, beta, dividend yield and the correlation between holdings, charted against SPY, with a link that opens it on Redstone.
screen_securitiesStocks or ETFs ranked by a return, risk or dividend yield metric, optionally within a sector or ETF category and within bounds on other metrics.
search_portfoliosThe portfolios Redstone's users built and shared, and Redstone's model portfolios, found by what they hold, their name, or their returns, drawdown, Sharpe and yield.
get_portfolioOne shared or model portfolio: its holdings with each one's figures, and its returns and risk, charted against SPY.

Each answer gives the market date it's based on and links to the matching page on redstonemarkets.com. In clients that show MCP Apps, such as ChatGPT and Claude, answers about a ticker, a comparison or a portfolio come with a chart.

Try it

  • "Compare VOO and QQQ over the last 5 years"
  • "Backtest 60% VTI and 40% BND"

Agent skill

skills/redstone-markets/SKILL.md tells an agent how to use the server and Redstone's pages. It's a copy of the live skill at https://redstonemarkets.com/.well-known/agent-skills/redstone-markets/SKILL.md.

Install it with skills:

npx skills add mihaitv/redstone-mcp

Data

The data is end-of-day, not real-time. Returns are total returns, split-adjusted with dividends reinvested on the ex-date, and risk figures cover the past year of daily closes. The About page explains how each figure is calculated.

Nothing the server returns is investment advice, and past performance doesn't predict future results.

Contact

[email protected]

License

MIT

Related Skills