Skip to main content
Glama
ROIC.ai Financial Data MCP Server

ROIC.ai Financial Data MCP Server

Official

ROIC.ai Financial Data MCP Server

npm license Model Context Protocol

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.


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/mcp

Any 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-server

Claude 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-server

VS 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

Search tickers by symbol or company name

list_tickers

List tickers (filter by exchange / listed status)

search_ticker_by_identifier

Resolve a ticker by CIK, CUSIP, or ISIN

list_exchanges

All stock exchanges with ticker counts

list_sectors

All market sectors with ticker counts

list_industries

All industries with ticker counts

list_countries

All countries with ticker counts

get_company_profile

Description, CEO, employees, sector, industry

get_company_news

Recent news articles, paginated and date-filtered

get_latest_earnings_call

Most recent earnings call transcript

list_earnings_calls

Available earnings calls (year, quarter, date)

get_earnings_call_transcript

A specific transcript by year and quarter

get_stock_prices

Historical OHLCV stock prices with date range

get_latest_stock_price

Most recent stock price

get_income_statement

Revenue, gross profit, net income, EPS, EBITDA, margins

get_balance_sheet

Assets, liabilities, debt, equity, shares outstanding

get_cash_flow

Operating / investing / financing cash flow, CapEx, FCF

get_profitability_ratios

ROE, ROA, ROIC, margins, tax rate, payout

get_credit_ratios

Debt/EBITDA, debt/equity, interest coverage

get_liquidity_ratios

Current, quick, cash ratios, Altman Z-Score

get_working_capital_ratios

Turnover, days, cash conversion cycle

get_yield_analysis

FCF yield, shareholder yield, capital yield

get_enterprise_value

Market cap, EV, EV/Sales, EV/EBITDA

get_valuation_multiples

P/E, P/B, P/S, P/CF, EV multiples

get_per_share_data

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

ROIC_API_KEY

(required)

Your ROIC.ai REST API key

ROIC_API_BASE

https://api.roic.ai/v2

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 start

Requires Node.js 18+ (uses the built-in fetch).

License

MIT © ROIC.ai

Available Tools

25 tools
get_balance_sheetGet Balance SheetA
Read-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 StatementA
Read-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 NewsA
Read-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 ProfileA
Read-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 RatiosA
Read-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 TranscriptA
Read-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 ValueA
Read-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 StatementA
Read-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 CallA
Read-only

Get the most recent earnings call transcript for a company.

Inputs: identifier (required).

get_latest_stock_priceGet Latest Stock PriceA
Read-only

Get the most recent stock price for a company.

Inputs: identifier (required).

get_liquidity_ratiosGet Liquidity RatiosA
Read-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_per_share_dataGet Per-Share DataA
Read-only

Get per-share metrics: EPS, diluted EPS, revenue, EBITDA, dividends, book value, cash flow, and free cash flow per share.

Inputs: identifier (required), limit, order, period, +4 more.

get_profitability_ratiosGet Profitability RatiosA
Read-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 PricesA
Read-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 MultiplesA
Read-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 RatiosA
Read-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 AnalysisA
Read-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 CountriesA
Read-only

List all countries with the number of tickers from each.

Inputs: no named parameters.

list_earnings_callsList Earnings CallsA
Read-only

List available earnings calls for a company (year, quarter, date). Does not include transcript text.

Inputs: identifier (required), limit.

list_exchangesList Stock ExchangesA
Read-only

List all stock exchanges with the number of tickers on each.

Inputs: no named parameters.

list_industriesList IndustriesA
Read-only

List all industries with the number of tickers in each.

Inputs: no named parameters.

list_sectorsList SectorsA
Read-only

List all market sectors with the number of tickers in each.

Inputs: no named parameters.

list_tickersList TickersA
Read-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 / ISINA
Read-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 TickersA
Read-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

    A3.9/5.0

    Scored across 25 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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.

    Completeness5/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables 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 npm
      Apache 2.0
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables 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 npm
      Apache 2.0
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables 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 npm
      Apache 2.0
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables 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 npm
      Apache 2.0