### MCP Server Configuration Example

Source: https://fuyao.aicubes.cn/docs/mcp/overview

Example configuration for MCP servers, specifying type, URL, and headers for API authentication.

```json
{
  "mcpServers": {
    "fuyao-a-share": {
      "type": "http",
      "url": "https://fuyao.aicubes.cn/mcp/a-share",
      "headers": {
        "X-api-key": "<your-api-key>"
      }
    },
    "fuyao-a-share-index": {
      "type": "http",
      "url": "https://fuyao.aicubes.cn/mcp/a-share-index",
      "headers": {
        "X-api-key": "<your-api-key>"
      }
    },
    "fuyao-meta": {
      "type": "http",
      "url": "https://fuyao.aicubes.cn/mcp/meta",
      "headers": {
        "X-api-key": "<your-api-key>"
      }
    }
  }
}
```

--------------------------------

### get_a_share_financials_cash_flow_statements

Source: https://fuyao.aicubes.cn/docs/mcp/tools/get_a_share_financials_cash_flow_statements

获取单只 A 股标的的整体合并现金流量表多期序列。取数模式同利润表：不传 `start`/`end` 返回最近 `limit` 期；同时传 `start`+`end` 返回时间区间内全部报告期。均按 `period_end` 降序。返回经营 / 投资 / 筹资活动现金流量净额、现金及现金等价物净增加额等字段。

```APIDOC
## GET /api/a-share/financials/cash-flow-statements

### Description
获取单只 A 股标的的整体合并现金流量表多期序列。取数模式同利润表：不传 `start`/`end` 返回最近 `limit` 期；同时传 `start`+`end` 返回时间区间内全部报告期。均按 `period_end` 降序。返回经营 / 投资 / 筹资活动现金流量净额、现金及现金等价物净增加额等字段。

### Method
GET

### Endpoint
/api/a-share/financials/cash-flow-statements

### Parameters
#### Query Parameters
- **thscode** (string) - Required - 单只标的 thscode，不接受逗号；含交易所后缀（如 `600519.SH`）。
- **period** (string) - Required - 报告期类型：`annual`(仅 Q4) / `quarterly`(每季度末)。
- **limit** (integer) - Optional - 最近 N 期模式：范围 `[1, 20]`。与 `start`/`end` 互斥。
- **start** (long) - Optional - 时间区间模式：起始毫秒戳，需与 `end` 同传；窗口 ≤ 10 年。
- **end** (long) - Optional - 时间区间模式：结束毫秒戳，`end >= start`。

### Request Example
```json
{
  "example": "GET /api/a-share/financials/cash-flow-statements?thscode=600519.SH&period=annual&limit=5"
}
```

### Response
#### Success Response (200)
- **field1** (type) - Description

#### Response Example
```json
{
  "example": "response body"
}
```
```

--------------------------------

### A-Share Index Historical K-Line Response Example

Source: https://fuyao.aicubes.cn/docs/api-reference/a-share-index

This is an example of a successful response for historical K-line data for an A-Share Index. The 'data.adjust' field is always null for index responses.

```json
{
  "code": 0,
  "message": "success",
  "request_id": "b9f91af9c77a42d6b8a04738793d2fa2",
  "data": {
    "timestamp": 1747584000000,
    "adjust": null,
    "item": [
      {
        "date_ms": 1716134400000,
        "open_price": 3108.22,
        "high_price": 3125.74,
        "low_price": 3101.15,
        "close_price": 3120.68,
        "volume": 281000000,
        "turnover": 360000000000
      }
    ]
  }
}
```

--------------------------------

### AI Agent Scenario 3: Get Stock Code List

Source: https://fuyao.aicubes.cn/docs/mcp/overview

Example scenario for retrieving a list of all A-share stock codes. It involves calling get_meta_tickers_list with pagination.

