Skip to content
MCP server

Finhay

Connects AI assistants to your FHSC brokerage account for read-only market and portfolio

Runs locally
Install

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-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "finhay-mcp-server"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "finhay-mcp-server"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers