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.

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.

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.

Comments

Basic information

Category

Finance & Commerce

Transports

stdio

Author

sverze

More Finance & Commerce MCP servers

AuraNet Omni-Oracle Engine

Esdecy

15 sovereign, machine-payable intelligence oracles gated via x402 v2 on Base L2, Solana, and Tempo L1. Delivers high-velocity structured feeds for FDA biotech catalysts, SEC insider trades, prediction market arbitrage, a

Holdings

holdings-io

Let your AI send invoices and take payment — card or ACH. Free. Holdings MCP server for Claude, ChatGPT & Cursor.

Cello MCP

Cello

Connect Cello MCP to build and scale your referral, partner, or affiliate programs without leaving the conversation. For growth and marketing teams: Ask which referrers drive the most revenue, identify who to re-engage

GoLeasy MCP

Der GoLeasy MCP-Server verbindet KI-Assistenten direkt mit der GoLeasy-Vergleichsplattform für Leasing-Angebote. Einfach im Chat beschreiben, was man sucht, anstatt selbst zu suchen und zu filtern - die KI ruft den Serve

Exact Online

iWebDevelopment

Exact AI Connect is a remote MCP server that connects AI assistants like Claude, ChatGPT, Copilot, Gemini and Perplexity directly to your Exact Online administration. Ask questions about your finances in plain language a