Yfinance Trader

🚀 YFinance Trader MCP Tool

A Model Context Protocol (MCP) tool that uses the yfinance library to provide stock market data and trading functions.

🚀 Quick Start

This tool offers real - time stock market data and trading capabilities. It provides a variety of features to help users track and analyze stocks.

✨ Features

• Real - time stock quotes
• Company information and financial indicators
• Historical price data
• Stock symbol search function
• Insider trading tracking

📦 Installation

1. Ensure that Python 3.10 or a higher version is installed.

2. Install the dependencies:

pip install -r requirements.txt
# Or use pyproject.toml
pip install .

Integration with Cursor

1. In Cursor, go to Settings > MCP.
2. Click "+ Add New MCP Server".
3. Fill out the form:
   • Name: "yfinance - trader" (or any name you choose).
   • Command: python3 /path/to/your/yfinance - trader/main.py.

Example command:

python3 /Users/username/projects/yfinance - trader/main.py

(Replace the path with the actual path to your main.py file.)

4. Click "Add" and restart Cursor if necessary.

💻 Usage Examples

Basic Usage

1. get_stock_quote

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. get_company_overview

Get company information and key indicators:

{
    "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. get_time_series_daily

Get historical daily price data:

{
    "symbol": "AAPL",
    "timeSeriesDaily": [
        {
            "date": "2024-03-20T00:00:00",
            "open": 150.25,
            "high": 152.30,
            "low": 149.80,
            "close": 150.00
        }
    ]
}

4. get_stock_search

Search for stocks by keyword:

{
    "search_term": "Apple",
    "results": [
        {
            "symbol": "AAPL",
            "name": "Apple Inc.",
            "exchange": "NASDAQ"
        },
        {
            "symbol": "APPL",
            "name": "Applied Materials Inc.",
            "exchange": "NASDAQ"
        }
    ]
}

5. get_insider_trading

Get insider trading information:

{
    "symbol": "AAPL",
    "insider_trading": [
        {
            "name": "Tim Cook",
            "position": "CEO",
            "transaction_type": "Buy",
            "shares": 1000,
            "price": 150.25,
            "date": "2024-03-15"
        }
    ]
}

Error Handling

{
    "error": {
        "code": 404,
        "message": "Stock symbol does not exist or data cannot be found"
    }
}

Troubleshooting

1. Check your network connection to ensure that you can access the Internet.
2. Ensure that all dependencies are installed correctly.
3. Try restarting the service.
4. Check the log files for more information.

📄 License

MIT License