@filingreader/mcp-client

MCP client for FilingReader — connect Claude (Desktop, Code, or any MCP-compatible client) to 30M+ stock exchange filings across HKEX, SSE, SZSE, NYSE, NASDAQ, and more.

This package is a thin local bridge: it speaks stdio to your MCP client and forwards over SSE to the hosted FilingReader MCP server at https://mcp.filingreader.com.

What you can ask Claude

• "Search FilingReader for aircraft acquisitions on HKEX in 2024"
• "Compare what Tesla, BYD, and Rivian say about battery technology"
• "List all annual reports from Tencent (HKEX:0700)"
• "Get the full text of filing <bulletin_id> and summarise the risk factors"

Setup

1. Get your MCP key

Sign in at app.filingreader.com/mcp and copy your key.

2. Add to Claude Desktop

Edit your Claude Desktop config:

• Windows: %AppData%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "filingreader": {
      "command": "npx",
      "args": ["-y", "@filingreader/mcp-client"],
      "env": {
        "FILINGREADER_MCP_KEY": "YOUR_KEY_HERE"
      }
    }
  }
}

3. Restart Claude Desktop

Fully quit and reopen. The FilingReader tools will appear in the tool picker.

Available tools

| Tool | What it does | |------|--------------| | search_filings | Hybrid semantic + keyword search across all filings | | search_by_company | All filings from a named company | | search_by_stock_code | Filings by ticker (e.g. HKEX:0700) | | compare_companies | Side-by-side comparison on a topic | | list_company_filings | Paginated filing history with category/tag/date filters | | get_filing_full_text | Full markdown text of a single filing by bulletin_id | | get_exchange_stats | Index statistics |

Environment variables

| Variable | Required | Default | Purpose | |----------|----------|---------|---------| | FILINGREADER_MCP_KEY | yes | — | Your FilingReader API key | | FILINGREADER_MCP_URL | no | https://mcp.filingreader.com | Override the MCP server URL (for self-hosting / testing) |

Requirements

• Node.js >= 18 (uses the global fetch API)

License

MIT