MCP.so
Sign In

Stock Market MCP Server

@sverze

Repository

About Stock Market MCP Server

A Machine Conversation Protocol (MCP) server that provides stock market data and analysis tools using the Finnhub API.

Basic information

Category

Finance & Commerce

Runtime

python

Transports

stdio

Publisher

sverze

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "stock-market-mcp-server-sverze": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

Tools

6

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

Comments

More Finance & Commerce MCP servers

Boba MCP

Able-labs-xyz

Boba CLI - The bridge between agents and decentralized trading.

56

中国股票数据

elsejj

这是一个为大模型提供 A 股数据的的 MCP(Model Content Protocol) 服务。

459

Futu Stock MCP Server

shuizhengqi1

mcp server for futuniuniu stock

76

Binance MCP Server 🚀

AnalyticAce

Unofficial tools and server implementation for Binance's Model Context Protocol (MCP). Designed to support developers building crypto trading AI Agents.

48

Crypto Fear & Greed Index MCP Server

kukapay

Providing real-time and historical Crypto Fear & Greed Index data

53