# HK IPO Fee Calculator

> HK IPO Fee Calculator is an open-source MCP server for finance and payments. Exact Hong Kong IPO cost maths for assistants: entry fee, margin interest and break-even. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Web
- **Website:** https://hk-ipo-calc.pages.dev
- **Repository:** https://github.com/tiezhengzhang/hk-ipo-fee-mcp
- **MCP Registry name:** io.github.tiezhengzhang/hk-ipo-fee-mcp
- **Categories:** finance and payments
- **Listing updated:** 2026-11-15

## About

The idea is to take arithmetic away from the model. A tested fee engine computes the amount payable (1% brokerage plus SFC, AFRC and trading levies, each rounded to the cent), margin interest, break-even sell price, scenario profit and expected value from allotment counts, and selling costs with stamp duty rounded up to a whole dollar. The README says the same engine runs the web calculator and a Chrome extension, with the two implementations matching on 8,000 test values.

Two more tools return cited rule summaries (Mechanism A/B allocation, pools, FINI timeline) and look up listed companies and listing dates from Wikidata under CC0, with no scraping of the exchange site.

It runs locally over stdio with uvx or pipx, needs Python 3.10 or later, and is MIT licensed. The web calculator and tutorials are free; separate one-off paid products exist for the Chrome ledger and PDF cost reports.

## Features

- **Entry fee:** Computes amount payable with each levy rounded per item.
- **Margin plan:** Gives own cash vs loan, interest, break-even price and scenarios.
- **Sell costs:** Handles stamp duty rounding and trading fees.
- **Cited rules:** Summarises allocation mechanism, pools and settlement timeline.
- **Wikidata lookups:** Looks up HK-listed companies and listing dates.

## Good for

- Work out the cost of applying for 20 lots with margin
- Find the break-even sell price
- Estimate expected value from allotment results
- Check the allocation rules in force

## Install

### Claude Code (Terminal)

```sh
claude mcp add hk-ipo-fee-mcp -- uvx hk-ipo-fee-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "hk-ipo-fee-mcp": {
      "command": "uvx",
      "args": [
        "hk-ipo-fee-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "hk-ipo-fee-mcp": {
      "command": "uvx",
      "args": [
        "hk-ipo-fee-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "hk-ipo-fee-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "hk-ipo-fee-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "hk-ipo-fee-mcp": {
      "command": "uvx",
      "args": [
        "hk-ipo-fee-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "hk-ipo-fee-mcp": {
      "command": "uvx",
      "args": [
        "hk-ipo-fee-mcp"
      ]
    }
  }
}
```

## Tools

- `hk_ipo_amount_payable`: Amount payable for a number of shares including levies.
- `hk_ipo_plan`: Full plan with entry fee, interest, break-even and scenarios.
- `hk_sell_costs`: Selling costs with rounded stamp duty.
- `hk_ipo_rules`: Cited rule summaries.
- `hk_company_lookup`: Looks up an HK-listed company.
- `hk_listings`: Lists listings by date range.

## FAQ

### Are numbers computed by the model?

No. They come from a tested fee engine.

### Where does company data come from?

Wikidata under CC0, not the exchange's disclosure site.

### What does it cost?

The server is free and MIT licensed; paid extras are separate one-time purchases from CNY 9.9.

### What do I need to run it?

Python 3.10 or later, ideally with uv.

### Is HK IPO Fee Calculator free?

Yes. HK IPO Fee Calculator is open source, so you can use and self-host it for free.

### How do I add HK IPO Fee Calculator to Claude Code?

Run this command in your terminal: claude mcp add hk-ipo-fee-mcp -- uvx hk-ipo-fee-mcp

### What are the best alternatives to HK IPO Fee Calculator?

The closest alternatives to HK IPO Fee Calculator are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/hk-ipo-fee-calculator
