ROIC.ai MCP server
2026년 10월 15일 커밋60,000개 이상의 상장 기업에 대한 재무제표, 주가, 실적 발표 스크립트 및 밸류에이션 데이터를 AI 어시스턴트에 연결합니다.
다른 이름 roicai/agents-plugin
- 스타
- 4
- Tools
- 25
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 10월 15일
- 라이선스
- MIT
ROIC.ai MCP란?
60,000개 이상의 상장 기업에 대한 재무제표, 주가, 실적 발표 스크립트 및 밸류에이션 데이터를 AI 어시스턴트에 연결합니다. 25개 도구를 제공합니다. 예: search_tickers, list_tickers, search_ticker_by_identifier.
프로젝트 README에서 생성된 요약
ROIC.ai MCP server 정보
agents-plugin을 사용하면 AI 어시스턴트 내부에서 재무제표와 주식 시장 트렌드를 분석할 수 있습니다. 손익계산서, 대차대조표, 현금흐름표를 포함하여 전 세계 70개 거래소에 상장된 60,000개 이상의 기업에 대한 표준화된 데이터를 제공합니다. 이 연결을 통해 모델은 수동 데이터 입력 없이 실시간 시장 정보를 가져올 수 있습니다.
개발자는 Claude, ChatGPT, Cursor, VS Code, OpenAI Codex와 같은 클라이언트에서 이 MCP server를 사용할 수 있습니다. 키 관리가 필요 없는 OAuth 로그인 방식의 호스팅 버전을 선택하거나, ROIC_API_KEY를 사용하여 npx로 로컬에서 실행할 수 있습니다. 이 서버는 수익성 비율, 밸류에이션 배수, 실적 발표 스크립트 등의 카테고리를 다루는 25개의 읽기 전용 도구를 제공합니다.
단순한 웹 스크래핑과 달리, 이 도구는 미리 계산된 비율과 정제되어 비교 가능한 수치를 제공합니다. 티커(ticker), CIK, CUSIP, ISIN 등 다양한 기업 식별자를 지원합니다. 사용자는 상세한 재무 모델링을 위해 기업 가치(enterprise value), 유동성 비율 또는 과거 OHLCV 주가와 같은 특정 데이터 포인트를 요청할 수 있습니다.
활용 사례
- 1수익성 비교 분석AI에게 두 기업의 다년치 마진과 자기자본이익률(ROE)을 비교하도록 요청합니다.
- 2밸류에이션 평가특정 주식의 P/E 및 EV/EBITDA 배수를 과거 데이터와 비교하여 요청함으로써 해당 주식이 고평가되었는지 평가합니다.
- 3실적 발표 분석최근 분기 실적 발표 스크립트에서 경영진의 특정 감정이나 주제를 추출합니다.
- 4시장 탐색어떤 시장 섹터에 상장 기업이 가장 많이 포함되어 있는지 식별합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
ROIC.ai MCP 도구 25
README에서 감지됨search_tickerslist_tickerssearch_ticker_by_identifierlist_exchangeslist_sectorslist_industrieslist_countriesget_company_profileget_company_newsget_latest_earnings_calllist_earnings_callsget_earnings_call_transcript
| search_tickers | — | |
| list_tickers | — | |
| search_ticker_by_identifier | — | |
| list_exchanges | — | |
| list_sectors | — | |
| list_industries | — | |
| list_countries | — | |
| get_company_profile | — | |
| get_company_news | — | |
| get_latest_earnings_call | — | |
| list_earnings_calls | — | |
| get_earnings_call_transcript | — |
도구 25개 모두 보기도구 수 줄이기
get_stock_pricesget_latest_stock_priceget_income_statementget_balance_sheetget_cash_flowget_profitability_ratiosget_credit_ratiosget_liquidity_ratiosget_working_capital_ratiosget_yield_analysisget_enterprise_valueget_valuation_multiplesget_per_share_data
| get_stock_prices | — | |
| get_latest_stock_price | — | |
| get_income_statement | — | |
| get_balance_sheet | — | |
| get_cash_flow | — | |
| get_profitability_ratios | — | |
| get_credit_ratios | — | |
| get_liquidity_ratios | — | |
| get_working_capital_ratios | — | |
| get_yield_analysis | — | |
| get_enterprise_value | — | |
| get_valuation_multiples | — | |
| get_per_share_data | — |
구성
ROIC_API_KEY
| 이름 | 설명 | 유형 |
|---|---|---|
| ROIC_API_KEY | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능roicai/agents-plugin is public and reachablegithub.com/roicai/agents-plugin ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-15github.com/roicai/agents-plugin ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음25 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기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/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.
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).
Links
- Docs: https://www.roic.ai/api/mcp
- 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
ROIC.ai MCP 질문
ROIC.ai MCP는 어떤 도구를 제공하나요?
25개 도구를 제공합니다. 예: search_tickers, list_tickers, search_ticker_by_identifier, list_exchanges, list_sectors.
서버 인증은 어떻게 하나요?
OAuth 로그인을 지원하는 호스팅 버전을 사용하거나, ROIC_API_KEY 환경 변수를 통해 제공되는 API key를 사용하여 직접 호스팅할 수 있습니다.