HKEx Filings
Live HKEx (Hong Kong Stock Exchange) regulatory filings for AI agents.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"hkex-filings": {
"url": "https://hkex-listco-updates.ascent-partners.com/api/mcp"
}
}
}원격 엔드포인트
https://hkex-listco-updates.ascent-partners.com/api/mcpstreamable-http할 수 있는 일
도구 목록
도구 (4)
🟢get_server_info
Report this live gateway's version, transport, and hard limits. Reads nothing.
입력 스키마
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"result": {
"type": "object",
"description": "Gateway version, transport, tool list, filters, and hard limits.",
"properties": {
"name": {
"type": "string"
},
"version": {
"type": "string"
},
"transport": {
"type": "string"
},
"live": {
"type": "boolean"
},
"storage": {
"type": "string"
},
"read_only": {
"type": "boolean"
},
"tools": {
"type": "array",
"items": {
"type": "string"
}
},
"filters": {
"type": "array",
"items": {
"type": "string"
}
},
"limits": {
"type": "object"
},
"extraction": {
"type": "object"
}
}
}
},
"required": [
"result"
]
}🟢search_filings(from_date, to_date, stock_code, title_query, document_type, ...)
Search live HKEx filings in a date window (at most 31 days). ``from_date``/``to_date`` accept YYYY-MM-DD or DD/MM/YYYY. All filters are optional and combine with AND semantics: ``stock_code`` matches exactly (e.g. ``01461`` or ``1461``); ``title_query``, ``category`` and ``stock_name`` are case-insensitive substrings (e.g. category ``Dividend``); ``document_type`` matches the file type exactly (e.g. ``PDF`` or ``HTML``). Filters are applied to the fetched window, so widen ``max_results`` to catch rarer matches. ``max_results`` caps the number of filings fetched and returned (hard cap 200). Returns the matching filings — each carrying ``fileType``, ``sizeText``, ``category`` and ``newsId`` metadata — plus the HKEx-reported total for the window. Use list_filing_facets first to see which categories, types and codes exist in a window.
입력 스키마
{
"type": "object",
"properties": {
"from_date": {
"type": "string",
"description": "YYYY-MM-DD or DD/MM/YYYY"
},
"to_date": {
"type": "string",
"description": "YYYY-MM-DD or DD/MM/YYYY"
},
"stock_code": {
"type": "string",
"description": "Optional exact HKEx stock code, e.g. 01461"
},
"title_query": {
"type": "string",
"description": "Optional case-insensitive substring of the filing title"
},
"document_type": {
"type": "string",
"description": "Optional exact file type, e.g. PDF, HTML, XLS, DOC"
},
"category": {
"type": "string",
"description": "Optional case-insensitive substring of the headline category"
},
"stock_name": {
"type": "string",
"description": "Optional case-insensitive substring of the stock short name"
},
"max_results": {
"type": "integer",
"minimum": 1,
"maximum": 200,
"description": "Maximum filings to fetch and return (default 50, cap 200)"
}
},
"required": [
"from_date",
"to_date"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"result": {
"type": "object",
"description": "The filings matching the window and filters.",
"properties": {
"from": {
"type": "string",
"description": "Window start, YYYY-MM-DD"
},
"to": {
"type": "string",
"description": "Window end, YYYY-MM-DD"
},
"count": {
"type": "integer",
"description": "Filings returned"
},
"total_reported": {
"type": [
"integer",
"null"
],
"description": "HKEx-reported total for the window, when known"
},
"filters": {
"type": "object",
"description": "The filters applied"
},
"filings": {
"type": "array",
"description": "One entry per filing",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "Release date, DD/MM/YYYY"
},
"stockCode": {
"type": "string"
},
"stockName": {
"type": "string"
},
"title": {
"type": "string"
},
"link": {
"type": "string",
"description": "HKEx document URL"
},
"fileType": {
"type": "string",
"description": "PDF, HTML, XLSX, ..."
},
"sizeText": {
"type": "string",
"description": "HKEx-reported size, e.g. 53KB"
},
"category": {
"type": "string",
"description": "HKEx headline category"
},
"newsId": {
"type": "string",
"description": "HKEx news id"
}
},
"required": [
"stockCode",
"title",
"link"
]
}
}
},
"required": [
"from",
"to",
"count",
"filings"
]
}
},
"required": [
"result"
]
}🟢list_filing_facets(from_date, to_date, stock_code, max_results)
Browse what filings exist in a date window (at most 31 days) without downloading. ``from_date``/``to_date`` accept YYYY-MM-DD or DD/MM/YYYY. Returns counts of the categories (headline categories), document types, and stock codes present in the window, each sorted by frequency and capped at 50 values, plus the distinct counts. Optionally narrow to one ``stock_code``. Use this to discover valid filter values before calling search_filings; it fetches the window once and extracts no document text.
입력 스키마
{
"type": "object",
"properties": {
"from_date": {
"type": "string",
"description": "YYYY-MM-DD or DD/MM/YYYY"
},
"to_date": {
"type": "string",
"description": "YYYY-MM-DD or DD/MM/YYYY"
},
"stock_code": {
"type": "string",
"description": "Optional exact HKEx stock code to narrow the facets"
},
"max_results": {
"type": "integer",
"minimum": 1,
"maximum": 200,
"description": "Maximum filings to scan (default 50, cap 200)"
}
},
"required": [
"from_date",
"to_date"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"result": {
"type": "object",
"description": "Counts of the window's categories, document types, and stock codes.",
"properties": {
"from": {
"type": "string",
"description": "Window start, YYYY-MM-DD"
},
"to": {
"type": "string",
"description": "Window end, YYYY-MM-DD"
},
"count": {
"type": "integer",
"description": "Filings scanned"
},
"total_reported": {
"type": [
"integer",
"null"
]
},
"stock_code_filter": {
"type": "string"
},
"distinct_categories": {
"type": "integer"
},
"distinct_document_types": {
"type": "integer"
},
"distinct_stock_codes": {
"type": "integer"
},
"categories": {
"type": "array",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The category, file type, or stock code"
},
"count": {
"type": "integer",
"description": "Filings carrying this value"
}
},
"required": [
"value",
"count"
]
}
},
"document_types": {
"type": "array",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The category, file type, or stock code"
},
"count": {
"type": "integer",
"description": "Filings carrying this value"
}
},
"required": [
"value",
"count"
]
}
},
"stock_codes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The category, file type, or stock code"
},
"count": {
"type": "integer",
"description": "Filings carrying this value"
}
},
"required": [
"value",
"count"
]
}
}
},
"required": [
"from",
"to",
"count"
]
}
},
"required": [
"result"
]
}🟢get_filing(link, extract)
Download one HKEx document by its URL and extract its text and tables. ``link`` must be an HKEx document URL (host ``www1.hkexnews.hk``); any other host is rejected. With ``extract=True`` the response includes extracted ``document_text`` (truncated) and up to 30 ``tables``; set ``extract=False`` for size/content-type only.
입력 스키마
{
"type": "object",
"properties": {
"link": {
"type": "string",
"description": "HKEx document URL"
},
"extract": {
"type": "boolean",
"description": "Extract text and tables"
}
},
"required": [
"link"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"result": {
"type": "object",
"description": "The downloaded document, with text and tables when extract is true.",
"properties": {
"link": {
"type": "string"
},
"size_bytes": {
"type": "integer"
},
"content_type": {
"type": "string"
},
"document_text": {
"type": "string",
"description": "Extracted Markdown text"
},
"text_length": {
"type": "integer"
},
"text_truncated": {
"type": "boolean"
},
"tables": {
"type": "array",
"items": {
"type": "object"
}
},
"tables_omitted": {
"type": "integer"
}
},
"required": [
"link",
"size_bytes"
]
}
},
"required": [
"result"
]
}권장 프롬프트
search_filingssearch_filingsget_server_infoget_server_infosearch_filingsget_server_info기록된 호출 예시
get_filing입력 매개변수
{
"link": "https://example.com",
"extract": false
}출력 결과
{
"result": {
"content": [
{
"type": "text",
"text": "link must be an HKEx document URL under www1.hkexnews.hk"
}
],
"isError": true
},
"durationMs": 243
}커뮤니티
증거