finance

This MCP server provides access to up-to-date financial data through two tools: get_price_tool and get_news_tool. The get_price_tool returns the current price for a stock or cryptocurrency ticker, accepting a required ticker parameter and an optional period to specify the time frame (e.g., 1d, 5d, 1mo). The get_news_tool fetches recent news articles related to a ticker, with a required ticker and an optional count parameter to limit results. These tools enable an LLM to retrieve live price information and relevant news for any supported ticker, enabling more informed decision-making and more accurate responses.

To use the server, connect via your chosen MCP integration method (uvx, Docker, or Smithery) and invoke the tools by name. For example, you can request the latest price for AAPL or BTC-USD using get_price_tool, or pull the latest 5 news articles for ETH-USD with get_news_tool. The server is designed to be queried programmatically by your agent or application, returning structured results suitable for natural language generation or downstream processing.

Prerequisites:

• Python 3.8+ installed on your system
• Access to install Python packages (pip)
• Optional: Docker if you prefer containerized deployment

Install locally (editable mode):

uv pip install -e .

Run the server (using uvx):

finance-mcp-server

If you prefer Docker: Build the container:

# build the container
docker build -t finance-server .

Run the container:

docker run -it finance-server

For reference, an alternative Smithery-based install (CLI) is available via:

npx -y @smithery/cli install @Otman404/finance-mcp-server --client claude

Notes and tips:

• Ticker inputs should be provided in standard market formats (e.g., AAPL, BTC-USD, BTC-USD). The server may support aliases depending on data sources.
• get_price_tool supports a period parameter (e.g., '1d', '5d', '1mo'). If omitted, a default period (often '1d') is used.
• get_news_tool accepts a count parameter to limit results; default is typically 5.
• When deploying via Docker, ensure network access to any external APIs used for price/news data is allowed and that API keys (if required) are provided through environment variables as needed by the runtime.
• If you encounter permission or path issues with uvx, ensure your Python environment is correctly configured and that finance-mcp-server is discoverable in your PATH.