
MCP server: Hong Kong IPO subscription fee & margin cost calculator
MCP server: Hong Kong IPO subscription fee & margin cost calculator
·
An MCP server that gives AI assistants exact Hong Kong IPO cost maths, so they can stop guessing. It covers:
中文简介:港股打新费用计算 MCP 服务器。让 Claude、Cursor 等 AI 助手精确计算入场费(1% 佣金 + 证监会/会财局征费 + 交易费,逐项四舍五入至分)、孖展利息、回本价、情景盈亏与期望值、卖出费用(印花税向上取整至元),并查询机制 A/B、甲乙组、FINI 等规则(附出处)。公司与上市日期查询只使用 Wikidata(CC0)开放数据,不抓取港交所/披露易。免费开源(MIT)。网页版计算器:https://hk-ipo-calc.pages.dev/
Ask things like:
"I'm applying for 20 lots of an IPO at HK$8.88, 500 shares a lot, with 10× margin at 3.5% for 7 days and a HK$100 handling fee. 18,000 out of 120,000 applicants at my size got one lot. What's my entry fee, break-even price and expected value?"
The numbers come from a tested fee engine, not from the model. That engine is the same one used by the web calculator and the HK IPO Ledger Chrome extension, and the two implementations are checked to give identical results on 8,000 test values.
| Tool | What it does |
|---|---|
hk_ipo_amount_payable | Amount payable for N shares: application money + 1% brokerage + 0.0027% SFC levy + 0.00015% AFRC levy + 0.00565% trading fee |
hk_ipo_plan | Full plan: entry fee, total payable, own cash vs margin loan, interest, fixed cost, break-even price, scenario table, expected value (from allotment counts or a rate) |
hk_sell_costs | Selling costs: 0.1% stamp duty rounded up to HK$1, trading fee, levies, broker commission / platform fee |
hk_ipo_rules | Cited rule summaries: fees, allocation (Mechanism A/B from 4 Aug 2025, 18C), pools, timeline (FINI) or all |
hk_company_lookup | Look up an HK-listed company by code or name (Wikidata, CC0) |
hk_listings | Listings by date range (Wikidata, CC0, cached 24 h) |
You need Python ≥ 3.10. The easiest way to run it is with uv, which needs no install step:
uvx hk-ipo-fee-mcp # runs the stdio server
# or
pipx install hk-ipo-fee-mcp && hk-ipo-fee-mcpEdit claude_desktop_config.json. On macOS it is at ~/Library/Application Support/Claude/; on Windows at %APPDATA%\Claude\.
{
"mcpServers": {
"hk-ipo-fee": { "command": "uvx", "args": ["hk-ipo-fee-mcp"] }
}
}claude mcp add hk-ipo-fee -- uvx hk-ipo-fee-mcpAdd this to ~/.cursor/mcp.json, or to .cursor/mcp.json in a project:
{
"mcpServers": {
"hk-ipo-fee": { "command": "uvx", "args": ["hk-ipo-fee-mcp"] }
}
}Add this to .vscode/mcp.json:
{
"servers": {
"hk-ipo-fee": { "type": "stdio", "command": "uvx", "args": ["hk-ipo-fee-mcp"] }
}
}Any client that speaks MCP over stdio works. Set the command to uvx and the args to ["hk-ipo-fee-mcp"]. If you installed with pipx, set the command to hk-ipo-fee-mcp with no args.
| Variable | Default | Purpose |
|---|---|---|
HKIPO_CONTACT | project URL + maintainer email | Contact string in the Wikidata User-Agent (Wikimedia UA policy). Set your own if you query a lot |
HK_IPO_FEE_MCP_CACHE | ~/.cache/hk-ipo-fee-mcp | Cache directory for listing data |
hk_ipo_plan(offer_price=8.88, board_lot=500, lots_applied=20, margin_multiple=10, annual_rate=0.035, interest_days=7, handling_fee=100, allotted_lots=1, valid_applications=120000, successful_applicants=18000) returns:
| Entry fee (1 lot) | HK$4,484.78 |
| Total amount payable (20 lots) | HK$89,695.55 |
| Margin interest | HK$54.19 |
| Fixed cost (paid either way) | HK$154.19 |
| Break-even sell price | HK$9.289 (+4.61%), assuming zero sell commission |
(These are illustrative inputs, not a real IPO.)
git clone https://github.com/tiezhengzhang/hk-ipo-fee-mcp && cd hk-ipo-fee-mcp
python -m venv .venv && . .venv/bin/activate && pip install -e . pytest
python -m pytest -q # fee anchors + MCP stdio end-to-endMIT © 2026 Tiezheng Zhang. Listing data from Wikidata is CC0.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add hk-ipo-fee -- uvx hk-ipo-fee-mcp{
"mcpServers": {
"hk-ipo-fee": {
"args": [
"hk-ipo-fee-mcp"
],
"command": "uvx"
}
}
}code --add-mcp '{"name":"hk-ipo-fee","args":["hk-ipo-fee-mcp"],"command":"uvx"}'[mcp_servers.hk-ipo-fee]
command = "uvx"
args = ["hk-ipo-fee-mcp"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/hk-ipo-fee-mcp to learn what the "Hk Ipo Fee Mcp" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
uvx hk-ipo-fee-mcp # runs the stdio serverclaude mcp add hk-ipo-fee -- uvx hk-ipo-fee-mcpThis server runs locally, so we can't read its tool list over the web yet.
We could not run this server: it ships no npx package for our sandbox and no public endpoint. The four checks that need a live server are left out, and the grade tops out at B until one exists.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/hk-ipo-fee-mcp)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "hk-ipo-fee-mcp" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.