mcp-yahoo-finance
Health Pass
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 22 GitHub stars
Code Pass
- Code scan — Scanned 9 files during light audit, no dangerous patterns found
Permissions Pass
- Permissions — No dangerous permissions requested
This server is a Model Context Protocol (MCP) integration for Yahoo Finance. It enables AI assistants and compatible clients to fetch stock pricing, company information, and options chain data directly through the protocol.
Security Assessment
The tool primarily makes external network requests to the public Yahoo Finance API to retrieve its data. It does not request dangerous local system permissions, and a static code scan of its core files found no evidence of hardcoded secrets, malicious payloads, or dangerous pattern execution. Because the project acts as an API wrapper, it does not inherently expose local sensitive files. Overall risk is rated as Low.
Quality Assessment
The project is active and well-maintained, with its most recent code push happening today. It holds a standard MIT license and has accumulated 22 GitHub stars, indicating a basic level of community interest and trust. However, the developer explicitly notes in the documentation that the tool is in early development, meaning its functionality and available tools are subject to future changes and potential instability.
Verdict
Safe to use.
A Model Context Protocol (MCP) server for Yahoo Finance.
MCP Yahoo Finance
A Model Context Protocol (MCP) server for Yahoo Finance interaction. This server provides tools to get pricing, company information and more.
Please note that
mcp-yahoo-financeis currently in early development. The functionality and available tools are subject to change and expansion as I continue to develop and improve the server.
Installation
You don't need to manually install mcp-yahoo-finance if you use uv. We'll use uvx to directly run mcp-yahoo-finance.
I would recommend using this method if you simply want to use the MCP server.
Using pip
Using pip.
pip install mcp-yahoo-finance
Using Git
You can also install the package after cloning the repository to your machine.
git clone [email protected]:maxscheijen/mcp-yahoo-finance.git
cd mcp-yahoo-finance
uv sync
Configuration
Claude Desktop
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"yahoo-finance": {
"command": "uvx",
"args": ["mcp-yahoo-finance"]
}
}
}
You can also use docker:
{
"mcpServers": {
"yahoo-finance": {
"command": "docker",
"args": ["run", "-i", "--rm", "IMAGE"]
}
}
}
VSCode
Add this to your .vscode/mcp.json:
{
"servers": {
"yahoo-finance": {
"command": "uvx",
"args": ["mcp-yahoo-finance"]
}
}
}
Examples of Questions
- "What is the stock price of Apple?"
- "What is the difference in stock price between Apple and Google?"
- "How much did the stock price of Apple change between 2024-01-01 and 2025-01-01?"
- "What are the available options expiration dates for AAPL?"
- "Show me the options chain for AAPL expiring on 2024-01-19"
- "What are the call and put options for Tesla?"
Build
Docker:
docker build -t [IMAGE] .
Test with MCP Inspector
npx @modelcontextprotocol/inspector uv run mcp-yahoo-finance
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found