```text
User: "列出所有 A 股代码"

1. `fuyao-meta-mcp` → `get_meta_tickers_list`, `asset_type: "a-share"`, `limit: 1000`, `offset: 0`
2. 若返回数量等于 limit，递增 offset 继续调用直到取尽
```

--------------------------------

### get_a_share_financials_balance_sheets

Source: https://fuyao.aicubes.cn/docs/mcp/tools/get_a_share_financials_balance_sheets

获取单只 A 股标的的整体合并资产负债表多期序列。取数模式同利润表：不传 `start`/`end` 返回最近 `limit` 期；同时传 `start`+`end` 返回时间区间内全部报告期。均按 `period_end` 降序。返回资产总计、流动资产、货币资金、负债合计、股东权益合计等字段。

```APIDOC
## GET /api/a-share/financials/balance-sheets

### Description
获取单只 A 股标的的整体合并资产负债表多期序列。支持按报告期类型、最近 N 期或时间区间获取数据。

### Method
GET

### Endpoint
/api/a-share/financials/balance-sheets

### Parameters
#### Query Parameters
- **thscode** (string) - Required - 单只标的 thscode，不接受逗号；含交易所后缀（如 `000858.SZ`）。
- **period** (string) - Required - 报告期类型：`annual`(仅 Q4) / `quarterly`(每季度末)。
- **limit** (integer) - Optional - 最近 N 期模式：范围 `[1, 20]`。与 `start`/`end` 互斥。默认值: `4`。
- **start** (long) - Optional - 时间区间模式：起始毫秒戳，需与 `end` 同传；窗口 ≤ 10 年。
- **end** (long) - Optional - 时间区间模式：结束毫秒戳，`end >= start`。

### Response
#### Success Response (200)
- **data** (array) - 资产负债表数据列表。
  - **period_end** (long) - 报告期结束日期（毫秒时间戳）。
  - **thscode** (string) - 标的唯一代码。
  - **period_type** (string) - 报告期类型 (`annual` 或 `quarterly`)。
  - **assets** (number) - 资产总计。
  - **current_assets** (number) - 流动资产。
  - **monetary_fund** (number) - 货币资金。
  - **liabilities** (number) - 负债合计。
  - **shareholder_equity** (number) - 股东权益合计。
  - ... (其他财务字段)

#### Error Response (400/404/500)
- **message** (string) - 错误信息。

### Request Example
```
GET /api/a-share/financials/balance-sheets?thscode=000858.SZ&period=annual&limit=5
```

### Response Example
```json
{
  "data": [
    {
      "period_end": 1672531200000,
      "thscode": "000858.SZ",
      "period_type": "annual",
      "assets": 1234567890.00,
      "current_assets": 876543210.00,
      "monetary_fund": 123456789.00,
      "liabilities": 543210987.00,
      "shareholder_equity": 691356803.00
    }
    // ... more periods
  ]
}
```
```

--------------------------------

### Income Statement Response Example

Source: https://fuyao.aicubes.cn/docs/api-reference/financials

Example JSON response structure for an A-share income statement query, including metadata and financial data fields.

```json
{
  "code": 0,
  "message": "success",
  "request_id": "e5f6g7h8",
  "data": {
    "timestamp": 1735574400000,
    "item": [
      {
        "thscode": "600519.SH",
        "ticker": "600519",
        "period": "annual",
        "fiscal_year": 2024,
        "fiscal_period": "FY",
        "report_date_ms": 1735574400000,
        "period_end_ms": 1735574400000,
        "currency": "CNY",
        "operating_income": 174144000000,
        "operating_costs": 13000000000,
        "operating_expenses": 50000000000,
        "sales_fee": 5000000000,
        "manage_fee": 9000000000,
        "research_and_development_expenses": 150000000,
        "operating_profit": 124000000000,
        "interest_expenses": 0,
        "profit_total": 124000000000,
        "income_tax_expense": 31000000000,
        "net_profit": 93000000000,
        "parent_holder_net_profit": 86000000000,
        "basic_eps": 68.50
      }
    ]
  }
}
```

--------------------------------

### Balance Sheet Response Example

Source: https://fuyao.aicubes.cn/docs/api-reference/financials

Example JSON response structure for an A-share balance sheet query, including metadata and balance sheet data fields.

```json
{
  "code": 0,
  "message": "success",
  "request_id": "f6g7h8i9",
  "data": {
    "timestamp": 1735574400000,
    "item": [
      {
        "thscode": "000858.SZ",
        "ticker": "000858",
        "period": "quarterly",
        "fiscal_year": 2024,
        "fiscal_period": "Q4",
        "report_date_ms": 1735574400000,
        "period_end_ms": 1735574400000,
        "currency": "CNY",
        "assets_total": 250000000000,
        "total_current_assets": 200000000000,
        "non_current_nets_total": 50000000000,
        "cash": 130000000000,
        "accounts_receivable": 500000000,
        "total_debt": 60000000000,
        "holder_equity_total": 190000000000
      }
    ]
  }
}
```

--------------------------------

### Get A Share Prices Snapshot Tool

Source: https://fuyao.aicubes.cn/docs/mcp/overview

Tool for retrieving a snapshot of A-share market prices. Corresponds to the REST API GET /api/a-share/prices/snapshot.

```json
{
  "mcpServers": {
    "fuyao-a-share-mcp": {
      "type": "http",
      "url": "/mcp/a-share",
      "tools": [
        {
          "name": "get_a_share_prices_snapshot",
          "description": "A股行情快照",
          "rest_api": "GET /api/a-share/prices/snapshot"
        }
      ]
    }
  }
}
```

--------------------------------

### Get A Share Index Prices Snapshot Tool

Source: https://fuyao.aicubes.cn/docs/mcp/overview

Tool for retrieving a snapshot of A-share index prices. Corresponds to the REST API GET /api/a-share-index/prices/snapshot.

```json
{
  "mcpServers": {
    "fuyao-a-share-index-mcp": {
      "type": "http",
      "url": "/mcp/a-share-index",
      "tools": [
        {
          "name": "get_a_share_index_prices_snapshot",
          "description": "指数行情快照",
          "rest_api": "GET /api/a-share-index/prices/snapshot"
        }
      ]
    }
  }
}
```

--------------------------------

### Cash Flow Statement Data Example

Source: https://fuyao.aicubes.cn/docs/mcp/tools/get_a_share_financials_cash_flow_statements

This is an example of the JSON response structure for cash flow statement data. It includes financial metrics for a specific period.

```json
{
  "timestamp": 1735574400000,
  "item": [
    {
      "thscode": "600519.SH",
      "ticker": "600519",
      "period": "annual",
      "fiscal_year": 2024,
      "fiscal_period": "FY",
      "report_date_ms": 1735574400000,
      "period_end_ms": 1735574400000,
      "currency": "CNY",
      "act_cash_flow_net": 92000000000,
      "invest_cash_flow_net": -3000000000,
      "financing_cash_flow_net": -65000000000,
      "pay_fixed_assets_etc_cash": 3500000000,
      "pay_dividends_profits_interest_cash": 64000000000,
      "cash_equivalents_net_addition": 24000000000
    }
  ]
}
```

--------------------------------

### Get Meta Tickers List Tool Parameters

Source: https://fuyao.aicubes.cn/docs/mcp/tools/get_meta_tickers_list

Specifies the parameters for the `get_meta_tickers_list` tool, including asset type, limit, and offset for pagination.

```text
工具：get_meta_tickers_list参数：  - asset_type: "a-share"  - limit: 1000  - offset: 0
```

--------------------------------

### Cash Flow Statement Response Example

Source: https://fuyao.aicubes.cn/docs/api-reference/financials

This is an example of a successful response when requesting cash flow statement data. It includes financial metrics for a specific company and period.

