Financial Analysis

v1.0.0Finance & Fintechstable

An Anthropic Model Context Protocol (MCP) server for financial analysis with alphavantage.com and financialmodellingprep.com API integration.

financial-analysismcpai-integration
Share:
12
Stars
0
Downloads
0
Weekly
0/5

What is Financial Analysis?

Financial Analysis is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to anthropic model context protocol (mcp) server for financial analysis with alphavantage.com and financialmodellingprep.com api integration.

An Anthropic Model Context Protocol (MCP) server for financial analysis with alphavantage.com and financialmodellingprep.com API integration.

This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • An Anthropic Model Context Protocol (MCP) server for financi

Use Cases

Analyze stocks, forex, and crypto with Alpha Vantage data.
Generate financial reports and investment insights through AI.
kablewy

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedMay 6, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx financial-analysis

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Financial Analysis

The Financial Analysis MCP Server is a TypeScript-based MCP server that integrates with Alpha Vantage and Financial Modeling Prep (FMP) APIs to give AI assistants access to real-time stock prices, historical price data, and comprehensive company fundamentals including income statements, balance sheets, cash flow statements, and financial ratios. It exposes two tools — stock_price and company_fundamentals — making it straightforward for analysts to query market data and generate financial reports through natural language conversations.

Prerequisites

  • Node.js 18 or higher and npm
  • An Alpha Vantage API key (free tier available at alphavantage.co)
  • A Financial Modeling Prep API key (free tier available at financialmodelingprep.com)
  • An MCP-compatible client such as Claude Desktop
1

Clone the repository

Clone the financial-analysis-mcp-server repository to your local machine.

git clone https://github.com/kablewy/financial-analysis-mcp-server.git
cd financial-analysis-mcp-server
2

Install dependencies

Install all required Node.js packages using npm.

npm install
3

Configure API keys in .env

Create a .env file in the project root with your Alpha Vantage and Financial Modeling Prep API keys.

ALPHA_VANTAGE_API_KEY=your_alpha_vantage_api_key_here
FMP_API_KEY=your_fmp_api_key_here
4

Build the TypeScript project

Compile the TypeScript source files to JavaScript so the server can be run.

npm run build
5

Add the server to your MCP client configuration

Open your Claude Desktop config file and add an entry for the financial analysis server, pointing to the compiled output and including your API keys as environment variables.

6

Restart Claude Desktop and test

Restart your MCP client, then ask for stock data or company fundamentals to verify the server is connected and returning data.

Financial Analysis Examples

Client configuration

Claude Desktop configuration for the financial analysis MCP server with API keys set as environment variables.

{
  "mcpServers": {
    "financial-analysis": {
      "command": "node",
      "args": ["/path/to/financial-analysis-mcp-server/dist/index.js"],
      "env": {
        "ALPHA_VANTAGE_API_KEY": "your_alpha_vantage_api_key_here",
        "FMP_API_KEY": "your_fmp_api_key_here"
      }
    }
  }
}

Prompts to try

Example financial analysis prompts to use with the connected MCP server.

- "Get the current stock price for AAPL with 5-minute intervals"
- "Show me Apple's income statement and cash flow for the last year"
- "Compare the financial ratios of MSFT and GOOGL"
- "Get the daily historical price data for TSLA for the past 30 days"
- "Retrieve the balance sheet and key metrics for NVDA"

Troubleshooting Financial Analysis

API rate limit errors from Alpha Vantage

The free Alpha Vantage tier is limited to 25 requests per day and 5 per minute. Upgrade to a paid plan or space out requests. Use the `outputSize: compact` parameter to reduce data volume and stay within limits.

Company fundamentals return empty or incomplete data

Verify your FMP_API_KEY is valid and the free tier has not been exhausted. Some metrics like full financial statements may require a paid FMP subscription. Check the FMP dashboard for remaining API credits.

TypeScript build errors after cloning

Ensure Node.js 18+ is installed and run `npm install` before `npm run build`. If TypeScript compilation fails, check that the tsconfig.json is present and run `npx tsc --version` to confirm TypeScript is available.

Frequently Asked Questions about Financial Analysis

What is Financial Analysis?

Financial Analysis is a Model Context Protocol (MCP) server that anthropic model context protocol (mcp) server for financial analysis with alphavantage.com and financialmodellingprep.com api integration. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Financial Analysis?

Follow the installation instructions on the Financial Analysis GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Financial Analysis?

Financial Analysis works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Financial Analysis free to use?

Yes, Financial Analysis is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Finance & Fintech MCP Servers

Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "financial-analysis": { "command": "npx", "args": ["-y", "financial-analysis"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Financial Analysis?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides