JSPM

finance-mcp-server

1.0.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 73
  • Score
    100M100P100Q70364F
  • License MIT

MCP server for financial data - stock quotes, crypto prices, portfolio tracking, and market analysis

Package Exports

  • finance-mcp-server
  • finance-mcp-server/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (finance-mcp-server) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Finance MCP Server

A Model Context Protocol (MCP) server providing real-time financial data for stocks, cryptocurrencies, and market analysis. Seamlessly integrates with Claude and other MCP-compatible AI assistants.

npm version License: MIT

Features

📈 Stock Data (Yahoo Finance)

  • Real-time stock quotes with price, change, volume
  • Historical OHLCV data with customizable ranges
  • Stock search by company name or ticker
  • Market indices tracking (S&P 500, DOW, NASDAQ)
  • Sector performance analysis

🪙 Cryptocurrency Data (CoinGecko)

  • Real-time crypto prices with 24h change
  • Top cryptocurrencies by market cap
  • Historical price data
  • Crypto search functionality

📊 Advanced Analytics (Alpha Vantage)

  • Company fundamentals (PE ratio, EPS, dividends)
  • Technical indicators (SMA, EMA, RSI, MACD, BBANDS)
  • Analyst price targets

🏛️ Economic Data (FRED)

  • Federal Reserve economic indicators
  • GDP, inflation, unemployment data
  • Interest rates and monetary policy

💼 Portfolio Management

  • Track stock and crypto holdings
  • Real-time portfolio valuation
  • Gain/loss calculations
  • Cost basis tracking

Installation

# Using npx (recommended)
npx @anthropic/finance-mcp-server

# Or install globally
npm install -g @anthropic/finance-mcp-server

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "finance": {
      "command": "npx",
      "args": ["-y", "@anthropic/finance-mcp-server"],
      "env": {
        "ALPHA_VANTAGE_KEY": "your_key_here",
        "FRED_API_KEY": "your_key_here"
      }
    }
  }
}

API Keys (Optional)

The server works out of the box with Yahoo Finance and CoinGecko (no keys required). For advanced features:

API Free Tier Get Key
Alpha Vantage 25 calls/day alphavantage.co
FRED Unlimited fred.stlouisfed.org

Available Tools

Stock Tools

Tool Description
get_stock_quote Real-time stock price and metrics
get_stock_history Historical OHLCV data
search_stocks Search stocks by name/ticker
get_company_overview Fundamentals and analyst data
get_technical_indicator Technical analysis (SMA, RSI, etc.)

Crypto Tools

Tool Description
get_crypto_price Real-time crypto price
get_crypto_list Top cryptos by market cap
get_crypto_history Historical price data
search_crypto Search cryptocurrencies

Market Tools

Tool Description
get_market_overview Major indices snapshot
get_sector_performance S&P 500 sector analysis
get_economic_indicator FRED economic data

Portfolio Tools

Tool Description
add_to_portfolio Add position to portfolio
remove_from_portfolio Remove position
get_portfolio_value Portfolio valuation with P&L

Usage Examples

Get Stock Quote

"What's the current price of AAPL?"
→ Uses get_stock_quote with symbol: "AAPL"

Crypto Analysis

"Compare Bitcoin and Ethereum prices over the last month"
→ Uses get_crypto_history for both coins

Portfolio Tracking

"Add 10 shares of NVDA at $450 to my portfolio"
→ Uses add_to_portfolio with type: "stock"

Market Overview

"How are the major indices performing today?"
→ Uses get_market_overview

Technical Analysis

"What's the RSI for Tesla?"
→ Uses get_technical_indicator with indicator: "RSI"

Rate Limits

The server implements automatic rate limiting to respect API limits:

API Rate Limit
Yahoo Finance 1 req/sec
CoinGecko 10-50 req/min
Alpha Vantage 5 req/min
FRED 120 req/min

Development

# Clone and install
git clone https://github.com/anthropics/finance-mcp-server
cd finance-mcp-server
npm install

# Development mode
npm run dev

# Build
npm run build

# Run
npm start

Roadmap

  • Polygon.io integration for premium users
  • Watchlist management
  • Price alerts
  • Options chain data
  • News sentiment analysis
  • Earnings calendar

Support

License

MIT © Anthropic

Disclaimer: This tool provides financial data for informational purposes only. Not financial advice. Always verify data before making investment decisions.