```json
{
  "code": 0,
  "message": "success",
  "request_id": "g7h8i9j0",
  "data": {
    "timestamp": 1735574400000,
    "item": [
      {
        "thscode": "600519.SH",
        "ticker": "600519",
        "period": "annual",
        "fiscal_year": 2024,
        "fiscal_period": "FY",
        "report_date_ms": 1735574400000,
        "period_end_ms": 1735574400000,
        "currency": "CNY",
        "act_cash_flow_net": 92000000000,
        "invest_cash_flow_net": -3000000000,
        "financing_cash_flow_net": -65000000000,
        "pay_fixed_assets_etc_cash": 3500000000,
        "pay_dividends_profits_interest_cash": 64000000000,
        "cash_equivalents_net_addition": 24000000000
      }
    ]
  }
}
```

--------------------------------

### Get Limit Up Pool Data Parameters

Source: https://fuyao.aicubes.cn/docs/mcp/tools/get_a_share_special_data_limit_up_pool

Parameters for querying the limit up stock pool. Use 'sort_field' and 'sort_dir' to order results.

```text
- page: 1
- size: 50
- sort_field: "limit_up_time"
- sort_dir: "desc"
```

--------------------------------

### AI Agent Scenario 2: Get Historical Trend

Source: https://fuyao.aicubes.cn/docs/mcp/overview

Example scenario for retrieving historical K-line data for a stock. It involves ticker resolution, timestamp calculation, and then calling get_a_share_prices_historical.

```text
User: "茅台最近一年的日 K 线走势如何？"

1. `fuyao-meta-mcp` → `get_meta_tickers_search`, `q: "茅台"`, 获取 `thscode: 600519.SH`
2. 计算当前与一年前的毫秒时间戳
3. `fuyao-a-share-mcp` → `get_a_share_prices_historical`, `thscode/interval/start/end/adjust`
```

--------------------------------

### AI Agent Scenario 1: Query Stock Market

Source: https://fuyao.aicubes.cn/docs/mcp/overview

Example scenario for querying stock market data. It involves using get_meta_tickers_search to resolve the ticker and then get_a_share_prices_snapshot for real-time data.

```text
User: "查一下贵州茅台今天的行情"

1. `fuyao-meta-mcp` → `get_meta_tickers_search`, `q: "贵州茅台"`, 获取 `thscode: 600519.SH`
2. `fuyao-a-share-mcp` → `get_a_share_prices_snapshot`, `thscodes: "600519.SH"`, 获取实时行情
```

--------------------------------

### Get Historical Index Prices

Source: https://fuyao.aicubes.cn/docs/mcp/tools/get_a_share_index_prices_historical

Use this tool to retrieve historical daily price data for a specific A-share index. Requires the index's THS code, desired interval, and a start and end timestamp.

```json
工具：get_a_share_index_prices_historical参数：  - thscode: "000001.SH"  - interval: "1d"  - start: 1716105600000  - end: 1747641600000
```

--------------------------------

### MCP Tools Overview

Source: https://fuyao.aicubes.cn/llms.txt

Overview of MCP Tools, a REST adapter for LLM Agents, detailing their naming, boundaries, and operational methods.

