Stock Market MCP Server
@sverze
About Stock Market MCP Server
A Machine Conversation Protocol (MCP) server that provides stock market data and analysis tools using the Finnhub API.
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"stock-market-mcp-server-sverze": {
"command": "uv",
"args": [
"venv"
]
}
}
}Tools
6Search for stock symbols by company name
Get the latest price for a stock
Get key financial metrics for a company
Get the latest market news by category
Get news for a specific company over a date range
Get historical price data for a stock
Overview
What is Stock Market MCP Server?
A Machine Conversation Protocol (MCP) server that provides stock market data and analysis tools using the Finnhub API. It offers stock symbol lookup, real-time prices, financial metrics, market and company news, and historical price data, along with pre-built prompts for common analysis tasks.
How to use Stock Market MCP Server?
Prerequisites include Python 3.8+, uv (fast Python package installer), a free Finnhub API key, and optionally Claude Desktop. Set up by cloning the repository, creating a virtual environment with uv, installing dependencies, and adding your FINNHUB_API_KEY to a .env.local file. Run the server with uv run stock-market-server.py and configure it as a local MCP tool in Claude Desktop or use the included stock market client with an Anthropic API key.
Key features of Stock Market MCP Server
- Stock symbol lookup by company name
- Real-time stock price retrieval
- Basic financial metrics for a company
- Market news by category and company-specific news
- Historical price data (candles)
- Pre-built prompts for stock analysis, market overview, and news analysis
Use cases of Stock Market MCP Server
- Looking up stock symbols and current prices on demand
- Analyzing a stock as a potential investment using pre-built prompts
- Getting a comprehensive market overview with latest news and prices
- Examining historical price movements and company news impact
FAQ from Stock Market MCP Server
What are the prerequisites to use this server?
Python 3.8 or higher, uv (pip install uv), a free Finnhub API key, and optionally Claude Desktop for integration.
How do I get a Finnhub API key?
Sign up for a free API key at finnhub.io.
How do I run the server?
After setup, execute uv run stock-market-server.py from the project directory. The server runs in stdio mode by default.
Can I use the server without Claude Desktop?
Yes, you can also use the included stock market client by setting an Anthropic API key in a .env file and running uv run stock_market_client.py.
What authentication is required?
Authentication uses a Finnhub API key stored in a .env.local file as FINNHUB_API_KEY=your_api_key_here. No other authentication is needed.
Frequently asked questions
What are the prerequisites to use this server?
Python 3.8 or higher, uv (pip install uv), a free Finnhub API key, and optionally Claude Desktop for integration.
How do I get a Finnhub API key?
Sign up for a free API key at finnhub.io.
How do I run the server?
After setup, execute `uv run stock-market-server.py` from the project directory. The server runs in stdio mode by default.
Can I use the server without Claude Desktop?
Yes, you can also use the included stock market client by setting an Anthropic API key in a `.env` file and running `uv run stock_market_client.py`.
What authentication is required?
Authentication uses a Finnhub API key stored in a `.env.local` file as `FINNHUB_API_KEY=your_api_key_here`. No other authentication is needed.
Basic information
More Finance & Commerce MCP servers
Octagon: MCP for Market Data
OctagonAIAn MCP server for public & prediction markets research. Ask natural-language questions and get structured, source-backed answers across SEC filings, earnings transcripts, company financials, stock & crypto market data, and prediction markets news & research. Built for investors,
Binance MCP Server 🚀
AnalyticAceUnofficial tools and server implementation for Binance's Model Context Protocol (MCP). Designed to support developers building crypto trading AI Agents.
Financial Modeling Prep MCP (Model Context Protocol)
imbenrabiA Model Context Protocol (MCP) implementation for Financial Modeling Prep, enabling AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights.
✅ Official Alpha Vantage MCP Server
calvernazA MCP server for the stock market data API, Alphavantage API.
Crypto Fear & Greed Index MCP Server
kukapayProviding real-time and historical Crypto Fear & Greed Index data
Comments