Finhay
Connects AI assistants to your FHSC brokerage account for read-only market and portfolio
Finhay is a free MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
- Pricing
- Free
- Platforms
- API, CLI, Web
- Runs
- Locally
- Version
- 1.0.8
- Listing updated
Similar MCP servers
Install
Run in a terminal
claude mcp add mcp-server -- npx -y finhay-mcp-serverAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"finhay-mcp-server"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"finhay-mcp-server"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"finhay-mcp-server"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"finhay-mcp-server"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"finhay-mcp-server"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
About Finhay
Finhay MCP links an AI assistant such as Claude or ChatGPT to a Finhay Securities (FHSC) account. Once you approve the connection, the assistant can read your holdings, account balances, profit and loss for the day, and order history, alongside Vietnamese market data covering stocks, indices, bonds, funds, ETFs, forex, crypto, commodities and macro indicators.
The connection is designed for reading only. It does not place trades, and access is granted scope by scope after you sign in with your FHSC credentials. You can disconnect from inside the AI app at any time, although data already shared is not removed.
The server suits retail investors on the Vietnamese market who want to ask questions about their own portfolio without copying figures into a chat. Developers can also run the open npm package locally over stdio, which is listed in the MCP registry as version 1.0.8.
Tools this server provides (10)
Taken from the project documentation; the running server may differ.
- get_stock_quote
- Real-time stock price
- get_stock_order_book
- Current order book depth for a stock
- get_stock_history
- Historical stock prices
- get_company_overview
- Company financial overview
- get_portfolio_positions
- Currently held portfolio positions
- get_account_summary
- Account balance, margin and debt for a sub-account
- get_pnl_today
- Profit and loss for the day
- get_order_history
- Order history
- get_macro_indicator
- Macroeconomic indicator data
- list_news
- List of market news
What it does
- Read-only account access
- Assistants can view portfolio positions, balances and order history but cannot submit trades through this connection.
- Scoped permissions
- You review the data categories requested during sign-in and grant only what you are comfortable sharing.
- Broad market data coverage
- Quotes, history, order books and fundamentals are available across stocks, indices, bonds, funds, ETFs, forex, crypto and commodities.
- Macro and news feeds
- Economic calendar events, macro indicator series, bank interest rates and market news can be queried.
- Revocable connection
- Disconnecting Finhay in the AI application stops further data sharing.
Good for
- Asking an AI assistant how much profit or loss you made today across your holdings
- Building a daily overview of market indices and top movers in Vietnam
- Comparing historical price trends for a stock, fund or bond before deciding
- Checking foreign room, foreign flows and technical indicators for a listed stock
- Following economic calendar events and macro data releases
Pricing
Free
Free to connect with an FHSC account; AI plan and trading fees billed separately
Prices change. Check finhay.com.vn before you buy.
Finhay FAQ
Can the AI place trades through Finhay?
No. The standard connection is read-only and does not execute orders. A separate trading version is offered through a custom connection, and orders must be confirmed by you through FHSC's approved method.
Does Finhay cost money?
It is currently free to connect and requires only an FHSC account. Fees for an AI service plan and any trading fees are charged separately.
Do I need programming skills to use Finhay?
No. You connect it from the connector settings of a supported AI app by signing in with your FHSC account.
Can I stop sharing my data?
Yes. Disconnect Finhay in the AI application to stop sharing. Revoking access does not delete data that was already shared.
How do I add Finhay to Claude Code?
Run this command in your terminal: claude mcp add mcp-server -- npx -y finhay-mcp-server
What are the best alternatives to Finhay?
The closest alternatives to Finhay are Finhay MCP, Finance MCP Server, Portfellow, Yahoo Finance and Finance MCP.
Where this comes from
- Description: written from the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.