```APIDOC
## MCP Tools

This section describes the MCP Tools, which act as REST adapters for LLM Agents.

### Tools:

- **A-share Trading Calendar**: A-share trading days for the past year (no input parameters).
- **Adjustment Factors Event Stream**: Adjustment factor event stream for a single A-share (dividends, bonus shares, etc.).
- **Balance Sheets**: Consolidated balance sheets for a single A-share over multiple periods.
- **Cash Flow Statements**: Consolidated cash flow statements for a single A-share over multiple periods.
- **Income Statements**: Consolidated income statements for a single A-share over multiple periods.
- **Financial Indicators**: A-share financial indicators MCP tool (Coming Soon).
- **Tonghuashun Index List**: List of Tonghuashun indices by tag.
- **Tonghuashun Index Constituents**: List of current constituents for a given index thscode.
- **Index Overview**: Index basic information, constituents, and weights MCP tool (Coming Soon).
- **Index Historical K-lines**: Historical K-line sequence for a single A-share index, Tonghuashun sector, or industry index.
- **Index Snapshot**: Latest market data for A-share indices, Tonghuashun sectors, or industry indices by thscodes.
- **Money Flow**: A-share money flow MCP tool (Coming Soon).
- **A-share Historical K-lines**: Historical K-line sequence for a single security.
- **A-share Snapshot**: Market snapshot for A-shares (batch by thscodes or paginated for the whole market).
- **A-share Limit-up Ladder**: Returns the consecutive limit-up matrix for the past 30 trading days.
- **A-share Limit-up Pool**: Returns the A-share stocks that hit the limit-up/consecutive limit-up for a given trading day.
- **Stock Basics**: A-share basic information query MCP tool (Coming Soon).
- **THS Index Membership**: Query which Tonghuashun industry/concept indices a stock belongs to MCP tool (Coming Soon).
- **Valuations**: A-share valuation data MCP tool (Coming Soon).
- **Ticker List**: Batch retrieval of ticker lists (filtered by exchange/asset class).
- **Ticker Search (Cross-market Disambiguation)**: Parse company name/ticker fragment into standard thscode.
```

--------------------------------

### Get Meta Tickers List Tool

Source: https://fuyao.aicubes.cn/docs/mcp/overview

Tool for retrieving a list of tickers. Corresponds to the REST API GET /api/meta/tickers/list.

```json
{
  "mcpServers": {
    "fuyao-meta-mcp": {
      "type": "http",
      "url": "/mcp/meta",
      "tools": [
        {
          "name": "get_meta_tickers_list",
          "description": "标的列表获取",
          "rest_api": "GET /api/meta/tickers/list"
        }
      ]
    }
  }
}
```

--------------------------------

### Combine with Price Tools

Source: https://fuyao.aicubes.cn/docs/mcp/tools/get_a_share_index_constituents_ths_stock_list

After retrieving constituent `thscode`s, concatenate them with commas (batching if necessary) to feed into `get_a_share_prices_snapshot` for real-time market data, completing the 'index -> constituents -> prices' data flow.

```text
成分股 `thscode` 取出后逗号拼接（必要时分批控制单次请求长度），即可喂给 [`get_a_share_prices_snapshot`](/docs/mcp/tools/get_a_share_prices_snapshot/) 拿到批量实时行情， 完成「指数 → 成分股 → 行情」完整链路。
```

--------------------------------

### Main execution function

Source: https://fuyao.aicubes.cn/docs/api-reference/market-dumps

The main function parses command-line arguments, resolves input paths, and calls functions to print manifest summaries, schema information, and inspect market data rows based on specified criteria.

```python
def main() -> None:
    args = parse_args()
    pq = import_pyarrow()
    resolved = resolve_input(args.path, args.prefer)
    tickers = set(args.ticker) if args.ticker else None
    from_ms = parse_day(args.from_date, end_of_day=False)
    to_ms = parse_day(args.to_date, end_of_day=True)

    print_manifest_summary(resolved, args.skip_sha256)
    print_schema(pq, resolved.parquet_path)
    inspect_rows(
        pq=pq,
        resolved=resolved,
        tickers=tickers,
        from_ms=from_ms,
        to_ms=to_ms,
        limit=args.limit,
        batch_size=args.batch_size,
        check_duplicates=args.check_duplicates,
        export_csv_path=args.export_csv,
        no_sample=args.no_sample,
    )

if __name__ == "__main__":
    main()
```

--------------------------------

### Fetch All Market Stock Price Snapshots (Paginated)

Source: https://fuyao.aicubes.cn/docs/api-reference/prices

Retrieve snapshot data for all stocks in the market using pagination. Specify the limit and offset for the desired page. Ensure your API key is included in the request headers.

