Finance

You are using a Model Context Protocol (MCP) server that provides up-to-date prices and news for stock and cryptocurrency tickers. It exposes two practical tools—the price tool and the news tool—so your AI agents can fetch current market data and related headlines on demand.

How to use

You interact with this MCP server through your MCP client by calling its available tools. The core capabilities are:

• get_price_tool: retrieve the current price for a given ticker and an optional time period.
• get_news_tool: fetch recent news articles for a given ticker, with an optional count of results. Use these tools to enrich your conversations with live market information, summaries, and context around tickers like BTC-USD or AAPL. Provide the required arguments and any optional parameters your client supports, and the server will return the requested data so your agent can present timely insights.

How to install

Follow these concrete steps to get the MCP server running on your machine. Start with the prerequisites so your environment has the needed runtimes and tooling.

Prerequisites
- Node.js and npm (for client tooling and Smithery integration)
- Python (for local development and the Python package)
- Docker (optional, for containerized runs)
- Internet connection to fetch dependencies and remote tools

Install via Smithery (recommended for Claude Desktop integration)
npx -y @smithery/cli install @Otman404/finance-mcp-server --client claude

Run locally with uv as a Python environment (recommended for direct development)
uv pip install -e .
finance-mcp-server

Build and run with Docker (alternative containerized approach)
# build the container
docker build -t finance-server .

# run the container
docker run -it finance-server

Note: The exact commands may vary if you customize paths or use different environments. Ensure you run from the project root where the package is defined.

Additional content

Configuration and usage notes help you tailor the MCP server to your workflow.

Claude Desktop configuration provides a ready-to-use setup to connect to the server via the MCP client. Example configuration:

```json
"mcpServers": {
  "finance": {
    "command": "uvx",
    "args": ["finance-mcp-server"]
  }
}

This runs the MCP server through the UVX wrapper, letting Claude Desktop access the server’s tools for live price and news data.

## Security and notes

Keep your environment secure by restricting access to your MCP endpoints and rotating any credentials used to access external data sources. If you run the server in a container, apply standard container security practices and keep dependencies up to date.

## Available tools

### get\_price\_tool

Fetches the current price for a specified ticker with an optional time period such as 1d, 5d, or 1mo.

### get\_news\_tool

Retrieves recent news articles for a specified ticker, with an optional count of articles to return (default 5).