Skip to content
MCP server

HK IPO Fee Calculator

Exact Hong Kong IPO cost maths for assistants: entry fee, margin interest and break-even

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, Web
Runs
Locally
Version
0.1.0
Listing updated
2 days ago

About HK IPO Fee Calculator

HK IPO Fee Calculator is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "hk-ipo-fee-mcp": {
      "command": "uvx",
      "args": [
        "hk-ipo-fee-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "hk-ipo-fee-mcp": {
      "command": "uvx",
      "args": [
        "hk-ipo-fee-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

MIT; paid extras (Chrome ledger Pro from CNY 39, reports from CNY 9.9) are separate

Prices change. Check hk-ipo-calc.pages.dev before you buy.

HK IPO Fee Calculator 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 to HK IPO Fee Calculator

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government