VNStock MCP Server

Instructions

Get finance ratios of a company from stock market
Args:
    symbol: str (symbol of the company to get finance ratios)
    period: Literal['quarter', 'year'] = 'year' (period to get finance ratios)
    output_format: Literal['json', 'dataframe'] = 'json'
Returns:
    pd.DataFrame

Implementation Reference

• src/vnstock_mcp/server.py:450-471 (handler)

  Full implementation of the get_finance_ratios tool, including registration decorator (@server.tool()), type-annotated schema (parameters), and execution logic using VCIFinance.ratio() to fetch financial ratios and return as JSON or DataFrame.

  @server.tool()
  def get_finance_ratios(
      symbol: str,
      period: Literal["quarter", "year"] = "year",
      output_format: Literal["json", "dataframe"] = "json",
  ):  # pyright: ignore[reportUndefinedVariable]
      """
      Get finance ratios of a company from stock market
      Args:
          symbol: str (symbol of the company to get finance ratios)
          period: Literal['quarter', 'year'] = 'year' (period to get finance ratios)
          output_format: Literal['json', 'dataframe'] = 'json'
      Returns:
          pd.DataFrame
      """
      finance = VCIFinance(symbol=symbol, period=period)
      df = finance.ratio()
      if output_format == "json":
          return df.to_json(orient="records", force_ascii=False)
      else:
          return df