Skip to main content

​
What is FinMCP?

FinMCP is an MCP (Model Context Protocol) server that exposes the powerful yfinance library to AI assistants, enabling them to access real-time and historical financial market data through a simple, standardized interface. With FinMCP, AI assistants can retrieve stock prices, financial statements, analyst recommendations, insider transactions, and much more—all through natural language interactions.

Installation

Get started with FinMCP in minutes using npm or npx

Quick Start

Add FinMCP to Claude or OpenCode and run your first query

Tool Reference

Explore 50+ financial data tools available in FinMCP

​
Key Features

Access comprehensive market data including:
  • Real-time and historical stock prices
  • Financial statements (income, balance sheet, cash flow)
  • Analyst recommendations and price targets
  • Insider transactions and institutional holdings
  • Options chains and market calendars
  • Sector and industry analysis
  • Stock screening and discovery
Choose how you want your data:
  • JSON for programmatic access
  • Markdown for readable tables and summaries
  • CSV/JSON export to save data locally
  • Configurable preview limits for large datasets
Access live market data powered by yfinance:
  • Current stock quotes and fast info
  • Today’s earnings calendars and IPO schedules
  • Breaking news and research reports
  • Market status across global exchanges
Leverages the Model Context Protocol for:
  • Standardized tool definitions
  • Seamless integration with Claude, OpenCode, and other MCP clients
  • Extensible architecture for future enhancements

​
What is MCP?

The Model Context Protocol (MCP) is an open standard that enables AI assistants to securely connect to external data sources and tools. Instead of copying and pasting data or writing custom integrations, MCP provides a unified way for AI models to access information and perform actions.
FinMCP implements MCP to expose yfinance functionality, making financial data accessible to any MCP-compatible AI assistant.

​
Use Cases

FinMCP enables AI assistants to help with:
  • Investment Research: Analyze stock fundamentals, compare companies, review analyst opinions
  • Market Monitoring: Track portfolio performance, set up earnings calendars, monitor insider activity
  • Financial Analysis: Generate reports from financial statements, calculate metrics, identify trends
  • Stock Discovery: Screen for stocks meeting specific criteria, explore sectors and industries
  • Data Export: Save market data to CSV or JSON for further analysis

​
Next Steps

Install FinMCP

Set up FinMCP with npm and Python dependencies

Quick Start Guide

Run your first financial data query in minutes

Build docs developers (and LLMs) love

Get started for freeTalk to us