mcp-stock-research
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
mcp-stock-research
A lightweight MCP (Model Context Protocol) server that provides stock research tools powered by yfinance. Works with any MCP-compatible client, including GitHub Copilot in VS Code.
Supports Japanese stocks (TSE) and US stocks out of the box.
Tools
Tool | Description |
| Get current price, PE/PB ratios, dividend yield, and other fundamentals |
| Get dividend payment history with annual totals |
| Screen multiple tickers for high-dividend quality (consecutive increases, revenue trend) |
| Multi-model fair value calculation (DDM/DCF/PER/PBR/NAV) with median composite |
Related MCP server: jquants-mcp
Quick Start
Option 1: VS Code + GitHub Copilot (recommended)
Add to .vscode/mcp.json in your workspace:
{
"servers": {
"stock-research": {
"type": "stdio",
"command": "python",
"args": ["path/to/mcp_stock_server/server.py"]
}
}
}Then ask Copilot things like:
"What's Toyota's current stock price?" → calls
get_stock_info("7203")"Show me VYM's dividend history" → calls
get_dividend_history("VYM")"Screen these for high dividends: 8306, 9433, 8591" → calls
screen_high_dividend"NTTの理論株価を教えて" → calls
get_valuation_summary("9432")
Option 2: Install as a package
pip install -e ./mcp_stock_serverThen use the CLI entry point in your MCP config:
{
"servers": {
"stock-research": {
"type": "stdio",
"command": "mcp-stock-research"
}
}
}Requirements
Python 3.11+
Internet connection (yfinance fetches data from Yahoo Finance)
How it works
Stock code resolution
Japanese stocks: Enter a 4–5 digit code (e.g.,
7203) → automatically appended with.Tfor Tokyo Stock ExchangeUS stocks: Enter a ticker symbol as-is (e.g.,
AAPL,VYM)
Example output
get_stock_info("7203")
{
"symbol": "7203.T",
"name": "Toyota Motor Corporation",
"sector": "Consumer Cyclical",
"price": 2845.0,
"currency": "JPY",
"pe_ratio": 8.5,
"pb_ratio": 1.1,
"dividend_yield_pct": 2.81,
"timestamp": "2026-04-23T10:30:00"
}get_dividend_history("VYM")
{
"symbol": "VYM",
"name": "Vanguard High Dividend Yield ETF",
"price": 120.5,
"dividend_yield_pct": 3.12,
"annual_dividends": {
"2022": 3.25,
"2023": 3.48,
"2024": 3.61,
"2025": 3.72,
"2026": 1.85
},
"total_payments": 18,
"latest_dividend": {
"date": "2026-03-25",
"amount": 0.95
}
}License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for Financial Modeling Prep API with 250+ financial data tools
MCP server for stocksense-ai documentation, generated by doc2mcp.
Official Intrinio MCP server. US stock prices, options and fundamentals for AI agents.
Hosted MCP server for Indian NSE/BSE stock research: 59 tools for quotes, financials and ratios, peers, shareholding and pledge, filings with extracted facts, screens, F&O and FII/DII context. Source and freshness on every answer; no buy/sell calls.
Related MCP Servers
- AlicenseAqualityAmaintenanceA simple MCP server for Yahoo Finance using yfinance. This server provides a set of tools to fetch stock data, news, and other financial information.215211MIT
- AlicenseAqualityBmaintenanceAn MCP server that retrieves Japanese stock market data via J-Quants API v2.55444 PyPI3MIT
- FlicenseNot gradedqualityDmaintenanceA lightweight MCP server for accessing Yahoo Finance data, providing stock prices, history, company information, and financial statements.-
- FlicenseNot gradedqualityCmaintenanceMCP server wrapping yfinance to provide stock market data, financials, and analytics via 24 tools.-