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., "@yfinance-mcp-server Please analyze Apple stock (AAPL) for the last 5 days"
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.
Important Note: This is an unofficial MCP server.
A Model Context Protocol (MCP) server for accessing Yahoo Finance data with comprehensive technical analysis features. This server provides AI-friendly structured stock analysis through Yahoo Finance API.
This project is based on onori/yfinance-mcp-server and has been enhanced with comprehensive technical analysis features.
Comprehensive Stock Analysis: Get detailed financial metrics, technical indicators, and AI-friendly Japanese reports
Technical Indicators: RSI, MACD, Bollinger Bands, Stochastic, Moving Averages, VWAP, Volume Analysis
Financial Metrics: Market cap, P/E ratio, P/B ratio, ROE, EPS growth, dividend yield
Multi-Market Support: US stocks (AAPL), Japanese stocks (7203.T), crypto (BTC-USD), forex (EURUSD=X)
AI-Optimized Output: Structured Japanese reports with emojis for better AI understanding
Performance Optimized: Maximum 2 API calls with comprehensive local calculations
Related MCP server: Stockflow MCP Server
Use the Claude Code CLI to add the MCP server:
claude mcp add yfinance npx @mokemokechicken/yfinance-mcp-serverOr manually add to your Claude Code MCP settings:
{
"mcpServers": {
"yfinance": {
"command": "npx",
"args": ["@mokemokechicken/yfinance-mcp-server"]
}
}
}{
"mcpServers": {
"yfinance": {
"command": "npx",
"args": ["@mokemokechicken/yfinance-mcp-server"]
}
}
}MCP を介さずにローカルで分析する場合は CLI を使えます。
npm run cli -- AAPL
npm run cli -- 6301.T --days 5
npm run cli -- AAPL --technical-params '{"rsi":{"overbought":80}}'
npm run cli -- AAPL --jsonビルド後は yfinance-analyze コマンドとしても使えます。
Performs comprehensive stock analysis with technical indicators and financial metrics.
Parameters:
symbol (required): Stock symbol
US stocks: AAPL, GOOGL, MSFT
Japanese stocks: 7203.T, 6301.T, 9984.T
Crypto: BTC-USD, ETH-USD
Forex: EURUSD=X, USDJPY=X
days (optional): Number of days for recent price data display (default: 7, range: 1-365)
Example Usage:
> Please analyze Apple stock (AAPL) for the last 5 days
> Analyze Toyota Motors (7203.T) with default 7-day periodResponse includes:
📊 Recent stock price data
💰 Financial metrics (market cap, P/E, ROE, etc.)
📈 Technical indicators (RSI, MACD, Bollinger Bands, etc.)
🎯 Trading signals and trend analysis
📋 AI-friendly structured Japanese report
To set up the development environment:
Clone the repository
Install dependencies:
npm installStart the development server:
npm run devISC License (ISC)
包括的な株式分析を実行し、財務指標、テクニカル指標、統合シグナル分析を含む投資分析レポートを提供します。技術指標パラメータのカスタマイズが可能です。(v1.3.1)
| Name | Required | Description | Default |
|---|---|---|---|
| symbol | Yes | 株式銘柄コード（例：米国株=AAPL、日本株=7203.T、仮想通貨=BTC-USD、為替=EURUSD=X） | |
| days | No | 直近何日分の価格推移データを返すか（デフォルト：7日） | |
| technicalParams | No | 技術指標パラメータ設定（オプション）。指定しない場合はデフォルト値を使用 |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It does not disclose whether the tool is read-only, has side effects, or requires authentication. The description implies analysis but lacks explicit behavioral context.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence with a version note, making it very concise. It front-loads the core action, though it could be slightly more detailed without harming conciseness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity (nested parameters, no output schema), the description is adequate but incomplete. It lists components but does not explain output format or behavior for edge cases, leaving some gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so baseline is 3. The description adds only a generic mention of customizable technical parameters, which does not significantly enhance understanding beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool performs comprehensive stock analysis including financial indicators, technical indicators, and integrated signal analysis. It also mentions customization of technical parameters, which uniquely identifies its purpose.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives, nor does it mention any prerequisites or exclusions. It simply describes the tool's function.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
v1.3.1getStockAnalysisScored across 1 tool
Only one tool exists, so there is no possibility of confusion between tools. The single tool's purpose is clearly defined.
With only one tool, naming is trivially consistent. The name 'getStockAnalysis' follows a clear verb_noun pattern.
A single tool for a financial data server like yfinance is too few. Typically, multiple tools for quotes, financials, history, etc., are expected, making this feel under-scoped.
The one tool claims to provide comprehensive stock analysis, but it likely misses other common yfinance features like historical data or news, leaving notable gaps for agents.
AI stock intelligence: prices, fundamentals, technicals, news, macro regime, and sector signals.
Analyze stocks with summaries, price targets, and analyst recommendations. Track SEC filings, divi…
Portfolio analytics + US-equity market research for AI clients. ChatGPT deep-research compat.
Free stock, ETF & crypto analysis: 10-point score, verdict and key metrics for any ticker.