```bash
curl 'https://fuyao.aicubes.cn/api/a-share/prices/snapshot?limit=100&offset=0' \
  -H 'X-api-key: <your-api-key>'
```

--------------------------------

### Get A Share Prices Historical Tool

Source: https://fuyao.aicubes.cn/docs/mcp/overview

Tool for retrieving historical A-share K-line data. Corresponds to the REST API GET /api/a-share/prices/historical.

```json
{
  "mcpServers": {
    "fuyao-a-share-mcp": {
      "type": "http",
      "url": "/mcp/a-share",
      "tools": [
        {
          "name": "get_a_share_prices_historical",
          "description": "A股历史K线",
          "rest_api": "GET /api/a-share/prices/historical"
        }
      ]
    }
  }
}
```

--------------------------------

### Download Daily K-line Data (Last 10 Trading Days)

Source: https://fuyao.aicubes.cn/docs/api-reference/market-dumps

Obtain a pre-signed URL to download the daily K-line data for all A-shares covering the last 10 trading days. This is suitable for high-frequency incremental synchronization.

```APIDOC
## GET /dump/market-dumps/daily-k-10d/download-url

### Description
Retrieves a pre-signed S3 URL for downloading daily K-line data for all A-shares covering the most recent 10 trading days. This endpoint is optimized for incremental updates and high-frequency synchronization.

### Method
GET

### Endpoint
/dump/market-dumps/daily-k-10d/download-url

### Parameters
#### Query Parameters
- **trading_days** (string) - Optional - Specifies the number of trading days, defaults to '10'.

### Response
#### Success Response (200)
- **download_url** (string) - A pre-signed URL for downloading the data.

### Response Example
{
  "download_url": "https://example.com/path/to/your/data-10d.parquet?AWSAccessKeyId=...
}
```

--------------------------------

### A股行情快照

Source: https://fuyao.aicubes.cn/docs/mcp/overview

Retrieves a snapshot of A-share market data.

```APIDOC
## GET /api/a-share/prices/snapshot

### Description
Fetches real-time market data for A-shares.

### Method
GET

### Endpoint
/api/a-share/prices/snapshot

### Parameters
#### Query Parameters
- **thscodes** (string) - Required - Comma-separated list of THS codes for the stocks.

### Response
#### Success Response (200)
- **data** (object) - Market data for the requested stocks.
```

--------------------------------

### Download All Adjustment Factors

Source: https://fuyao.aicubes.cn/docs/api-reference/market-dumps

Obtain a pre-signed URL to download all historical adjustment factor events (dividends, stock splits, etc.) for all A-shares.

```APIDOC
## GET /dump/market-dumps/adjustment-factors/download-url

### Description
Retrieves a pre-signed S3 URL for downloading a complete history of adjustment factor events for all A-shares. This includes information on dividends, stock splits, and other corporate actions.

### Method
GET

### Endpoint
/dump/market-dumps/adjustment-factors/download-url

### Parameters
#### Query Parameters
- **mode** (string) - Optional - Specifies the data scope, defaults to 'FULL' for all historical events.

### Response
#### Success Response (200)
- **download_url** (string) - A pre-signed URL for downloading the data.

### Response Example
{
  "download_url": "https://example.com/path/to/your/adjustment-factors.parquet?AWSAccessKeyId=...
}
```

--------------------------------

### Get A Share Calendar Trading Days Tool

Source: https://fuyao.aicubes.cn/docs/mcp/overview

Tool for retrieving A-share trading days calendar. Corresponds to the REST API GET /api/a-share/calendar/trading-days.

```json
{
  "mcpServers": {
    "fuyao-a-share-mcp": {
      "type": "http",
      "url": "/mcp/a-share",
      "tools": [
        {
          "name": "get_a_share_calendar_trading_days",
          "description": "A股交易日历",
          "rest_api": "GET /api/a-share/calendar/trading-days"
        }
      ]
    }
  }
}
```

