get_company_subsidiaries
Retrieve subsidiary information for Vietnamese companies listed on the stock market. Use this tool to identify corporate relationships and ownership structures by providing a stock symbol.
Instructions
Get company subsidiaries from stock market
Args:
symbol: str
filter_by: Literal["all", "subsidiary"] = "all"
output_format: Literal['json', 'dataframe'] = 'json'
Returns:
pd.DataFrameInput Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| symbol | Yes | ||
| filter_by | No | all | |
| output_format | No | json |
Implementation Reference
- src/vnstock_mcp/server.py:136-157 (handler)The handler function for the 'get_company_subsidiaries' tool. It uses TCBSCompany to fetch subsidiaries data based on symbol and filter, returning it as JSON or DataFrame. The @server.tool() decorator registers it as an MCP tool.
@server.tool() def get_company_subsidiaries( symbol: str, filter_by: Literal["all", "subsidiary"] = "all", output_format: Literal["json", "dataframe"] = "json", ): # pyright: ignore[reportUndefinedVariable] """ Get company subsidiaries from stock market Args: symbol: str filter_by: Literal["all", "subsidiary"] = "all" output_format: Literal['json', 'dataframe'] = 'json' Returns: pd.DataFrame """ equity = TCBSCompany(symbol=symbol) df = equity.subsidiaries(filter_by=filter_by) if output_format == "json": return df.to_json(orient="records", force_ascii=False) else: return df