Finance Agent MCP Server

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.
1

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal
git clone https://github.com/AI-Hub-Admin/finance-agent-mcp-server
cd finance-agent-mcp-server

Then follow the repository README for any remaining dependency or build steps before continuing.

2

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal
claude mcp add finance-agent -- node "<FULL_PATH_TO_FINANCE_AGENT_MCP_SERVER>/dist/index.js"

Replace <FULL_PATH_TO_FINANCE_AGENT_MCP_SERVER>/dist/index.js with the actual folder you prepared in step 1.

README.md

Free and public financial data from global markets without API keys.

finance-agent-mcp-server

MCP Server of free and public available Financial Data without need of API keys from trusted sites or institues.

This MCP server is a mcp wrapper of pypi package FinanceAgent (https://github.com/AI-Hub-Admin/FinanceAgent) which aims to provide free and public available financial data from open websites of trusted sites. You can help your AI system to get realtime Financial Data From Global Market such US (NASDAQ/NYSE/DOW), China (HKEX, Shenzhen, Shanghai), Europe, India, Japan (TSE), etc.

Features

  1. Get Realtime Stock Price data from global market. Supports US (NASDAQ,NYSE,DOW) China (HKEX, SHANGHAI SH, SHENZHEN SZ) India (NSE) and London (LSE) of realtime crawling or API access to trusted sites, such as nasdaq.com,xueqiu.com,morningstar.com,marketbeat.com,etc.

Supported source

REGION MARKET INVESTMENT TYPE API DATA SOURCE
United Status US (NASDAQ,NYSE,DOW) STOCK morningstar.com
United Status US (NASDAQ,NYSE,DOW) STOCK zacks.com
United Status US (NASDAQ,NYSE,DOW) STOCK marketbeat.com
Asia HK (HKEX) STOCK hkex.com
Asia CN_MAINLAND (SHANGHAI SH, SHENZHEN SZ) STOCK xueqiu.com
Asia India (NSE) STOCK moneycontrol.com
Europe London (LSE) STOCK stockanalysis.com
Asia Toyko (TSE) STOCK NA

Sample Output


#### HK Stock Info
-----------------------------------
symbol|1024
avg_price|49.650 HKD
high|50.950 HKD
low|47.600 HKD
previous_close|50.850 HKD
update_time|14 Oct 2024 18:33
market_capitalization|214.06 B HKD
pe_ratio|31.15
source|HKEX, https://www.hkex.com.hk/Market-Data/Securities-Prices/Equities/Equities-Quote?sym=1024&sc_lang=en
data_source|hkex.com
-----------------------------------

Tools

get_stock_price_global_market(symbol_list: List[str], market: str) -> str:

get_stock_price_global_market(symbol_list: List[str], market: str) -> str:

Parameters

-symbol_list: symbol_list (List): List of Symbols, such as Tencent: 700, Kuaishou: 1024, Tesla (TSLA), Microsoft(MSFT), Google (GOOG), London Stock Exchange Market, Shell (quote: SHEL), Unilever (quote: ULVR)

-market (str): "HK", "CN_MAINLAND", "US", "LSE", "NSE_INDIA", etc.

MCP Integration

{
    "mcpServers": {
        "finance-agent-mcp-server": {
            "command": "uv",
            "args": ["--directory", "/path_to_folder/finance-agent-mcp-server/src/finance-agent-mcp-server", "run", "server.py"]
        }
    }
}
AI Agent Marketplace Tracking

Tools (1)

get_stock_price_global_marketRetrieves real-time stock price data for a list of symbols from a specified global market.

Configuration

claude_desktop_config.json
{"mcpServers": {"finance-agent-mcp-server": {"command": "uv", "args": ["--directory", "/path_to_folder/finance-agent-mcp-server/src/finance-agent-mcp-server", "run", "server.py"]}}}

Try it

Get the current stock price for Tesla (TSLA) and Microsoft (MSFT) from the US market.
What is the latest stock information for Kuaishou (1024) on the HK market?
Retrieve the current market data for Shell (SHEL) on the London Stock Exchange.
Find the latest stock price for Tencent (700) in the Hong Kong market.

Frequently Asked Questions

What are the key features of Finance Agent?

Real-time stock price retrieval from global markets. Supports US, China, India, and Europe market data. No API keys required for data access. Aggregates data from trusted sources like NASDAQ, HKEX, and Morningstar.

What can I use Finance Agent for?

Automated financial analysis and reporting for AI agents. Tracking global stock performance across multiple international exchanges. Integrating real-time market data into investment research workflows. Monitoring specific stock symbols without managing multiple API subscriptions.

How do I install Finance Agent?

Install Finance Agent by running: uv --directory /path_to_folder/finance-agent-mcp-server/src/finance-agent-mcp-server run server.py

What MCP clients work with Finance Agent?

Finance Agent works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Finance Agent docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare