Skip to main content

​
Prerequisites

Before installing FinMCP, ensure you have:
  • Node.js (v18 or higher recommended)
  • Python 3.10+ installed and available in your PATH
  • npm or npx for package management
FinMCP requires Python because it uses the yfinance library to fetch financial data. The Node.js component serves as the MCP server wrapper.

​
Installation Steps

1

Install FinMCP via npm

You can install FinMCP globally or run it on-demand with npx:
npm install -g finmcp
Using npx -y finmcp is recommended as it always runs the latest version without requiring a global installation.
2

Install Python Dependencies

FinMCP requires the yfinance Python package to fetch financial data:
pip install yfinance
If you cloned the FinMCP repository, you can install dependencies from the requirements file:
pip install -r python/requirements.txt
3

Verify Installation

Test that FinMCP is properly installed by checking the Python environment:
python3 -c "import yfinance; print('yfinance installed successfully')"
You should see:
yfinance installed successfully

​
Platform-Specific Notes

On Windows, FinMCP uses the python command instead of python3. Ensure Python is added to your PATH during installation.
# Verify Python is available
python --version

# Install yfinance
pip install yfinance
On macOS and Linux, FinMCP uses python3. Most systems have Python 3 pre-installed, but you may need to install pip:
# macOS (using Homebrew)
brew install python3

# Ubuntu/Debian
sudo apt install python3 python3-pip

# Install yfinance
pip3 install yfinance

​
Troubleshooting

If you see an error like “Missing Python dependencies for yfinance bridge”, ensure:
  1. Python 3.10+ is installed and in your PATH
  2. The yfinance package is installed via pip
  3. The Python executable is accessible as python3 (macOS/Linux) or python (Windows)

​
Common Issues

“python3: command not found”
  • Install Python 3.10+ for your platform
  • On Windows, use python instead of python3
“No module named ‘yfinance’”
  • Run pip install yfinance or pip3 install yfinance
  • Ensure you’re using the correct pip associated with your Python 3 installation
Permission errors during npm install
  • Use sudo on macOS/Linux: sudo npm install -g finmcp
  • Or use npx to avoid global installation: npx -y finmcp

​
Next Steps

Now that FinMCP is installed, proceed to the Quick Start guide to add it to your AI assistant:

Quick Start

Configure FinMCP with Claude or OpenCode and run your first query

Build docs developers (and LLMs) love

Get started for freeTalk to us