Stats Compass

[
  {
    "name": "ping",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Health check - verify server is running."
  },
  {
    "name": "session_info",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Get information about your current session.\n\nReturns:\n    Session info including created_at, dataframes, models and exports."
  },
  {
    "name": "list_dataframes",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "List all DataFrames in your session.\n\nReturns:\n    List of DataFrames with name, shape, columns, and active status."
  },
  {
    "name": "load_dataset",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Load a built-in sample dataset.\n\nAvailable datasets: TATASTEEL, Housing, Bukayo_Saka_7322\n\nArgs:\n    name: Dataset name\n    set_active: Whether to set as active DataFrame (default: True)\n\nReturns:\n    DataFrame info with name, shape, columns."
  },
  {
    "name": "load_csv",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Load a CSV file from a local path.\n\nIf you do not know the exact path, call list_files first\n(e.g. list_files(directory=\"~/Downloads\")) to find the file.\nDo NOT use bash or shell commands — they cannot access the user's machine.\n\nArgs:\n    path: Absolute path to the CSV file. Supports ~ expansion.\n    name: Name for the DataFrame (default: filename without extension)\n    delimiter: Field delimiter (default: comma)\n    encoding: File encoding (default: utf-8, retry with latin-1 on errors)\n    set"
  },
  {
    "name": "load_excel",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Load an Excel file from a local path.\n\nIf you do not know the exact path, call list_files first\n(e.g. list_files(directory=\"~/Downloads\")) to find the file.\nDo NOT use bash or shell commands — they cannot access the user's machine.\n\nArgs:\n    path: Absolute path to the Excel file. Supports ~ expansion.\n    name: Name for the DataFrame (default: filename without extension)\n    sheet_name: Sheet to load (default: first sheet)\n    set_active: Whether to set as active DataFrame (default: True)\n\nRetu"
  },
  {
    "name": "list_files",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "List files in a directory. Useful for finding data files.\n\nArgs:\n    directory: Directory path. Supports ~ expansion (e.g., ~/Downloads).\n\nReturns:\n    List of files in the directory."
  },
  {
    "name": "get_sample",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Get sample rows from a DataFrame.\n\nArgs:\n    dataframe_name: Name of DataFrame (default: active)\n    n: Number of rows (default: 10)\n    method: 'head', 'tail', or 'random'\n\nReturns:\n    Sample rows as records."
  },
  {
    "name": "get_schema",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Get the schema and metadata of a DataFrame.\n\nArgs:\n    dataframe_name: Name of DataFrame (default: active)\n    sample_values: Number of sample values per column\n\nReturns:\n    Schema with columns, dtypes, nulls, and sample values."
  },
  {
    "name": "save_csv",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Save a DataFrame to a CSV file.\n\nArgs:\n    dataframe_name: Name of the DataFrame to save\n    filepath: Path where the CSV file will be saved. \n              For local mode: can be absolute path (e.g., ~/Downloads/data.csv)\n              For remote mode: filename only, saved to session exports\n    index: Whether to write row index (default: False)\n\nReturns:\n    Save result with filepath and download_url (if remote)."
  },
  {
    "name": "save_model",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Save a trained model to a file.\n\nArgs:\n    model_id: ID of the model to save\n    filepath: Path where the model will be saved.\n              For local mode: can be absolute path (e.g., ~/Downloads/model.joblib)\n              For remote mode: filename only, saved to session exports\n\nReturns:\n    Save result with filepath and download_url (if remote)."
  },
  {
    "name": "delete_session",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Delete your current session and all its data.\n\nReturns:\n    Deletion result."
  },
  {
    "name": "server_stats",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Get server statistics (admin tool).\n\nReturns:\n    Active sessions count, configuration, and session details."
  },
  {
    "name": "get_upload_url",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Get a URL for the user to upload a CSV or Excel file in their browser.\n\nWhen sharing the upload_url with the user, always include the raw URL as\nplain text (not as a markdown hyperlink) so the user can see and copy it\ndirectly. You may add brief instructions around it. After they confirm\nthe upload is done, call register_uploaded_file() with no arguments.\n\nArgs:\n    filename: Optional suggested filename — leave blank, the user picks the file\n    content_type: MIME type (default: text/csv)\n\nRetur"
  },
  {
    "name": "register_uploaded_file",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Load an uploaded file as a DataFrame.\n\nCall this after the user confirms they have uploaded their file.\nIf file_key is omitted, automatically loads the most recently uploaded file.\nFile type is auto-detected from the file extension (csv, xlsx, xls).\n\nArgs:\n    file_key: Filename to load (optional — omit to auto-load the latest upload)\n    dataframe_name: Name for the DataFrame (default: filename without extension)\n    file_type: File type override - \"csv\" or \"excel\" (auto-detected from extension"
  },
  {
    "name": "describe_eda_tools",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Get schemas for all EDA sub-tools.\n\nReturns available tools: describe, correlations, hypothesis_test,\ndata_quality, missing_data_analysis, etc."
  },
  {
    "name": "execute_eda_tool",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Execute an EDA sub-tool.\n\nArgs:\n    tool_name: Name of sub-tool (e.g., \"describe\", \"correlations\")\n    params: Parameters for the sub-tool\n    dataframe_name: Override active DataFrame\n\nWARNING — t_test and z_test:\n    These require samples in separate columns (column_a, column_b).\n    They do NOT accept group_column. If your data is grouped (one value\n    column + one group column), first call execute_transform_tool with\n    tool_name=\"split_column_by_group\" to reshape it, then run the test."
  },
  {
    "name": "describe_cleaning_tools",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Get schemas for all cleaning sub-tools.\n\nReturns available tools: drop_na, impute, dedupe, handle_outliers, etc."
  },
  {
    "name": "execute_cleaning_tool",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Execute a cleaning sub-tool.\n\nArgs:\n    tool_name: Name of sub-tool (e.g., \"drop_na\", \"impute\")\n    params: Parameters for the sub-tool\n    dataframe_name: Override active DataFrame"
  },
  {
    "name": "describe_transform_tools",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Get schemas for all transform sub-tools.\n\nReturns available tools: filter, groupby, pivot, encode, scale, etc."
  },
  {
    "name": "execute_transform_tool",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Execute a transform sub-tool.\n\nArgs:\n    tool_name: Name of sub-tool (e.g., \"filter\", \"groupby\")\n    params: Parameters for the sub-tool\n    dataframe_name: Override active DataFrame"
  },
  {
    "name": "describe_data_tools",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Get schemas for all data manipulation sub-tools.\n\nReturns available tools: list_files, get_sample, get_schema, add_column,\ndrop_columns, rename_columns, merge, concat, etc.\n\nNOTE — local file discovery:\n    Use the list_files top-level tool to browse the user's local filesystem.\n    Call it directly — NOT via execute_data_tool.\n    Example: list_files(directory=\"~/Downloads\")"
  },
  {
    "name": "execute_data_tool",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Execute a data manipulation sub-tool.\n\nArgs:\n    tool_name: Name of sub-tool (e.g., \"get_sample\", \"add_column\")\n    params: Parameters for the sub-tool\n    dataframe_name: Override active DataFrame\n\nWARNING — inspect_data:\n    Accepts scalar expressions only. Expressions that return a Series or\n    DataFrame (e.g. value_counts(), groupby(), df[\"col\"]) will fail.\n    Quote characters inside expressions also cause parse errors.\n    Use bar_chart or describe(include=\"all\") for distributions,\n    gr"
  },
  {
    "name": "describe_ml_tools",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Get schemas for all ML sub-tools.\n\nReturns available tools: train_model, evaluate, predict, \ncross_validate, save_model, etc."
  },
  {
    "name": "execute_ml_tool",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Execute an ML sub-tool.\n\nArgs:\n    tool_name: Name of sub-tool (e.g., \"train_model\", \"predict\")\n    params: Parameters for the sub-tool\n    dataframe_name: Override active DataFrame"
  }
]