The Finance Tools MCP server provides comprehensive financial data analysis and research tools:
Ticker Data Tools: Access detailed ticker reports, options data (filterable by date/strike/type), historical price data with technical indicators and risk metrics, financial statements (income, balance, cash flow), institutional holders, earnings history (with estimates and surprises), insider trades, and news.
Fear & Greed Index Tools: Retrieve current and historical CNN Fear & Greed Index data, and analyze market sentiment trends.
Calculation Tools: Evaluate mathematical expressions using Python and NumPy, and calculate technical indicators with TA-lib (optionally using cached ticker data).
Macro Data Tools: Access current time, FRED database information (GDP, CPI, etc.), and latest breaking news from CNBC, BBC, and SCMP.
Fetches and analyzes Fear & Greed Index data from CNN, providing current values, historical trends, and market sentiment analysis for investment decision-making.
Leverages data from GitHub repositories to provide financial analysis tools, with the finance-tools-mcp being derived from the investor-agent GitHub project.
Integrates with PyPI packages including yfinance for market data retrieval, ta-lib-python for technical indicators, and fredapi for macroeconomic indicators.
finance-tools-mcp: A Financial Analysis MCP Server
https://github.com/VoxLink-org/finance-tools-mcp
Overview
The finance-tools-mcp is a Model Context Protocol (MCP) server designed to provide comprehensive financial insights and analysis capabilities to Large Language Models (LLMs). Modified from investor-agent, it integrates with various data sources and analytical libraries to offer a suite of tools for detailed financial research and analysis.
Related MCP server: AlphaVantage MCP Server
Prerequisites
Python: 3.10 or higher is required.
Package Manager: uv is the recommended package installer and resolver for this project.
Installation
First, install uv if you haven't already:
Ensure uv is in your system's PATH. You might need to restart your terminal or add ~/.cargo/bin to your PATH.
Then, you can run the finance-tools-mcp MCP server using uvx (which executes a package without explicitly installing it into your environment):
To run the server with a FRED API key (for enhanced macroeconomic data access), set it as an environment variable:
You can also run the server using Server-Sent Events (SSE) transport, which might be preferred by some MCP clients:
Or with both the FRED API key and SSE transport:
Usage with MCP Clients
To integrate finance-tools-mcp with an MCP client (for example, Claude Desktop), add the following configuration to your claude_desktop_config.json:
Debugging
You can leverage the MCP inspector to debug the server:
or
For log monitoring, check the following directories:
macOS:
~/Library/Logs/Claude/mcp*.logWindows:
%APPDATA%\Claude\logs\mcp*.log
Development
For local development and testing:
Use the MCP inspector as described in the Debugging section.
Test using Claude Desktop with this configuration:
