financeanalytics-data

Finance Tools▌

by voxlink-org

Get real-time market data, technical indicators like relative strength index, and yahoo stocks finance insights for smar

Integrates with financial data sources like yfinance, CNN Fear & Greed Index, FRED, and ta-lib to provide real-time market data, technical indicators, and economic insights for investment research and portfolio analysis.

github stars

★ 49

GitHub npm

No API key required for basic featuresComprehensive options analysis with GreeksMultiple data sources integrated

best for

/ Investment research and portfolio analysis
/ Financial modeling and valuation work
/ Market sentiment analysis and timing decisions
/ Options trading strategy development

capabilities

/ Get ticker data with news, metrics, and analyst recommendations
/ Retrieve historical price data and financial statements
/ Analyze options data with Greeks and technical indicators
/ Track insider trading and institutional holder changes
/ Monitor market sentiment via CNN Fear & Greed Index
/ Access earnings history with estimates and surprises

what it does

Provides comprehensive financial analysis by retrieving real-time market data, financial statements, earnings history, options analysis, and market sentiment indicators from sources like Yahoo Finance and FRED.

about

Finance Tools is a community-built MCP server published by voxlink-org that provides AI assistants with tools and capabilities via the Model Context Protocol. Get real-time market data, technical indicators like relative strength index, and yahoo stocks finance insights for smar It is categorized under finance, analytics data. This server exposes 17 tools that AI clients can invoke during conversations and coding sessions.

how to install

You can install Finance Tools in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport. This server supports remote connections over HTTP, so no local installation is required.

license

MIT

Finance Tools is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

readme

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.

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:

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

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):

uvx finance-tools-mcp

To run the server with a FRED API key (for enhanced macroeconomic data access), set it as an environment variable:

FRED_API_KEY=YOUR_API_KEY uvx finance-tools-mcp

You can also run the server using Server-Sent Events (SSE) transport, which might be preferred by some MCP clients:

uvx finance-tools-mcp --transport sse

Or with both the FRED API key and SSE transport:

FRED_API_KEY=YOUR_API_KEY uvx finance-tools-mcp --transport sse

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:

{
  "mcpServers": {
    "investor": {
        "command": "path/to/uvx/command/uvx",
        "args": ["finance-tools-mcp"],
    }
  }
}

Debugging

You can leverage the MCP inspector to debug the server:

npx @modelcontextprotocol/inspector uvx finance-tools-mcp

npx @modelcontextprotocol/inspector uv --directory  ./ run finance-tools-mcp

For log monitoring, check the following directories:

macOS: ~/Library/Logs/Claude/mcp*.log
Windows: %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:

{
  "mcpServers": {
    "investor": {
      "command": "path/to/uv/command/uv",
      "args": ["--directory", "path/to/finance-tools-mcp", "run", "finance-tools-mcp"],
    }
  }
}