Stock Price

Stock Price MCP Server provides real-time stock data queries via FastMCP, enabling you to fetch current prices, historical trends, and company details from multiple markets through a single MCP endpoint.

How to use

Connect to the Stock Price MCP Server with your MCP client using the HTTP URL for deployed instances or run a local instance for development. You can then request real-time prices, historical data, or detailed stock information for US, Taiwan, and other markets supported by the server.

How to install

Prerequisites: you need Python 3.10 or higher and the FastMCP CLI installed on your system. The server can run locally for development and testing.

# Prerequisites
python3 --version
# Ensure you have Python 3.10+ installed

# Install FastMCP CLI (if not already installed)
pip install fastmcp-cli  # or follow your environment's method to install the fastmcp CLI

Install project dependencies from the project directory.

# In the project directory
pip install -r requirements.txt

Run the server during development using the FastMCP CLI. This starts the development server and exposes the MCP endpoint locally.

fastmcp dev server.py:mcp

Verify the server configuration without starting it to review its MCP entry points.

fastmcp inspect server.py:mcp

Additional sections

Security and access: The server exposes an MCP endpoint you can connect to with any compliant MCP client. If you deploy to a public cloud or share the endpoint, consider restricting access to trusted clients via authentication or network controls.

Supported functionality: query real-time stock prices with get_stock_price, fetch historical prices with get_stock_history, obtain detailed stock information with get_stock_info, and use greet for basic testing.

Markets supported include major US stocks (for example AAPL, MSFT, GOOGL), select Taiwan stocks (e.g., 2330.TW, 2317.TW), and other markets like HK and China as described in feature notes.

Deployment notes: For cloud deployments, the server is reachable at a FastMCP endpoint similar to https://your-project-name.fastmcp.app/mcp after you complete deployment steps.

Available tools

get_stock_price

Fetches the real-time price and related data for a given stock symbol, supporting US, Taiwan, and other markets.

get_stock_history

Returns OHLCV historical data for a stock symbol over a chosen period (e.g., 1d, 1mo, 1y, max).

get_stock_info

Provides detailed information about a stock, including company name, sector, country, market cap, P/E, and more.

greet

Simple greeting tool used to test connectivity and ensure the MCP server responds to requests.