VNStock MCP Server

Instructions

Get exchange rate of all currency pairs from stock market
Args:
    date: str = None (if None, return today's price. Format: YYYY-MM-DD)
    output_format: Literal['json', 'dataframe'] = 'json'
Returns:
    pd.DataFrame

Implementation Reference

• src/vnstock_mcp/server.py:650-669 (handler)

  The handler function for the 'get_exchange_rate' MCP tool. Decorated with @server.tool() for automatic registration and schema inference from type hints and docstring. Fetches exchange rates using the vnstock library's vcb_exchange_rate function.

  @server.tool()
  def get_exchange_rate(
      date: str = None, output_format: Literal["json", "dataframe"] = "json"
  ):
      """
      Get exchange rate of all currency pairs from stock market
      Args:
          date: str = None (if None, return today's price. Format: YYYY-MM-DD)
          output_format: Literal['json', 'dataframe'] = 'json'
      Returns:
          pd.DataFrame
      """
      if not date:
          date = datetime.now().strftime("%Y-%m-%d")
      price = vcb_exchange_rate(date=date)
      if output_format == "json":
          return price.to_json(orient="records", force_ascii=False)
      else:
          return price