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.

2. Setting up the server

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

Cloning the repo

git clone [email protected]: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"