openmarkets

Open Markets is an MCP server that exposes Yahoo Finance data through the MCP interface, powered by the yfinance library. It enables retrieval of stock information, historical price data, dividends, stock splits, analyst data, market statistics, and more, all accessible via MCP clients such as Claude Desktop, Cursor, or custom MCP clients. The server exposes a rich set of tools for querying single tickers, multiple tickers, and various financial metrics, including historical data across customizable periods, dividend histories, and market metadata. Typical workflows include requesting current stock info, pulling historical prices for charting or analysis, and fetching analyst recommendations or earnings-related data to support investment decision making. Users interact with the server by configuring an MCP client to point at the openmarkets server and invoking the desired tool with appropriate arguments.

Available tools cover a broad spectrum of financial data categories, including Stock Information, Historical Data, Analyst Data, Corporate Actions, Market Data, Calendar & Market Hours, Screener & Search, Technical Analysis, Options, Financial Statements, Funds & ETFs, Crypto, Currency & Validation, and more. Each tool accepts relevant parameters (for example, get_historical_data(ticker, period, interval) or get_dividends(symbol, period)) to tailor responses to the user’s needs. The MCP server is designed to work with common MCP client configurations and can be integrated into LLM-assisted workflows for dynamic data retrieval and enrichment.

Prerequisites:

• Python 3.8 or newer installed on your system
• Internet access to fetch dependencies
• Basic command-line familiarity

Installation steps:

1. Ensure Python is available and accessible from your shell:
   • macOS/Linux: python3 --version
   • Windows: py --version or python --version
2. Install the UVX tool used to run MCP servers. The recommended approach is to install UVX via a Python package installer (pipx is a common choice):
   • Install pipx (if not already installed): python3 -m pip install --user pipx
   • Ensure the user bin directory is in your PATH (e.g., ~/.local/bin on Linux/macOS or %USERPROFILE%\AppData\Local\Programs\Python\Python39\Scripts on Windows)
   • Install UVX: pipx install uvx
3. Verify installation:
   • uvx --version
4. Run the Open Markets MCP server:
   • uvx openmarkets@latest This will start the MCP server and expose the openmarkets configuration as defined in the mcp_config.

Optional alternative (if you prefer a direct Python environment setup):

• Create a virtual environment and install UVX inside it, then run uvx openmarkets@latest inside the venv.

Notes:

• If you encounter permission or PATH issues, refer to your OS’s guidance on adding executables to PATH or using your shell profile to expose uvx.
• The Open Markets MCP server relies on Yahoo Finance data via yfinance; ensure network access to fetch data and be mindful of rate limits or data availability for certain tickers.

Tips and considerations:

• The server config uses UVX to fetch the latest openmarkets package; ensure you’re pulling a compatible version for your environment and MCP client.
• If you need to customize data retrieval, explore additional arguments supported by specific tools (e.g., period, interval, and symbol lists) to fine-tune responses.
• For integration with Claude Desktop or VS Code MCP clients, use the provided JSON blocks in the client’s settings to register the openmarkets server; you can copy the example snippets from the README and adjust if needed.
• Common issues include network access problems, API rate limits from Yahoo Finance, and mismatches between client tooling versions and server capabilities. If data seems missing or stale, verify the tool and period/interval parameters used in the request.
• Environment variables aren’t strictly required for a default Open Markets run, but you can support API keys or proxies if you extend the server’s data sources or add caching layers in a custom setup.