# Finhay

> Finhay is a free MCP server for finance and payments. Connects AI assistants to your FHSC brokerage account for read-only market and portfolio. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, CLI, Web, Self-hosted
- **Website:** https://www.finhay.com.vn/finhay-skills
- **Repository:** https://github.com/finhay/mcp-server
- **MCP Registry name:** io.github.finhay/mcp-server
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [stock market data](https://ai-powered.com/categories/stock-market-data)
- **Listing updated:** 2026-11-21

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-server -- npx -y finhay-mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "finhay-mcp-server"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "finhay-mcp-server"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "finhay-mcp-server"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "finhay-mcp-server"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "finhay-mcp-server"
      ]
    }
  }
}
```

## Tools

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

## 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.

## Alternatives

- [Finhay MCP](https://ai-powered.com/mcp/finhay-mcp): Finhay MCP is an MCP server for finance and payments.
- [Finance MCP Server](https://ai-powered.com/mcp/finance-mcp-server): Finance MCP Server is a paid MCP server for finance and payments.
- [Portfellow](https://ai-powered.com/mcp/portfellow): Portfellow is a freemium MCP server for finance and payments.
- [Yahoo Finance](https://ai-powered.com/mcp/yahoo-finance-2): Yahoo Finance is an open-source MCP server for finance and payments.
- [Finance MCP](https://ai-powered.com/mcp/finance-mcp-3): Finance MCP is an open-source MCP server for finance and payments.
- [Algolab MCP](https://ai-powered.com/mcp/algolab-mcp): Algolab MCP is a freemium MCP server for finance and payments.
- [Market Data](https://ai-powered.com/mcp/market-data-4): Market Data is an MCP server for finance and payments.
- [FinanceQuery](https://ai-powered.com/mcp/financequery): FinanceQuery is an open-source MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/finhay
