Yfinance MCP Server

🚀 yfinance-mcp-server

This is an unofficial MCP server that provides a simple interface to access Yahoo Finance stock market data via yfinance.

🚀 Quick Start

This server is a Message Control Protocol (MCP) server for accessing Yahoo Finance data. It offers a straightforward interface to obtain stock market data through yfinance.

✨ Features

• Retrieve historical stock data for specified symbols, supporting custom time periods and intervals.
• It is very convenient to use with any MCP client.
• Built with TypeScript, providing type safety and a better development experience.

💻 Usage Examples

Basic Usage

Here is an example of a Cursor MCP client configuration:

{
  "mcpServers": {
    "yfinance": {
      "command": "npx",
      "args": [
        "@onori/yfinance-mcp-server"
      ]
    }
  }
}

Advanced Usage

getStockHistory

This method is used to get historical stock data for a specified symbol.

Parameters:

• symbol (required): The stock ticker symbol (e.g., "AAPL" for Apple Inc.).
• period (required): The time period for which to retrieve data (e.g., "1d", "5d", "1mo", "3mo", "6mo", "1y", "2y", "5y", "10y", "ytd", "max").
• interval (optional): The data interval ("1d", "1wk", "1mo").

Example MCP Request

> (Request) 
Use the `getStockHistory` tool to obtain the daily stock data of AAPL for the past week (`period`='1w', `interval`='1d'). Then render the results as a Markdown table.

> (Response Example)
I will help you obtain Apple's stock data and format it into a more readable Markdown table.
First, I will call the getStockHistory tool to get the data:

Let me format this data into a more readable Markdown table:

| Date | Open | High | Low | Close | Volume |
|------|------|------|------|------|------|
| March 31, 2025 | $217.01 | $225.62 | $216.23 | $222.13 | 65.30M |
| April 1, 2025 | $219.81 | $223.68 | $218.90 | $223.19 | 36.41M |
| April 2, 2025 | $221.32 | $225.19 | $221.02 | $223.89 | 35.91M |
| April 3, 2025 | $205.54 | $207.49 | $201.25 | $203.19 | 103.42M |
| April 4, 2025 | $193.89 | $199.88 | $187.34 | $188.38 | 125.57M |

From this data, we can observe the following:
- The stock showed significant volatility during the week.
- There was a sharp decline in the last two days.
- Trading volume increased significantly during the decline, with the highest volume on April 4th (125.57M shares).
- The stock price ranged from a high of $225.62 to a low of $187.34 during this period.

Do you need specific analysis of this data or would you like to see different metrics?

📦 Installation

To set up the development environment:

1. Clone the repository.
2. Install the dependencies:

npm install

3. Start the development server:

npm run dev

🤝 Contribution

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the ISC License (ISC).

⚠️ Important Note

This is an unofficial MCP server.