Ryufin
Five plain answers on ~2,400 US stocks from SEC filings: quality, safety, valuation, growth, market.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"stocks": {
"url": "https://ryufin.com/mcp"
}
}
}Remote endpoints
https://ryufin.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (6)
🟢search_stocks(query, limit)
Find US-listed companies Ryufin covers by ticker or company name. Returns ticker, name, sector, market value and the Ryufin page.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Ticker or part of the company name",
"minLength": 1
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 8
}
},
"required": [
"query"
],
"additionalProperties": false
}🟢get_stock_answers(ticker)
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.
Input Schema
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "US ticker symbol, e.g. NVDA or BRK-B",
"pattern": "^[A-Za-z0-9.-]{1,10}$"
}
},
"required": [
"ticker"
],
"additionalProperties": false
}🟢get_stock_overview(ticker)
Price, market value, P/E, returns, sector, RyuScore (1 to 10 against sector peers) and what the company says it does, verbatim from its latest annual report.
Input Schema
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "US ticker symbol, e.g. NVDA or BRK-B",
"pattern": "^[A-Za-z0-9.-]{1,10}$"
}
},
"required": [
"ticker"
],
"additionalProperties": false
}🟢get_financial_history(ticker, metric, view, periods)
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.
Input Schema
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "US ticker symbol, e.g. NVDA or BRK-B",
"pattern": "^[A-Za-z0-9.-]{1,10}$"
},
"metric": {
"type": "string",
"enum": [
"pe",
"revenue",
"net_income",
"eps",
"gross_margin",
"op_margin",
"net_margin",
"roe",
"roa",
"roic",
"fcf"
]
},
"view": {
"type": "string",
"enum": [
"ttm",
"quarterly"
],
"default": "ttm"
},
"periods": {
"type": "integer",
"minimum": 1,
"maximum": 40,
"default": 12
}
},
"required": [
"ticker",
"metric"
],
"additionalProperties": false
}🟢get_company_news(ticker, limit)
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.
Input Schema
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "US ticker symbol, e.g. NVDA or BRK-B",
"pattern": "^[A-Za-z0-9.-]{1,10}$"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 12,
"default": 5
}
},
"required": [
"ticker"
],
"additionalProperties": false
}🟢get_answer_changes(limit)
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.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 25
}
},
"additionalProperties": false
}Community
Evidence