Finance MCP Server

@esurovtsev

About Finance MCP Server

A minimal MCP server built with Python that exposes two example tools: one to convert a company name into a stock symbol, and another to fetch financial data from Yahoo Finance. The project focuses on learning how to build and run an MCP server—using a simple financial scenario p

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-finance-server-py": {
      "command": "uv",
      "args": [
        "pip",
        "install",
        "-e",
        "."
      ]
    }
  }
}

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 Finance MCP Server?

A minimal MCP server built with Python that exposes two example tools: one to convert a company name into a stock symbol, and another to fetch financial data from Yahoo Finance. It is designed for learning how to build and run an MCP server, using a simple financial scenario as a demo use case.

How to use Finance MCP Server?

Install the package via uv pip install finance-mcp (production) or clone and install in development mode with uv pip install -e .. Run the server directly with the command finance-mcp. For use with Claude Desktop or other MCP clients, add the appropriate configuration to the MCP config file (e.g., claude_desktop_config.json), specifying the uv command with the path to the project directory.

Key features of Finance MCP Server

Convert company names to stock symbols.
Fetch financial data from Yahoo Finance.
Minimal Python implementation for learning MCP.
Runs as a standalone server via finance-mcp.
Compatible with Claude Desktop and MCP clients.

Use cases of Finance MCP Server

Learning how to build and run an MCP server from scratch.
Demonstrating tool integration with AI assistants using real financial data.
Experimenting with custom MCP tools in a development environment.

FAQ from Finance MCP Server

What tools does Finance MCP Server provide?

It provides two example tools: one to convert a company name into a stock symbol, and another to fetch financial data from Yahoo Finance.

How do I install Finance MCP Server?

For production use, run uv pip install finance-mcp. For development, clone the repository and install with uv pip install -e ..

What are the dependencies or runtime requirements?

The server is built with Python and uses the uv package manager. It requires Python and the packages listed in the project’s setup.

How do I connect Finance MCP Server to Claude Desktop?

Add a configuration entry to your claude_desktop_config.json that invokes uv with the server directory and the finance-mcp command.

Is Finance MCP Server intended for production financial use?

No. The project is a learning demo; the financial scenario is purely a demonstration use case.

Frequently asked questions

What tools does Finance MCP Server provide?

It provides two example tools: one to convert a company name into a stock symbol, and another to fetch financial data from Yahoo Finance.

How do I install Finance MCP Server?

For production use, run `uv pip install finance-mcp`. For development, clone the repository and install with `uv pip install -e .`.

What are the dependencies or runtime requirements?

The server is built with Python and uses the `uv` package manager. It requires Python and the packages listed in the project’s setup.

How do I connect Finance MCP Server to Claude Desktop?

Add a configuration entry to your `claude_desktop_config.json` that invokes `uv` with the server directory and the `finance-mcp` command.

Is Finance MCP Server intended for production financial use?

No. The project is a learning demo; the financial scenario is purely a demonstration use case.

Comments

Basic information

More Finance & Commerce MCP servers

Velarion — Executive Compensation Intelligence

Velarion

Velarion exposes deterministic executive-compensation and governance intelligence for ~3,000 US public companies as callable MCP tools — sourced from SEC proxy filings, not LLM guesses. Nine tools: look up CEO/NEO pay an

Financial Modeling Prep MCP (Model Context Protocol)

imbenrabi

A Model Context Protocol (MCP) implementation for Financial Modeling Prep, enabling AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights.

139