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

FiatDock

fiatdock

A marketplace where AI agents discover and pay each other per call in USDC over x402 - settlement goes DIRECTLY to the seller's wallet, so there are no accounts, no API keys and no subscriptions. Buy from 24 live MCP ser

Agency AI MCP

agency-ai-dev

Agency AI MCP - Create, launch, automate and manage Meta and Google ads from Claude and ChatGPT. Pull live campaign performance, ROAS, pacing and anomalies, get budget and creative strategy, then create ads, edit campaig

Stoxly

wizard-exe

Remote MCP server for free stock & ETF fundamental analysis — 10-point score, verdict and metrics for any ticker

IBANforge

cammac-creator

IBANforge — IBAN validation, BIC/SWIFT lookup, Swiss clearing, and EMI/vIBAN classification API with MCP for AI agents

Dados B3

Valth Guimarães

Auditable fundamentals for the Brazilian stock market (B3): ROIC, margins, point-in-time multiples, dividends and REITs. Every figure traces back to the CVM account it came from, every formula is published, and nothing s