MCP Server

Ryufin

com.ryufin/stocks
Data & Analytics Finance & Investing Public & reachable MCP 2026-07-28

What this MCP does

Provides SEC-based stock overviews, financial histories, company filings, valuation and quality assessments, and stock search.

get_answer_changes
Answers that changed
Stocks whose answer to one of the five questions changed in the latest nightly run (for example Safety from Good to Watch), largest companies first.
Read only Idempotent
Input schema
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 25, 'maximum': 100, 'minimum': 1}}, 'additionalProperties': False}
get_company_news
What the company told the SEC
The company's own recent current reports (8-K), newest first: the date, what kind of event, the company's own sentence and a link to the filing on sec.gov.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['ticker'], 'properties': {'limit': {'type': 'integer', 'default': 5, 'maximum': 12, 'minimum': 1}, 'ticker': {'type': 'string', 'pattern': '^[A-Za-z0-9.-]{1,10}$', 'description': 'US ticker symbol, e.g. NVDA or BRK-B'}}, 'additionalProperties': False}
get_financial_history
Reported figures over time
A reported financial series for one stock from its SEC filings, trailing twelve months or single quarters, newest last. Metrics: pe, revenue, net_income, eps, gross_margin, op_margin, net_margin, roe, roa, roic, fcf.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['ticker', 'metric'], 'properties': {'view': {'enum': ['ttm', 'quarterly'], 'type': 'string', 'default': 'ttm'}, 'metric': {'enum': ['pe', 'revenue', 'net_income', 'eps', 'gross_margin', 'op_margin', 'net_margin', 'roe', 'roa', 'roic', 'fcf'], 'type': 'string'}, 'ticker': {'type': 'string', 'pattern': '^[A-Za-z0-9.-]{1,10}$', 'description': 'US ticker symbol, e.g. NVDA or BRK-B'}, 'periods': {'type': 'integer', 'default': 12, 'maximum': 40, 'minimum': 1}}, 'additionalProperties': False}
get_stock_answers
The five answers for a stock
Ryufin's five answers for one stock: is the business good, is it safe, is the price fair, is it growing, what is the market doing with it. Each answer has a one-word verdict, a plain sentence, the checks it was read from (with values and dates) and, when it moved recently, what it was before.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'pattern': '^[A-Za-z0-9.-]{1,10}$', 'description': 'US ticker symbol, e.g. NVDA or BRK-B'}}, 'additionalProperties': False}
get_stock_overview
Stock overview
Price, market value, P/E, returns, sector, RyuScore (0 to 100 from seven weighted criteria) and what the company says it does, verbatim from its latest annual report.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'pattern': '^[A-Za-z0-9.-]{1,10}$', 'description': 'US ticker symbol, e.g. NVDA or BRK-B'}}, 'additionalProperties': False}
search_stocks
Find a stock
Find US-listed companies Ryufin covers by ticker or company name. Returns ticker, name, sector, market value and the Ryufin page.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'default': 8, 'maximum': 20, 'minimum': 1}, 'query': {'type': 'string', 'minLength': 1, 'description': 'Ticker or part of the company name'}}, 'additionalProperties': False}
Changed
get_stock_overview
Oct. 2, 2026, 2:40 a.m.
Changed
get_stock_overview
Sept. 30, 2026, 2:40 a.m.
Added
get_answer_changes
Sept. 28, 2026, 2:40 a.m.
Added
get_company_news
Sept. 28, 2026, 2:40 a.m.
Added
get_financial_history
Sept. 28, 2026, 2:40 a.m.
Added
get_stock_overview
Sept. 28, 2026, 2:40 a.m.
Added
get_stock_answers
Sept. 28, 2026, 2:40 a.m.
Added
search_stocks
Sept. 28, 2026, 2:40 a.m.