--------------------------------

### Download Daily K-line Data (10 Years, Unadjusted)

Source: https://fuyao.aicubes.cn/docs/api-reference/market-dumps

Obtain a pre-signed URL to download approximately 10 years of daily K-line data for all A-shares. This data uses original, unadjusted prices.

```APIDOC
## GET /dump/market-dumps/daily-k/download-url

### Description
Retrieves a pre-signed S3 URL for downloading the full history (approximately 10 years) of daily K-line data for all A-shares. The data is provided with original, unadjusted prices.

### Method
GET

### Endpoint
/dump/market-dumps/daily-k/download-url

### Parameters
#### Query Parameters
- **years** (string) - Optional - Specifies the data window, defaults to '10' for 10 years.

### Response
#### Success Response (200)
- **download_url** (string) - A pre-signed URL for downloading the data.

### Response Example
{
  "download_url": "https://example.com/path/to/your/data.parquet?AWSAccessKeyId=...
}
```

--------------------------------

### 指数行情快照

Source: https://fuyao.aicubes.cn/docs/mcp/overview

Retrieves a snapshot of index market data.

```APIDOC
## GET /api/a-share-index/prices/snapshot

### Description
Fetches a snapshot of market data for A-share indices.

### Method
GET

### Endpoint
/api/a-share-index/prices/snapshot

### Parameters
#### Query Parameters
- **index_codes** (string) - Required - Comma-separated list of THS index codes.

### Response
#### Success Response (200)
- **data** (object) - Market data for the requested indices.
```

--------------------------------

### Get A Share Financials Balance Sheets Tool

Source: https://fuyao.aicubes.cn/docs/mcp/overview

Tool for retrieving A-share financial balance sheets. Corresponds to the REST API GET /api/a-share/financials/balance-sheets.

```json
{
  "mcpServers": {
    "fuyao-a-share-mcp": {
      "type": "http",
      "url": "/mcp/a-share",
      "tools": [
        {
          "name": "get_a_share_financials_balance_sheets",
          "description": "资产负债表",
          "rest_api": "GET /api/a-share/financials/balance-sheets"
        }
      ]
    }
  }
}
```

--------------------------------

### MCP工具环境变量设置示例

Source: https://fuyao.aicubes.cn/docs/quickstart

通过设置环境变量API_KEY来注入API Key，用于AI Agent工具链的鉴权。

```bash
export API_KEY="<your-api-key>"
```

--------------------------------

### Get A Share Financials Income Statements Tool

Source: https://fuyao.aicubes.cn/docs/mcp/overview

Tool for retrieving A-share financial income statements. Corresponds to the REST API GET /api/a-share/financials/income-statements.

```json
{
  "mcpServers": {
    "fuyao-a-share-mcp": {
      "type": "http",
      "url": "/mcp/a-share",
      "tools": [
        {
          "name": "get_a_share_financials_income_statements",
          "description": "利润表",
          "rest_api": "GET /api/a-share/financials/income-statements"
        }
      ]
    }
  }
}
```

--------------------------------

### get_a_share_prices_snapshot

Source: https://fuyao.aicubes.cn/docs/mcp/tools/get_a_share_prices_snapshot

获取A股行情快照。可以按指定的同花顺代码列表批量获取，或通过分页方式遍历A股代码表获取。

