Stock Price MCP Server

MCP (Model Context Protocol) server that provides real-time stock price information using Yahoo Finance API.

Features

• 📈 Real-time stock price data
• 🕐 Price update timestamps
• 🏦 Market state information (PRE, REGULAR, AFTER, POST, CLOSED)
• 💱 Multi-currency support
• 🌍 Global market coverage
• 🆓 Completely free with no rate limits

Installation

npm install
npm run build

Usage

As an MCP Server

Add to your MCP client configuration:

{
  "mcpServers": {
    "stock-price": {
      "command": "node",
      "args": ["/path/to/stock-price-mcp/dist/index.js"]
    }
  }
}

Available Tools

get_stock_price

Get real-time stock price information for a ticker symbol.

Input:

{
  "ticker": "AAPL"
}

Output:

{
  "ticker": "AAPL",
  "last_price": 150.25,
  "timestamp": "2024-01-15T16:00:00.000Z",
  "market_state": "CLOSED",
  "currency": "USD"
}

Market States

• PRE - Pre-market trading
• REGULAR - Regular trading hours
• AFTER - After-hours trading
• POST - Post-market trading
• CLOSED - Market closed

Supported Markets

• US Stocks: AAPL, TSLA, MSFT
• Korean Stocks: 005930.KS (Samsung)
• European Stocks: BMW.DE
• And many more global exchanges

Development

npm run dev

License

MIT