US Stock Data MCP Server
@mingyaw
About US Stock Data MCP Server
No overview available yet
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"us_stock_mcp_server": {
"command": "python",
"args": [
"server.py"
]
}
}
}Tools
No tools detected
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
FAQ from US Stock Data MCP Server
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.
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.
Basic information
More Finance & Commerce MCP servers
Dados B3
Valth GuimarãesAuditable fundamentals for the Brazilian stock market (B3): ROIC, margins, point-in-time multiples, dividends and REITs. Every figure traces back to the CVM account it came from, every formula is published, and nothing s
FiatDock
fiatdockA marketplace where AI agents discover and pay each other per call in USDC over x402 - settlement goes DIRECTLY to the seller's wallet, so there are no accounts, no API keys and no subscriptions. Buy from 24 live MCP ser
Savi Tools
Savi Gurus AI Innovation LabsAsk your AI assistant about your Savi Tools business: invoices, expenses, mileage, contacts, projects, taxes, and more. Read-only and OAuth-secured — your assistant sees only your own data at getsavitools.com, and you
Holdings
holdings-ioLet your AI send invoices and take payment — card or ACH. Free. Holdings MCP server for Claude, ChatGPT & Cursor.
Fakto.app - wFirma MCP Server
Fakto.appThe only MCP server for wFirma.pl (Polish accounting). Full read-write: AI assistants create and search invoices, manage contractors, expenses, payments, warehouse, KPiR and ZUS, plus reports and cashflow forecasts. OAut
Comments