VNStock MCP Server

Instructions

Get quote intraday price from stock market
Args:
    symbol: str (symbol to get intraday price)
    page_size: int = 500 (max: 100000) (number of rows to return)
    last_time: str = None (last time to get intraday price from)
    output_format: Literal['json', 'dataframe'] = 'json'
Returns:
    pd.DataFrame

Implementation Reference

• src/vnstock_mcp/server.py:705-727 (handler)

  The handler function for the 'get_quote_intraday_price' tool. It uses vnstock.Quote to fetch intraday price data with pagination and optional last_time filter, returning the result as JSON or pandas DataFrame.

  @server.tool()
  def get_quote_intraday_price(
      symbol: str,
      page_size: int = 100,
      last_time: str = None,
      output_format: Literal["json", "dataframe"] = "json",
  ):
      """
      Get quote intraday price from stock market
      Args:
          symbol: str (symbol to get intraday price)
          page_size: int = 500 (max: 100000) (number of rows to return)
          last_time: str = None (last time to get intraday price from)
          output_format: Literal['json', 'dataframe'] = 'json'
      Returns:
          pd.DataFrame
      """
      quote = Quote(symbol=symbol, source="VCI")
      df = quote.intraday(page_size=page_size, last_time=last_time)
      if output_format == "json":
          return df.to_json(orient="records", force_ascii=False)
      else:
          return df

• src/vnstock_mcp/server.py:705-705 (registration)

  The @server.tool() decorator registers the get_quote_intraday_price function as an MCP tool.

  @server.tool()

• src/vnstock_mcp/server.py:707-711 (schema)

  Input schema defined by the function parameters with type hints and defaults.

      symbol: str,
      page_size: int = 100,
      last_time: str = None,
      output_format: Literal["json", "dataframe"] = "json",
  ):