YFinance TraderSAFE

An MCP (Model Context Protocol) tool that provides stock market data and trading capabilities using the yfinance library, specifically adapted for Claude Desktop.

Credit: This project was inspired by mcp-stocks by Luigi Ajah, which is a similar implementation for Cursor. This adaptation modifies the original concept to work with Claude Desktop.

Tutorial

For a detailed guide on setting up and using this tool, check out our Medium tutorial: Tutorial: Using Claude Desktop with YFinance Trader MCP Tool to Access Real-Time Stock Market Data

Features

• Real-time stock quotes
• Company information and financial metrics
• Historical price data
• Symbol search functionality
• Analyst recommendations
• Insider transaction tracking

Setup

1. Ensure you have Python 3.10 or higher installed

1. Install dependencies:

pip install -r requirements.txt

Integration with Claude Desktop

1. Configure your MCP settings in Claude Desktop by adding the following to your MCP configuration:

{
"mcpServers": {
"yfinance-trader": {
"command": "py",
"args": ["-3.13", "path/to/your/main.py"]
}
}
}

1. Replace the path with the full path to your main.py file
2. Restart Claude Desktop if needed

Available Tools

1. getstockquote

Get real-time stock quote information:

{
"symbol": "AAPL",
"price": 150.25,
"change": 2.5,
"changePercent": 1.67,
"volume": 1234567,
"timestamp": "2024-03-20T10:30:00"
}

2. getcompanyoverview

Get company information and key metrics:

{
"name": "Apple Inc.",
"sector": "Technology",
"industry": "Consumer Electronics",
"marketCap": 2500000000000,
"peRatio": 25.4,
"forwardPE": 24.2,
"divi