ROIC.ai Financial Data MCP Server
OfficialA read-only financial-data MCP server that gives AI assistants 25 tools to research 60,000+ public companies (tickers, prices, statements, ratios, valuation, earnings calls, profiles, and news) via the ROIC.ai API.
Discovery — search tickers by symbol/name, list tickers (by exchange/listed status), resolve tickers by CIK/CUSIP/ISIN, and list exchanges, sectors, industries, and countries with ticker counts.
Company data — fetch company profiles (description, CEO, employees, sector, industry) and paginated, date-filtered news.
Earnings calls — list available calls, get the latest transcript, or pull a specific transcript by year and quarter.
Stock prices — retrieve historical OHLCV with date ranges and sort order, or the most recent price.
Financial statements — income statement, balance sheet, and cash flow, annual or quarterly, with limit/order and date or fiscal-year filters.
Ratios — profitability (ROE, ROA, ROIC, margins), credit/debt, liquidity (incl. Altman Z-Score), working capital (turnover, days, cash conversion cycle), and yield (FCF, shareholder, capital).
Valuation — enterprise value (market cap, EV, EV/Sales, EV/EBITDA, EV/EBIT), valuation multiples (P/E, P/B, P/S, P/CF, P/FCF, EV multiples), and per-share metrics (EPS, revenue, book value, cash flow).
Inputs — most tools accept a ticker, CIK, CUSIP, or ISIN as the company identifier and support period, limit, order, and date/fiscal-year filtering.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ROIC.ai Financial Data MCP Server Show me Apple's income statement for the last 3 years"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ROIC.ai Financial Data MCP Server
A financial data MCP server and stock market MCP server. It connects AI assistants (Claude, ChatGPT, Cursor, VS Code, and OpenAI Codex) to stock prices, financial statements, earnings call transcripts, fundamentals, ratios, and valuation data for 60,000+ public companies through the Model Context Protocol (MCP).
One server gives your assistant MCP for financial statements, MCP for earnings, and MCP for fundamentals. Ask a question in plain language and the model fetches live stock-market data from the ROIC.ai REST API on demand, no copy-paste.
Powered by ROIC.ai — financial statements, ratios, valuation multiples, and earnings transcripts for public companies across 70+ global exchanges.
It is open source and free to run from this GitHub repo: bring a free API key and you have a finance MCP server and a stock price MCP server in one. Unlike a single-source feed such as Yahoo Finance, ROIC.ai serves standardized financial statements, pre-computed ratios, and valuation multiples across 70+ exchanges, so the model gets clean, comparable numbers instead of scraped tables.
Hosted version (recommended)
The fastest way to use ROIC.ai is the hosted MCP server at https://mcp.roic.ai/mcp — Streamable HTTP with OAuth sign-in, so there is no API key to manage and it updates automatically. Works with ChatGPT, Claude, Cursor, VS Code, and Codex.
Claude Code:
claude mcp add --transport http roicai https://mcp.roic.ai/mcpAny client that takes a URL-based MCP server:
{
"mcpServers": {
"roicai": {
"url": "https://mcp.roic.ai/mcp",
"transport": "http"
}
}
}Full per-client setup guides (ChatGPT, Claude, Cursor, VS Code, Codex): roic.ai/api/mcp.
Related MCP server: Financial Modeling Prep MCP Server
Self-hosted (open source)
Prefer to run it yourself with an API key? This repo is the open-source server. Get a free API key at https://www.roic.ai/dashboard, then run it directly with npx (no install):
ROIC_API_KEY=your_key npx @roicai/mcp-serverClaude Desktop / Cursor
Add to your MCP config (claude_desktop_config.json for Claude Desktop, .cursor/mcp.json for Cursor):
{
"mcpServers": {
"roicai": {
"command": "npx",
"args": ["-y", "@roicai/mcp-server"],
"env": { "ROIC_API_KEY": "your_key_here" }
}
}
}Claude Code (CLI)
claude mcp add roicai --env ROIC_API_KEY=your_key -- npx -y @roicai/mcp-serverVS Code
Add to .vscode/mcp.json:
{
"servers": {
"roicai": {
"command": "npx",
"args": ["-y", "@roicai/mcp-server"],
"env": { "ROIC_API_KEY": "your_key_here" }
}
}
}OpenAI Codex
Add to ~/.codex/config.toml:
[mcp_servers.roicai]
command = "npx"
args = ["-y", "@roicai/mcp-server"]
env = { ROIC_API_KEY = "your_key_here" }Restart your client and ask: "Show me Apple's income statement for the last 3 years using roicai."
What you get
This stock market MCP server exposes 25 read-only tools across seven categories:
Financial statements — income statement, balance sheet, cash flow (annual or quarterly).
Financial ratios — profitability (ROE, ROA, ROIC, margins), credit/debt, liquidity, working capital, yield.
Valuation — P/E, P/B, P/S, EV/EBITDA and other multiples, enterprise value, per-share data.
Earnings calls — full earnings call transcripts by year and quarter.
Stock prices — end-of-day and historical OHLCV with date ranges (a stock price MCP server in its own right).
Company data — profiles (CEO, sector, industry, employees) and news.
Discovery — search and list tickers, exchanges, sectors, industries, countries.
Tools
Tool | What it returns |
| Search tickers by symbol or company name |
| List tickers (filter by exchange / listed status) |
| Resolve a ticker by CIK, CUSIP, or ISIN |
| All stock exchanges with ticker counts |
| All market sectors with ticker counts |
| All industries with ticker counts |
| All countries with ticker counts |
| Description, CEO, employees, sector, industry |
| Recent news articles, paginated and date-filtered |
| Most recent earnings call transcript |
| Available earnings calls (year, quarter, date) |
| A specific transcript by year and quarter |
| Historical OHLCV stock prices with date range |
| Most recent stock price |
| Revenue, gross profit, net income, EPS, EBITDA, margins |
| Assets, liabilities, debt, equity, shares outstanding |
| Operating / investing / financing cash flow, CapEx, FCF |
| ROE, ROA, ROIC, margins, tax rate, payout |
| Debt/EBITDA, debt/equity, interest coverage |
| Current, quick, cash ratios, Altman Z-Score |
| Turnover, days, cash conversion cycle |
| FCF yield, shareholder yield, capital yield |
| Market cap, EV, EV/Sales, EV/EBITDA |
| P/E, P/B, P/S, P/CF, EV multiples |
| EPS, revenue, book value, cash flow per share |
Every tool accepts a company identifier that can be a ticker (e.g. AAPL), CIK, CUSIP, or ISIN. Financial tools accept period (annual or quarterly), limit, order, and date / fiscal-year filters.
Example prompts
Compare Microsoft and Google profitability over the last 3 years (margins and ROE).
Is Tesla overvalued? Show its P/E, EV/EBITDA, and P/S vs the last 5 years.
What did Apple management say about AI in the latest earnings call?
Show Amazon's daily stock prices for January 2025.
Which sectors have the most publicly traded companies?Authentication
The server authenticates to the ROIC.ai REST API with an API key passed as the ROIC_API_KEY environment variable. Get a free key from your ROIC.ai dashboard. The free tier covers every tool across all public companies; paid plans raise the rate limit and history depth. See pricing.
Configuration
Variable | Default | Description |
| (required) | Your ROIC.ai REST API key |
|
| Override the API base URL |
Local development
git clone https://github.com/roicai/mcp-server.git
cd mcp-server
npm install
ROIC_API_KEY=your_key npm startRequires Node.js 18+ (uses the built-in fetch).
Links
REST API: https://www.roic.ai/api
Get an API key: https://www.roic.ai/dashboard
Model Context Protocol: https://modelcontextprotocol.io
License
MIT © ROIC.ai
Available Tools
25 toolsget_balance_sheetGet Balance SheetARead-only
Get balance sheet data: assets, liabilities, debt, equity, shares outstanding, and key balance-sheet ratios.
Inputs: identifier (required), limit, order, period, +4 more.
get_cash_flowGet Cash Flow StatementARead-only
Get cash flow data: operating, investing, and financing cash flows, CapEx, free cash flow, and dividends.
Inputs: identifier (required), limit, order, period, +4 more.
get_company_newsGet Company NewsARead-only
Get recent news articles for a company, with pagination and optional date filtering.
Inputs: identifier (required), page, limit, date_end, +1 more.
get_company_profileGet Company ProfileARead-only
Get a detailed company profile: description, CEO, employees, sector, industry, exchange, country, and more. Accepts ticker, CIK, CUSIP, or ISIN.
Inputs: identifier (required).
get_credit_ratiosGet Credit & Debt RatiosARead-only
Get credit and debt ratios: net/total debt to EBITDA, debt to equity/capital/assets, and interest coverage.
Inputs: identifier (required), limit, order, period, +4 more.
get_earnings_call_transcriptGet Earnings Call TranscriptARead-only
Get a specific earnings call transcript by year and quarter. Use list_earnings_calls to find available calls first.
Inputs: year (required), quarter (required), identifier (required).
get_enterprise_valueGet Enterprise ValueARead-only
Get enterprise value metrics: market cap, enterprise value, EV/Sales, EV/EBITDA, and EV/EBIT.
Inputs: identifier (required), limit, order, period, +4 more.
get_income_statementGet Income StatementARead-only
Get income statement data: revenue, gross profit, operating income, net income, EPS, EBITDA, and margins.
Inputs: identifier (required), limit, order, period, +4 more.
get_latest_earnings_callGet Latest Earnings CallARead-only
Get the most recent earnings call transcript for a company.
Inputs: identifier (required).
get_latest_stock_priceGet Latest Stock PriceARead-only
Get the most recent stock price for a company.
Inputs: identifier (required).
get_liquidity_ratiosGet Liquidity RatiosARead-only
Get liquidity ratios: cash, current, and quick ratios, cash-flow-to-liabilities, and the Altman Z-Score.
Inputs: identifier (required), limit, order, period, +4 more.
get_profitability_ratiosGet Profitability RatiosARead-only
Get profitability ratios: ROE, ROA, ROIC, gross/operating/EBITDA/profit margins, effective tax rate, and payout ratio.
Inputs: identifier (required), limit, order, period, +4 more.
get_stock_pricesGet Historical Stock PricesARead-only
Get historical stock price data (OHLCV) for a company, with optional date range and ordering.
Inputs: identifier (required), limit, order, date_end, +1 more.
get_valuation_multiplesGet Valuation MultiplesARead-only
Get valuation multiples: P/E, P/B, P/S, P/CF, P/FCF, EV/Sales, EV/EBITDA, EV/EBIT (last/avg/high/low).
Inputs: identifier (required), limit, order, period, +4 more.
get_working_capital_ratiosGet Working Capital RatiosARead-only
Get working-capital efficiency: receivable/inventory/payable turnover and days, and the cash conversion cycle.
Inputs: identifier (required), limit, order, period, +4 more.
get_yield_analysisGet Yield AnalysisARead-only
Get yield metrics: free-cash-flow yield, shareholder yield, capital yield, dividends paid, and enterprise value.
Inputs: identifier (required), limit, order, period, +4 more.
list_countriesList CountriesARead-only
List all countries with the number of tickers from each.
Inputs: no named parameters.
list_earnings_callsList Earnings CallsARead-only
List available earnings calls for a company (year, quarter, date). Does not include transcript text.
Inputs: identifier (required), limit.
list_exchangesList Stock ExchangesARead-only
List all stock exchanges with the number of tickers on each.
Inputs: no named parameters.
list_industriesList IndustriesARead-only
List all industries with the number of tickers in each.
Inputs: no named parameters.
list_sectorsList SectorsARead-only
List all market sectors with the number of tickers in each.
Inputs: no named parameters.
list_tickersList TickersARead-only
List available stock tickers (symbol, name, exchange, type, listed status). Use search_tickers for a targeted lookup.
Inputs: limit, listed, exchange.
search_ticker_by_identifierSearch Ticker by CIK / CUSIP / ISINARead-only
Look up a stock ticker by CIK (SEC identifier), CUSIP (9-char), or ISIN (12-char international identifier).
Inputs: type (required), identifier (required).
search_tickersSearch Stock TickersARead-only
Search for stock tickers by ticker symbol or company name. Returns matching companies with exchange info.
Inputs: query (required), limit, exchange, search_by.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 25 tools
Most tools have clearly distinct purposes, such as listing exchanges versus searching tickers versus retrieving financial statements. Minor overlaps exist (e.g., get_enterprise_value and get_valuation_multiples both include EV metrics, and list_tickers/search_tickers/search_ticker_by_identifier are similar but with different lookup methods), but descriptions sufficiently clarify scope.
All tools follow a consistent verb_noun pattern using list_, search_, or get_ prefixes. Names are descriptive and predictable (e.g., list_industries, get_cash_flow, search_ticker_by_identifier). There are no mixed naming conventions or vague verbs.
With 25 tools, the set falls into the borderline-heavy range (16-25). Each tool has a specific financial metric or report, but some could be consolidated (e.g., grouping ratio families). The count is justifiable for a broad financial data API but feels slightly high.
The server covers a comprehensive range of financial data: company profiles, news, earnings calls, historical and latest prices, core statements, multiple ratio categories, and valuation metrics. There are no obvious gaps or dead ends for a read-only financial data server.
Maintenance
Related MCP Connectors
Provide AI assistants with real-time access to official SEC EDGAR filings and financial data. Enab…
Real SEC, 13F, insider, congress & macro data your AI agent can cite. Hosted MCP, 24 tools.
SEC filings and financial data for AI agents: 59 tools for statements, valuation and supply chains.
SEC-filed company financials with filing citations, plus market data, for AI agents
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights through 250+ tools covering stocks, ETFs, crypto, forex, commodities, and economics.558 npmApache 2.0
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to access and analyze financial data such as stocks, ETFs, crypto, forex, commodities, company fundamentals, financial statements, and market insights through 250+ configurable tools.558 npmApache 2.0
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights through 250+ tools covering stocks, ETFs, crypto, forex, commodities, and economics.558 npmApache 2.0
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights through 250+ tools spanning stocks, ETFs, crypto, forex, commodities, economics, and more.558 npmApache 2.0