Financial Report Analysis MCP

v1.1.0

Data IngestionRecommendedRemoteFinance

Official AgentLadle remote MCP. Recommended order: searchCompanyInfo → financialKeywordSearch → getFinancialReportPages; locate statements with statement name + matchMode=ALL. Markets: CN-A / HK; supports latest interim reports and annual reports from the past 3 years for China A-shares (SSE/SZSE) and Hong Kong stocks. Requires agentladle.com API key.

📖 Docs

§ Connection Config

Transport Type: remote

Server Address

https://mcp.agentladle.com/mcp

Request Headers

Authorization: Bearer {env:AGENTLADLE_API_KEY}

Required Credentials

AgentLadle API KeyRequired

API Key obtained from agentladle.com

Type: headerApply →

§ Quickstart

Add the following to your MCP client configuration (Cursor, Claude Desktop, etc.):

Settings (top right) → Cursor Settings → Tools & MCP → New MCP Server. Paste the JSON below and save. Replace YOUR_API_KEY with your MCP key from agentladle.com profile.

MCP Client Configuration

{
  "mcpServers": {
    "agentladle-mcp": {
      "type": "streamableHttp",
      "url": "https://mcp.agentladle.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Config file locations

Download Cursor: https://cursor.com/
After setup, enable agentladle-mcp in Cursor chat to use the tools.

View full setup guide →

§ Tools Reference

3 tools

searchCompanyInfo

Look up listed companies by name or stock code. Returns stockCode, short name, market, and listing date. Call this first when the user mentions a company name or an unknown code, then pass stockCode and market to other tools. Supports China A-share (SSE/SZSE) and Hong Kong stocks latest interim reports and annual reports from the past 3 years; if there is no hit, retry another market.

Parameter	Type	Required	Description
query	string	✓	Company name or stock code. CN-A: 6 digits (000001); HK: 5 digits (00700)
market	string	✓	Required market: CN-A / HK. Query one market per call
size	number	—	Number of results to return, default 5, max 100

Returns:CompanyInfo[]

financialKeywordSearch

Full-text keyword search across financial reports. Extract 1–5 core keywords (never full sentences) and get matching fragments with page numbers. Use Simplified Chinese financial terms for CN-A and English for HK. reportType is required when stockCode is omitted. To locate a statement or chapter, use its name as the keyword with matchMode=ALL.

Parameter	Type	Required	Description
keywords	string[]	✓	1–5 core keywords; do not pass full sentences
stockCode	string	—	Prefer the code from searchCompanyInfo. Omit for cross-company search
reportType	string	—	Annual e.g. 2025a4, interim e.g. 2026h2. Required when stockCode is omitted
market	string	—	Optional: CN-A / HK. Omit to search all markets
matchMode	string	—	Match mode: ANY (default) / ALL / MOST (at least 70%)
size	number	—	Number of fragments to return, default 5, max 1000
pageMin	number	—	Minimum page number (inclusive)
pageMax	number	—	Maximum page number (inclusive)

Returns:SearchResult[]

getFinancialReportPages

Read original report text by page range. Use a known page number directly; to discover the TOC, call with startPage=1 and pageCount=3–5, then call again at the target page. pageCount defaults to 5 and maxes at 5. For specific facts, prefer financialKeywordSearch first, then read the returned page.

Parameter	Type	Required	Description
stockCode	string	✓	Prefer the code from searchCompanyInfo. CN-A 6 digits, HK 5 digits
reportType	string	✓	Annual e.g. 2025a4, interim e.g. 2026h2
startPage	number	✓	Starting page number (1-based)
pageCount	number	—	Number of pages to fetch, default 5, max 5
market	string	—	Optional: CN-A / HK. Omit to search all markets

Returns:PageContent[]

§ Examples

Once configured, you can ask the AI directly:

In-depth analysis of financial report notes

Analyze BYD's 2025 accounts receivable details

Resolve code and market with searchCompanyInfo, locate pages via financialKeywordSearch, then read originals with getFinancialReportPages.

Statement reconstruction and management analysis

Extract Gree Electric's 2025 balance sheet and reconstruct it into a management balance sheet

Locate the start page with financialKeywordSearch (keywords=["consolidated balance sheet"], matchMode=ALL), then read the statement via getFinancialReportPages.

Macro theme scanning across the entire market

Which companies mentioned 'solid-state battery' in their 2025 annual reports

Omit stockCode and pass reportType with keywords for cross-company search; optionally read hit pages afterward.