US Stock Data MCP Server

@mingyaw

Repository

Basic information

About US Stock Data MCP Server

No overview available yet

#us-stock-mcp-server#stock-data #data-access

US Stock Data MCP Server config

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

{
  "mcpServers": {
    "us_stock_mcp_server": {
      "command": "python",
      "args": [
        "server.py"
      ]
    }
  }
}

US Stock Data MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is US Stock Data MCP Server?

The US Stock Data MCP Server is a Model Context Protocol (MCP) server designed for accessing and updating historical price data for US stocks. It stores data locally in CSV format and automatically retrieves updates from Yahoo Finance. This server is intended for developers and AI agents that need local access to US stock market data.

How to use US Stock Data MCP Server?

Install Python 3.x, clone the repository, and run pip install -r requirements.txt. Start the server with python server.py. The default data storage path is ~/Library/Application Support/us-market-data/data, which can be customized using the US_STOCK_DATA_DIR environment variable. Use the MCP tools get_local_stock_data and update_stock_data to retrieve and update historical data.

Key features of US Stock Data MCP Server

Local CSV storage for quick access
Automatic data updates from Yahoo Finance
Safe atomic writes using temporary files
Customizable start date for updates
Duplicate data automatically handled
5-second delay between updates to avoid rate limits

Use cases of US Stock Data MCP Server

Fetch and store historical stock data for offline analysis
Automatically update daily stock price data for a portfolio tracker
Provide historical data to an AI agent for market research
Replace external API calls with local data for backtesting strategies

Frequently asked questions

What data source does this server use?

The server retrieves stock data from Yahoo Finance via the `yfinance` Python library.

Where is the stock data stored locally?

Data is stored in CSV format at `~/Library/Application Support/us-market-data/data` by default. You can change this with the `US_STOCK_DATA_DIR` environment variable.

How do I update data for a specific stock?

Use the `update_stock_data` tool with the stock symbol (e.g., `AAPL`) and an optional start date in YYYY-MM-DD format. The default start date is 2015-01-01.

Does the server handle duplicate records?

Yes, duplicate data is automatically handled during updates, keeping only the latest records.

Is there a rate limit for updates?

A 5-second delay is enforced between update operations to avoid frequent API requests to Yahoo Finance.

Comments

More Finance & Commerce MCP servers

Paidnice

Official Paidnice MCP server. Read customer email and SMS replies, contacts, invoices and notes from Paidnice, the accounts receivable automation app for Xero and QuickBooks Online, and update contact people from Claude,

CoinStats

CoinStats is a remote MCP server available at https://mcp.coinstats.app.

cp0x MCP

cp0x

Read-only MCP server over cp0x public data: referral deals and codes, trading races, a monitor of DeFi interface geo-restrictions, x402 catalogs, and facts about cp0x.

Cliometry

Live Korean market measurements for AI agents — SK Hynix ADR premium, realized leverage multiples for KODEX/SOXL/TQQQ, VIX regime, Korean semiconductor sector RRG. Pre-computed daily values, structured responses, CC BY 4

Korea & Asia Everyday Calculators (kWhmate)

kWhmate

Free, no-key calculators with sources: household electricity bills and LED savings for Korea (KEPCO), Taiwan (Taipower), the Philippines (Meralco, updated monthly) and Japan (TEPCO); Seoul/Busan taxi fares, tourist tax r