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 tradingREGULAR- Regular trading hoursAFTER- After-hours tradingPOST- Post-market tradingCLOSED- Market closed
Supported Markets
US Stocks:
AAPL,TSLA,MSFTKorean Stocks:
005930.KS(Samsung)European Stocks:
BMW.DEAnd many more global exchanges
Development
npm run dev
License
MIT