Skip to main content
Glama
mcp-finance

mcp-finance

by nimitmk7

Introduction

This is a MCP server that helps your MCP client/LLM get access to financial data like stock price, company info, and company news. It is powered by the yfinance Python library and MarketAux API.

Tools available:

  1. Get Stock Price: Fetch the latest stock price for a symbol.

  2. Get Company Info: Fetch basic company info(Name, Sector, Industry, Website, Business Summary)

  3. Get Historical Data: Fetch historical data for a stock

  4. Get Stock News: Fetch latest news related to a stock symbol

  5. Get Market Indices: Fetch the latest data for major US market indices.

Setup your environment

1. Installing uv

For MacOS/Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

For Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Make sure to restart your terminal afterwards to ensure that the uv command gets picked up.

Related MCP server: Yahoo Finance MCP Server

2. Setting up the server

Now, let’s create and set up our project:

Cloning the repo

git clone git@github.com:nimitmk7/mcp-finance.git

Set up environment variables:

# Create .env file for your API keys
cp .env.example .env

# Set API key in .env
MARKETAUX_API_KEY=your-marketaux-api-key

Adding the server to Claude Client

If you are using Claude Desktop Client, you can go to Settings -> Developer, and press on the button 'Edit Config'. It will open claude_desktop_config.json. Put the following configuration with your relevant details in the file:

For Mac Users

{
 "mcpServers": { 
   "mcp-finance": {
     "command": "/Users/<username>/.local/bin/uv", 
     "args": [
               "--directory",
               "/Users/<username>/<path-to-dir>/mcp-finance",
               "run",
               "mcp_finance.py"
           ]
   }
 }
}

For Windows users

{
  "mcpServers": { 
    "mcp-finance": {
      "command": "C:\\Users\\<username>\\.local\\bin\\uv.exe", 
      "args": [
                "--directory",
                "C:\\Users\\<username>\\<path-to-dir>\\mcp-finance",
                "run",
                "mcp_finance.py"
            ]
    }
  }
}

If you already have some MCP servers, just add the mcp-finance config in the list of configs of MCP servers. Restart the Claude Desktop client after these steps.

3. Verify the setup

  1. In the UI, click on the hammer icon and check whether our server tools are present in the list of available tools.

4. Example Usage

Try asking Claude questions like:

  • "What is the price of Nvidia stock right now"

  • "How much has the share price of Google changed over 1 month "

  • "Get me latest news for Microsoft"

Available Tools

5 tools
get_company_infoC

Fetch basic company info.

Inputs: symbol (required).

get_historical_dataB

Fetch historical stock data.

Args:
    symbol: Stock ticker symbol
    period: Period of data (e.g., 1d, 5d, 1mo, 3mo, 1y)

Inputs: symbol (required), period.

get_market_indicesA

Fetch the latest data for major US market indices.

Inputs: no named parameters.

get_stock_newsC

Fetch latest news using MarketAux API.

Inputs: symbol (required), count.

get_stock_priceA

Fetch the latest stock price for a symbol.

Inputs: symbol (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool targets a distinct resource: price, company info, historical data, news, and market indices. There is no overlap in purpose, making selection unambiguous.

    Naming Consistency5/5

    All tool names follow the consistent 'get_' prefix followed by a clear resource noun (e.g., get_stock_price, get_company_info). The pattern is uniform and predictable.

    Tool Count5/5

    With 5 tools, the server is well-scoped for a finance data provider. Each tool covers a core data category without being bloated or insufficient.

    Completeness4/5

    The server covers the primary financial data needs: current price, company info, historical trends, news, and market indices. Minor gaps exist (e.g., no financial statements or symbol search), but core workflows are well-supported.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Provides comprehensive financial market data and news through the Finnhub API. Enables real-time stock quotes, company profiles, financial metrics, analyst recommendations, and market news access.
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides real-time stock quotes, historical price data, financial news, and multi-stock comparisons using Yahoo Finance data. Enables users to access comprehensive financial market information through natural language queries.
      961 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Provides real-time financial data from Yahoo Finance, enabling stock price lookups, historical data analysis, company information retrieval, and multi-stock comparisons through natural language queries.
      -
    • A
      license
      A
      quality
      D
      maintenance
      Provides comprehensive financial analysis and real-time market data including stock information, options chains, technical indicators, financial statements, earnings calendars, and market sentiment indicators through integration with yfinance and other financial APIs.
      14
      MIT