hk-ipo-fee-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HKIPO_CONTACT | No | Contact string in the Wikidata User-Agent (Wikimedia UA policy). Default is project URL + maintainer email. Set your own if you query a lot. | |
| HK_IPO_FEE_MCP_CACHE | No | Cache directory for listing data. | ~/.cache/hk-ipo-fee-mcp |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| hk_ipo_amount_payableA | Amount payable to apply for
|
| hk_ipo_planB | Full HK IPO subscription plan: entry fee, total payable, own cash vs margin loan, margin interest (loan × rate × days / 365), fixed cost, break-even sell price (after 0.1% stamp duty rounded up to HK$1, trading fee, levies, broker charges) and P&L / expected value under day-one change scenarios. annual_rate and sell_commission_rate are fractions (0.035 = 3.5%). allot_probability is 0..1, or pass valid_applications + successful_applicants from the allotment results announcement. |
| hk_sell_costsB | Costs of selling HK shares: stamp duty 0.1% (rounded up to HK$1), trading fee 0.00565%, SFC 0.0027%, AFRC 0.00015% (each to the cent) + broker commission/platform fee. Returns total and net proceeds. |
| hk_ipo_rulesB | Cited summary of HK IPO rules: topic = fees | allocation_mechanisms | pools | settlement | all. |
| hk_company_lookupA | Find HK-listed companies by English/Chinese name or stock code in Wikidata (CC0, community-maintained; verify before relying on it). Returns code, names, listing date, industry, website, Wikidata id. |
| hk_listingsA | HK listings with a listing date in Wikidata (CC0), newest first; since/until are YYYY-MM-DD. Coverage of recent IPOs is incomplete; IPO terms are NOT included. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Most tools have clearly distinct purposes, but hk_ipo_amount_payable overlaps with part of hk_ipo_plan, and hk_company_lookup overlaps with hk_listings because both surface Wikidata company/listing data. The descriptions help clarify boundaries, so the ambiguity is limited rather than severe.
All tools use snake_case with an hk_ prefix, which is predictable and readable. However, the names mix action-oriented and resource-oriented patterns (e.g. hk_company_lookup, hk_ipo_rules, hk_listings) rather than following a uniform verb_noun convention.
Six tools is well-scoped for a niche HK IPO fee and planning server. Each tool corresponds to a meaningful operation or reference surface, with no excessive or trivial tools.
The server covers core workflows: company lookup, rules, application fee calculation, subscription planning, sell costs, and listing lookup. Minor gaps remain, such as no dedicated IPO terms or allotment-results lookup, and hk_listings explicitly lacks IPO terms with incomplete recent coverage.