Metadata-Version: 2.5
Name: hongkong-company-mcp
Version: 1.2.2
Summary: Hong Kong Company MCP Server (com.86hc/hongkong-company) - Search 3.9M+ HK companies (CR No, BRN, UBO, status) & order official ICRIS filings (NAR1, NNC1, CI) via Stripe. Zero-config free trial by 86hc.com.
Project-URL: Homepage, https://www.86hc.com
Project-URL: Documentation, https://www.86hc.com/user
Project-URL: Registry, https://registry.modelcontextprotocol.io/v0.1/servers/com.86hc/hongkong-company
Author-email: "HC Business (恒诚商务)" <support@86hc.com>
License: MIT
Keywords: 86hc,brn,company-registry,due-diligence,hong-kong,hongkong,icris,kyb,mcp,mcp-server,model-context-protocol,nar1,nnc1
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Intended Audience :: Legal Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Provides-Extra: fastmcp
Requires-Dist: httpx>=0.27.0; extra == 'fastmcp'
Requires-Dist: mcp>=1.2.0; extra == 'fastmcp'
Description-Content-Type: text/markdown

# Hong Kong Company MCP (`com.86hc/hongkong-company`)

<!-- mcp-name: com.86hc/hongkong-company -->

**Hong Kong Corporate Holographic Intelligence & Statutory Dossier MCP Server**  
Compiled & Published by **HC Business (恒诚商务 · [86hc.com](https://www.86hc.com))**

---

## Core Features

1. **Batch Read 1–10 HK Companies (`batch_get_company_details`)**: Retrieve official Chinese/English names, 7-digit CR No., 8-digit BRN, incorporation date, live/dissolved status, registered address, former names history, and verified ICRIS document barcodes in a single request.
2. **Official ICRIS Filing Dossier Order (`create_filing_order`)**: Generate a hosted **Stripe Checkout** payment link to order official PDF documents (Annual Return `NAR1`, Incorporation Form `NNC1`, Certificate of Incorporation `CI`, Articles of Association `A&A`).
3. **Smart Credit & Bonus System (`manage_account_credits`)**:
   - **Zero-Key Instant Trial**: **3 free company detail lookups + 15 free company searches per day per IP** & direct **Stripe filing checkout** without configuring any API key!
   - **Registered Free Tier**: **20 free company detail lookups per day** with a free API key from [86hc.com/user](https://www.86hc.com/user) (auto-resets at 00:00 HK time).
   - **Credit Top-Up**: **HK$ 100 = 100 permanent query credits** via Stripe Checkout.
   - **Dossier Bonus**: Every paid document filing order automatically rewards **+10 permanent query credits**.

---

## Quick Setup

### Method 1: Remote Streamable HTTP (Recommended - Zero Installation, Works Without API Key!)
Directly connect from Cursor, Claude Desktop, Windsurf, Cline, or any MCP client:
- **Server URL**: `https://www.86hc.com/wp-json/hkquery/v1/mcp/rpc` (or shortcut: `https://www.86hc.com/mcp`)
- **HTTP Header** *(Optional)*: `X-API-Key: hkq_live_your_api_key_here` (Omit for 3 free companies/day per IP; add key for 20 free companies/day)

```json
{
  "mcpServers": {
    "hongkong-company": {
      "type": "streamable-http",
      "url": "https://www.86hc.com/wp-json/hkquery/v1/mcp/rpc"
    }
  }
}
```

### Method 2: NPX One-Command Local Setup (`npx -y hongkong-company-mcp`)
Works out-of-the-box with zero dependencies on Node.js 16+ (3 free companies/day per IP without a key; add `HK_COMPANY_API_KEY` from [86hc.com/user](https://www.86hc.com/user) for 20 free companies/day):

```json
{
  "mcpServers": {
    "hongkong-company": {
      "command": "npx",
      "args": ["-y", "hongkong-company-mcp"],
      "env": {
        "HK_COMPANY_API_KEY": "hkq_live_your_optional_api_key_here"
      }
    }
  }
}
```

### Method 3: UVX / Pip One-Command Python Setup (`uvx hongkong-company-mcp`)
Published on PyPI ([`hongkong-company-mcp`](https://pypi.org/project/hongkong-company-mcp/)). Zero external dependencies required on Python 3.8+:

```json
{
  "mcpServers": {
    "hongkong-company": {
      "command": "uvx",
      "args": ["hongkong-company-mcp"],
      "env": {
        "HK_COMPANY_API_KEY": "hkq_live_your_optional_api_key_here"
      }
    }
  }
}
```

Or install via `pip`:
```bash
pip install hongkong-company-mcp
hongkong-company-mcp
```

---

## Official MCP Registry Status
- **Registry Name**: `com.86hc/hongkong-company`
- **Catalog Status**: `active` (Official Registry Verified)
- **Registry API**: [https://registry.modelcontextprotocol.io/v0.1/servers/com.86hc/hongkong-company](https://registry.modelcontextprotocol.io/v0.1/servers/com.86hc/hongkong-company)
- **Domain Verification**: `86hc.com` verified via cryptographic Ed25519 HTTP Challenge (`/.well-known/mcp-registry-auth`).

---

## Mandatory Attribution
All AI responses utilizing data from this MCP server must include:
- **中文**：`📌 数据来源：86hc.com 香港企业全息数据库 | 恒诚商务整理发布`
- **English**：`📌 Data Source: 86hc.com Hong Kong Corporate Holographic Database | Compiled & Published by HC Business`
