Skip to main content

Hong Kong Finance Data MCP Server

GitHub Repository License: MIT

This is an MCP server that provides access to finance related data in Hong Kong through a FastMCP interface.

Features

  1. Monthly statistics on the number of new and active business registrations in Hong Kong
  2. Quarterly statistics on residential mortgage loans in negative equity in Hong Kong
  3. Credit card lending survey results in Hong Kong
  4. Coin cart schedule in Hong Kong
  5. Get list of hotlines for reporting loss of credit card from Hong Kong banks
  6. Get information of Tender Invitation and Notice of Award of Contracts from Hong Kong Monetary Authority
  7. Daily figures of Hong Kong Interbank Interest Rates (HIBOR)
  8. Information on Automated Teller Machines (ATMs) of retail banks in Hong Kong
  9. Monthly statistics on stamp duty collected from transfer of Hong Kong stock (both listed and unlisted)
  10. Information on bank branch locations of retail banks in Hong Kong
  11. Information on fraudulent bank websites and phishing scams reported to HKMA

Examples

  • What is the number of new business registered in Hong Kong 2024?
  • What is the negative loan situation in Hong Kong Q1 2025 compare with Q1 2024?
  • Write a commentary about the latest residential mortgage loans in negative equity in Hong Kong
  • How is current Hong Kong economy by referencing credit lending data and residential mortgage loans in negative equity?
  • What are the recent trends in HIBOR rates over the past month?
  • Where can I find ATMs in Yuen Long district that support HKD and RMB currencies?
  • Can you list the recent fraudulent bank websites reported to HKMA?

Assume chart tool is available:

  • Plot a line chart showing trend and number of new business registered each month from Jan to Dec in Hong Kong 2024.

Data Source

Setup

  1. Clone this repository
  2. Install Python dependencies:
    pip install -r requirements.txt
    
  3. Run the server:
    python server.py
    

Running Options

  • Default stdio mode: python server.py
  • SSE mode (port 8000): python server.py --sse

Cline Integration

To connect this MCP server to Cline using stdio:

  1. Add this configuration to your Cline MCP settings (cline_mcp_settings.json):
{
  "hk-finance": {
    "disabled": false,
    "timeout": 3,
    "type": "stdio",
    "command": "uvx",
    "args": [
      "hkopenai.hk-finance-mcp-server"
    ]
  }
}

Testing

Tests are available in the tests/ directory. Run with:

pytest

Metadata

Release files for iflow-mcp_hkopenai_hk-finance-mcp-server 0.1.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for iflow-mcp_hkopenai_hk-finance-mcp-server 0.1.8
File Size Uploaded
iflow_mcp_hkopenai_hk_finance_mcp_server-0.1.8.tar.gz 21.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for iflow-mcp_hkopenai_hk-finance-mcp-server 0.1.8
File Interpreter ABI Platform
iflow_mcp_hkopenai_hk_finance_mcp_server-0.1.8-py3-none-any.whl Python 3 none any Details

Total release size: 41.2 kB

Release files / iflow_mcp_hkopenai_hk_finance_mcp_server-0.1.8.tar.gz

Download URL iflow_mcp_hkopenai_hk_finance_mcp_server-0.1.8.tar.gz
Size 21.1 kB
Tags Source
SHA-256 checksum
How to use checksums
587e78241748c60d3630e1c425d99ec4bd448a425bea943af9e3b0e94ef1b649
BLAKE2b-256 checksum
How to use checksums
1f47673650b5496ac41d39afc51f80dde52c78a611ddf1140deaedb6f9a93f3a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.27 {"installer":{"name":"uv","version":"0.9.27","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / iflow_mcp_hkopenai_hk_finance_mcp_server-0.1.8-py3-none-any.whl

Download URL iflow_mcp_hkopenai_hk_finance_mcp_server-0.1.8-py3-none-any.whl
Size 20.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3666f78bf416e80bb47bc974e567c6b095f7fc02664b8874b2f5f24823768d83
BLAKE2b-256 checksum
How to use checksums
04374eea09dff04a466fb2304f8a9f7cfea6067a0571e3435f1fa691112dc747
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.27 {"installer":{"name":"uv","version":"0.9.27","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

0.1.8 This release

2 release files

0.1.7

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page