MCP Tools Introduction

This section introduces the core tools provided by the Financial MCP service. Each tool is designed to solve specific problems in financial report analysis, such as full-text search, industry classification, and structured navigation.

1. Company Profile Query

Query the standard code, abbreviation, and listing date of listed companies by name or stock code. Useful for verifying or completing standard codes and basic profiles of target companies.

Parameter	Type	Required	Default	Description
query	String	Yes	-	Search keyword: company name or code
size	Integer	No	5	Number of results to return

Request Parameters Example (AI Generated)

{
  "name": "searchCompanyInfo",
  "arguments": {
    "query": "Ping An Bank"
  }
}

Response Data Example (Backend Output)

[
  {
    "Short Name": "Ping An Bank",
    "Stock Code": "000001",
    "Listing Date": "1991-04-03"
  }
]

2. Report Structure Analysis

Retrieve the complete chapter directory and corresponding page numbers of a specific financial report. Understand the structural outline and quickly locate the page numbers of each chapter.

Parameter	Type	Required	Default	Description
stockCode	String	Yes	-	Stock code (e.g., "000001")
reportType	String	Yes	-	Report code (e.g., "2024a4")

Request Parameters Example (AI Generated)

{
  "name": "getReportChapters",
  "arguments": {
    "stockCode": "000026",
    "reportType": "2024a4"
  }
}

Response Data Example (Backend Output)

Financial Report Directory (000026 - 2024a4):
1. Important Notice, Table of Contents and Definitions - Page 2
2. Company Profile and Key Financial Indicators - Page 6
...
Total: 10 chapters

3. Core Statements Locator

Directly query the starting page numbers of the four core financial statements (Balance Sheet, Income Statement, Cash Flow Statement, Statement of Changes in Equity). Skip text and go straight to data tables.

Parameter	Type	Required	Default	Description
stockCode	String	Yes	-	Stock code (e.g., "000001")
reportType	String	Yes	-	Report code (e.g., "2024a4")
category	String	No	-	Specific statement name

Request Parameters Example (AI Generated)

{
  "name": "getFinancialStatementsStartPages",
  "arguments": {
    "stockCode": "000026",
    "reportType": "2024a4"
  }
}

Response Data Example (Backend Output)

Financial Statements Start Pages (000026 - 2024a4):
1. Consolidated Balance Sheet - Page 57
2. Consolidated Income Statement - Page 61
3. Consolidated Cash Flow Statement - Page 65
4. Consolidated Statement of Changes in Equity - Page 67

4. Financial Keyword Search

Full-text keyword search engine for financial reports. Quickly extract matching content fragments. Can be restricted to a specific company or search the entire database, with optional page range filters.

Parameter	Type	Required	Default	Description
keywords	List<String>	Yes	-	Keywords to search for
stockCode	String	No	-	Stock code, omitted for full database search
reportType	String	No	-	Limit search to a report type (e.g., "2024a4")
pageMin	Integer	No	-	Minimum page number
pageMax	Integer	No	-	Maximum page number

Request Parameters Example (AI Generated)

{
  "name": "financialKeywordSearch",
  "arguments": {
    "keywords": ["Net Profit", "YoY Growth"],
    "stockCode": "000001"
  }
}

Response Data Example (Backend Output)

Found 3 matching fragments:

--- Fragment 1 ---
Company: Ping An Bank (000001)
Report: 2024 Annual Report (2024a4)
Page: Page 45
Content: ...The company realized a net profit of 50.238 billion yuan in 2024...

5. Page-Level Content Reading

Extract the original text of financial reports sequentially based on specific page numbers or ranges. Ideal for deep reading of full contextual information.

Parameter	Type	Required	Default	Description
stockCode	String	Yes	-	Stock code
reportType	String	Yes	-	Report code
startPage	Integer	Yes	-	Starting page number (from 1)
pageCount	Integer	No	5	Number of continuous pages to fetch

Request Parameters Example (AI Generated)

{
  "name": "getFinancialReportPages",
  "arguments": {
    "stockCode": "000001",
    "reportType": "2024a4",
    "startPage": 10,
    "pageCount": 1
  }
}

Response Data Example (Backend Output)

Found 500 documents. Showing 1 pages starting from 10:

--- Page 10 ---
[Original page text content...]
[stock_code]: 000001
[report_type]: 2024a4