trackmcp
Back to directory
Otman404

finance-mcp-server

View on GitHub

Finance mcp server- Get up-to-date prices and news about stocks and cryptocurrencies

5 stars PythonOthers Updated Apr 30, 2026
llmsmcpmcp-serverpython

Documentation

yfinance MCP Server

smithery badge

Model Context Protocol server that allows LLMs to get accurate and up-to-date prices and news about stock/cryptocurrencies tickers.

Available Tools

  • `get_price_tool`: Get the price of a stock/cryptocurrency ticker
    • Arguments:
      • `ticker` (string): Required - Ticker name or alias (e.g., "BTC-USD", "AAPL")
      • `period` (string): Optional - Time period (e.g., "1d", "5d", "1mo"). Defaults to "1d"
  • `get_news_tool`: Get the news of a stock/cryptocurrency ticker.
    • Required arguments:
      • `ticker` (string): Required
      • `count` (string): Optional - Number of articles to retrieve (default: 5)

Installation

Installing via Smithery

To install yfinance-mcp-server for Claude Desktop automatically via Smithery:

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

Using uv

Install the package locally

bash
uv pip install -e .

Run the server

bash
finance-mcp-server

Using docker

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

# run the container
docker run -it finance-server

Configuration

Usage for Claude Desktop

Add the following to claude_desktop_config.json

uvx

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

docker

json
{
  "mcpServers": {
    "finance": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "finance-server"]
    }
  }
}

Usage for 5ire

uvx

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

docker

json
{
  "key": "finance-server",
  "command": "docker",
  "args": ["run", "-i", "--rm", "finance-server"]
}

Example Interactions

example

Frequently asked questions

What is finance-mcp-server?

finance-mcp-server is Finance mcp server- Get up-to-date prices and news about stocks and cryptocurrencies

How do I install finance-mcp-server?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is finance-mcp-server open source?

Yes — it is hosted on GitHub at https://github.com/Otman404/finance-mcp-server and has 5 stars.

Related MCP tools

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP