saintdoresh/YFinance-Trader-MCP-ClaudeDesktop

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
2. Install dependencies:
bash
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:
json
"mcpServers": {
"yfinance-trader": {
"command": "py",
"args": ["-3.13", "path/to/your/main.py"]
2. Replace the path with the full path to your main.py file
3. Restart Claude Desktop if needed
## Available Tools
### 1. getstockquote
Get real-time stock quote information:
json
"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:
json
"name": "Apple Inc.",
"sector": "Technology",
"industry": "Consumer Electronics",
"marketCap": 2500000000000,
"peRatio": 25.4,
"forwardPE": 24.2,
"dividendYield": 0.65,
"52WeekHigh": 182.94,
"52WeekLow": 124.17
### 3. gettimeseriesdaily
Get historical daily price data:
json
"symbol": "AAPL",
"timeSeriesDaily": [
"date": "2024-03-20T00:00:00",
"open": 150.25,
"high": 152.30,
"low": 149.80,
"close": 151.75,
"volume": 12345678
// ... more data points
### 4. searchsymbol
Search for stocks and other securities:
json
"results": [
"symbol": "AAPL",
"name": "Apple Inc.",
"type": "EQUITY",
"exchange": "NASDAQ"
// ... more results
### 5. getrecommendations
Get analyst recommendations for a stock:
json
"symbol": "AAPL",
"recommendations": [
"period": "2024-03-15T00:00:00",
"strongBuy": 15,
"buy": 20,
"hold": 8,
"sell": 2,
"strongSell": 0
// ... more periods
### 6. getinsidertransactions
Get insider trading information:
json
"symbol": "AAPL",
"transactions": [
"date": "2024-03-15T00:00:00",
"insider": "John Doe",
"position": "Director",
"transactionType": "Buy",
"shares": 1000,
"value": 150250.00,
"url": "https://finance.yahoo.com/...",
"text": "Purchase of 1000 shares",
"startDate": "2024-03-15",
"ownership": "Direct"
// ... more transactions
## Sample Queries
You can ask Claude Desktop questions like:
"What is the current stock price and daily change for AAPL?"
"Can you give me a company overview for Microsoft (MSFT)?"
"Show me the historical price data for Tesla (TSLA) over the last 3 months."