```APIDOC
## GET /api/a-share/prices/snapshot

### Description
获取A股行情快照。`thscodes` 显式给定时按入参顺序批量取数；省略时遍历完整A股代码表并按 `limit`/`offset` 分页。返回每只标的的最新价、涨跌额、涨跌幅、开盘 / 最高 / 最低 / 前收价、成交量、成交额。

### Method
GET

### Endpoint
/api/a-share/prices/snapshot

### Parameters
#### Query Parameters
- **thscodes** (string) - Optional - 逗号分隔的 thscode 列表，如 `600519.SH,000001.SZ`。给定时忽略 `limit` / `offset`。
- **limit** (integer) - Optional - 默认值: `100` - 分页大小，仅在 `thscodes` 省略时生效。
- **offset** (integer) - Optional - 默认值: `0` - 分页偏移，仅在 `thscodes` 省略时生效。

### Request Example
```json
{
  "thscodes": "600519.SH,000001.SZ"
}
```

### Response
#### Success Response (200)
- **code** (string) - 标的代码
- **name** (string) - 标的中文名
- **latest_price** (number) - 最新价
- **change** (number) - 涨跌额
- **change_percent** (number) - 涨跌幅
- **open** (number) - 开盘价
- **high** (number) - 最高价
- **low** (number) - 最低价
- **prev_close** (number) - 前收盘价
- **volume** (integer) - 成交量
- **amount** (number) - 成交额

#### Response Example
```json
{
  "code": "600519.SH",
  "name": "贵州茅台",
  "latest_price": 1700.00,
  "change": 10.00,
  "change_percent": 0.59,
  "open": 1690.00,
  "high": 1710.00,
  "low": 1685.00,
  "prev_close": 1690.00,
  "volume": 1000000,
  "amount": 1700000000.00
}
```
```

--------------------------------

### Get A Share Index Prices Historical Tool

Source: https://fuyao.aicubes.cn/docs/mcp/overview

Tool for retrieving historical A-share index K-line data. Corresponds to the REST API GET /api/a-share-index/prices/historical.

```json
{
  "mcpServers": {
    "fuyao-a-share-index-mcp": {
      "type": "http",
      "url": "/mcp/a-share-index",
      "tools": [
        {
          "name": "get_a_share_index_prices_historical",
          "description": "指数历史K线",
          "rest_api": "GET /api/a-share-index/prices/historical"
        }
      ]
    }
  }
}
```

--------------------------------

### Get A Share Special Data Limit Up Ladder Tool

Source: https://fuyao.aicubes.cn/docs/mcp/overview

Tool for retrieving the A-share limit-up ladder data. Corresponds to the REST API GET /api/a-share/special-data/limit-up-ladder.

```json
{
  "mcpServers": {
    "fuyao-a-share-mcp": {
      "type": "http",
      "url": "/mcp/a-share",
      "tools": [
        {
          "name": "get_a_share_special_data_limit_up_ladder",
          "description": "A股连板天梯",
          "rest_api": "GET /api/a-share/special-data/limit-up-ladder"
        }
      ]
    }
  }
}
```

--------------------------------

### Get A Share Special Data Limit Up Pool Tool

Source: https://fuyao.aicubes.cn/docs/mcp/overview

Tool for retrieving the A-share limit-up stock pool. Corresponds to the REST API GET /api/a-share/special-data/limit-up-pool.

```json
{
  "mcpServers": {
    "fuyao-a-share-mcp": {
      "type": "http",
      "url": "/mcp/a-share",
      "tools": [
        {
          "name": "get_a_share_special_data_limit_up_pool",
          "description": "A股涨停股票池",
          "rest_api": "GET /api/a-share/special-data/limit-up-pool"
        }
      ]
    }
  }
}
```

--------------------------------

### A-Share Price Snapshot Response Example

Source: https://fuyao.aicubes.cn/docs/mcp/tools/get_a_share_prices_snapshot

This JSON object represents the response structure for a stock price snapshot query. It includes a timestamp, the total number of items, and an array of price snapshot details for individual stocks.

```json
{
  "timestamp": null,
  "total": 2,
  "item": [
    {
      "thscode": "600519.SH",
      "ticker": "600519",
      "last_price": 1277.8,
      "price_change": 21.8,
      "price_change_ratio_pct": 1.735669,
      "open_price": 1252.08,
      "high_price": 1282,
      "low_price": 1250.21,
      "prev_price": 1256,
      "volume": 3098875,
      "turnover": 3937375200
    }
  ]
}
```