mcp-finance
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-finance Get the latest news for Microsoft"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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:
Get Stock Price: Fetch the latest stock price for a symbol.
Get Company Info: Fetch basic company info(Name, Sector, Industry, Website, Business Summary)
Get Historical Data: Fetch historical data for a stock
Get Stock News: Fetch latest news related to a stock symbol
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 | shFor 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-keyAdding 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
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 toolsget_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
Scored across 5 tools
Each tool targets a distinct resource: price, company info, historical data, news, and market indices. There is no overlap in purpose, making selection unambiguous.
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.
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.
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
Related MCP Connectors
Live stock quotes, a stock screener, crypto prices and FX rates as agent tools.
Yahoo Finance stock quotes and multi-ticker comparison as agent tools.
Yahoo Finance for AI agents: quotes, price history, options with Greeks, financials, news, movers.
Real-time Yahoo Finance stock/crypto quotes & options, Google Trends, News & Reddit/HN sentiment.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceProvides 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.1MIT
- AlicenseNot gradedqualityDmaintenanceProvides 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 npm1MIT
- AlicenseNot gradedqualityNot gradedmaintenanceProvides 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.-
- AlicenseAqualityDmaintenanceProvides 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.14MIT