# Kaggle

Kaggle is a platform for data science and machine learning competitions, offering datasets, notebooks, and a collaborative community.

- **Category:** artificial intelligence
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 35
- **Triggers:** 0
- **Slug:** `KAGGLE`
- **Version:** 20260316_00

## Tools

### Download competition data files

**Slug:** `KAGGLE_COMPETITION_DOWNLOAD_FILES`

Downloads all data files for a Kaggle competition as a single zip archive. Returns the local file path where the zip was saved. Note: You must have accepted the competition's rules on Kaggle's website before downloading (403 error if not accepted).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Competition URL slug (identifier). Find this in the competition's URL: kaggle.com/competitions/{slug} |
| `path` | string | No | Destination folder path where the zip file will be saved. If not specified, saves to current working directory. |
| `force` | boolean | No | If true, re-download even if file already exists locally. If false, skip download if file exists. |
| `quiet` | boolean | No | Reserved for future use. Currently has no effect on download behavior. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Submit Competition Entry

**Slug:** `KAGGLE_COMPETITION_SUBMIT`

Submit an entry to a Kaggle competition using a previously uploaded file. Prerequisites: 1. You must have accepted the competition rules on Kaggle's website 2. You must have uploaded your submission file and obtained a blob_file_tokens (use Kaggle's file upload API endpoint first) This action performs the final submission step after file upload. The blob token identifies your uploaded file and associates it with your competition submission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `competition` | string | Yes | Competition slug (URL name) from the competition URL. For example, use 'titanic' for kaggle.com/c/titanic. You must have accepted the competition rules before submitting. |
| `blob_file_tokens` | string | Yes | File upload token obtained from Kaggle's blob upload API. This token is returned when you upload your submission file using the Kaggle API's upload endpoint (typically /competitions/submissions/upload). The token identifies the location of your uploaded submission file on Kaggle's servers. |
| `submission_description` | string | Yes | Brief description or message for this submission (e.g., what changes you made, model version, etc.). This helps you track different submissions. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Kaggle Config Directory

**Slug:** `KAGGLE_CONFIG_DIR`

Tool to retrieve the directory of the Kaggle API configuration file. Use when you need to locate the directory containing your kaggle.json credentials.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `prefer_xdg` | boolean | No | Prefer XDG config home path on POSIX |
| `platform_hint` | string | No | Force platform branch: 'windows' or 'posix'. If not set, auto-detect. |
| `use_fallback_only` | boolean | No | Skip CLI, compute directory using environment/platform defaults. |
| `xdg_config_home_override` | string | No | Override XDG_CONFIG_HOME base directory for fallback computation. |
| `override_kaggle_config_dir` | string | No | Override directory to use as Kaggle config directory |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Initialize Kaggle Configuration

**Slug:** `KAGGLE_CONFIG_INIT`

Initialize Kaggle API client configuration. This action sets up the necessary configuration file for Kaggle API access by first attempting to use the Kaggle CLI's 'kaggle config init' command. If the CLI is unavailable, it falls back to creating a kaggle.json file at ~/.kaggle/kaggle.json (or $KAGGLE_CONFIG_DIR/kaggle.json if that environment variable is set). The action is idempotent - if configuration already exists, it will not overwrite it. No parameters are required; the action uses environment variables and metadata when available. Run this before other Kaggle actions when credentials are missing or when KAGGLE_CONFIG_VIEW returns empty/error output.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kaggle Configuration Keys

**Slug:** `KAGGLE_CONFIG_KEYS`

Tool to list local Kaggle API configuration keys. Use when you need to see which configuration options are set without revealing values.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Kaggle Config Path

**Slug:** `KAGGLE_CONFIG_PATH`

Tool to retrieve local Kaggle API configuration file path. Use when you need to know the location of the Kaggle config before operations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `prefer_xdg` | boolean | No | Prefer XDG config home path on POSIX |
| `platform_hint` | string | No | Force platform branch: 'windows' or 'posix'. If not set, auto-detect. |
| `use_fallback_only` | boolean | No | Skip CLI, compute path using environment/platform defaults. |
| `xdg_config_home_override` | string | No | Override XDG_CONFIG_HOME base directory for fallback computation. |
| `override_kaggle_config_dir` | string | No | Override directory to use for kaggle.json |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Reset Kaggle Configuration

**Slug:** `KAGGLE_CONFIG_RESET`

Tool to reset local Kaggle CLI configuration to defaults. Clears CLI-managed keys ('competition', 'path', 'proxy').

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Set Kaggle Configuration

**Slug:** `KAGGLE_CONFIG_SET`

Tool to set a Kaggle CLI configuration parameter. Use when updating local CLI settings such as default download path or proxy. Ensure Kaggle CLI is installed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string ("competition" | "path" | "proxy") | Yes | Configuration parameter to set. Must be one of 'competition', 'path', or 'proxy'. |
| `value` | string | Yes | Value to assign to the configuration parameter. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Unset Kaggle Configuration

**Slug:** `KAGGLE_CONFIG_UNSET`

Tool to unset a Kaggle CLI configuration parameter. Use when removing local CLI settings such as default download path or proxy. Ensure Kaggle CLI is installed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string ("competition" | "path" | "proxy") | Yes | Configuration parameter to unset. Must be one of 'competition', 'path', or 'proxy'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### View Kaggle Configuration

**Slug:** `KAGGLE_CONFIG_VIEW`

View local Kaggle API credentials and configuration settings. This action reads Kaggle configuration from local sources (does NOT make API calls to Kaggle). Configuration is retrieved in the following precedence order: 1. kaggle.json file (from KAGGLE_CONFIG_DIR env var, ~/.config/kaggle/, or ~/.kaggle/) 2. 'kaggle config view' CLI output (for proxy/path settings) 3. Environment variables (KAGGLE_USERNAME, KAGGLE_KEY) 4. Authorization header from metadata Use this action to: - Verify Kaggle credentials are configured before making API calls - Check current proxy settings - Debug authentication issues Returns empty strings for username/key if no credentials are found; use KAGGLE_CONFIG_INIT to set up credentials first. Note: username and key are independent — an empty username field does not indicate missing or invalid credentials. WARNING: This action returns sensitive API key data in plain text.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Dataset Create

**Slug:** `KAGGLE_DATASET_CREATE`

Create a new Kaggle dataset with metadata. IMPORTANT: Dataset creation requires at least one data file. Ensure files are uploaded before calling this action. The 'id' field must use your authenticated Kaggle username as the owner. Returns the creation status and any message from the Kaggle API.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Dataset identifier in the form '<owner>/<dataset-slug>'. The owner must be your authenticated Kaggle username (or an organization you belong to). The dataset-slug must be lowercase, 3-50 characters, using only letters, numbers, and hyphens. |
| `files` | array | No | List of files already uploaded via a separate Kaggle file upload API call. Each entry references a previously uploaded file by name. NOTE: At least one file (via 'files' or physical upload) is typically required for successful dataset creation. |
| `title` | string | Yes | Dataset title shown on Kaggle. |
| `keywords` | array | No | Tags to improve discovery. |
| `licenses` | array | Yes | Provide exactly one license entry. |
| `subtitle` | string | No | Brief subtitle for the dataset card. |
| `resources` | array | No | List of resource entries describing the dataset files and their metadata. Not required, but useful for providing file descriptions and schemas. |
| `description` | string | No | Full Markdown-formatted description. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Kaggle Dataset Init

**Slug:** `KAGGLE_DATASET_INIT`

Tool to initialize a dataset-metadata.json file in a local folder. Use when preparing a dataset folder before uploading to Kaggle.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `path` | string | No | Folder path to initialize dataset-metadata.json; defaults to current working directory. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kaggle Dataset Files

**Slug:** `KAGGLE_DATASET_LIST_FILES`

Tool to list files in a Kaggle dataset. Use when you need to retrieve paginated file listings by owner and dataset slugs, with optional version and paging controls.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_size` | integer | No | Number of items per page (default 20). |
| `owner_slug` | string | Yes | Owner of the dataset (username or organization). |
| `page_token` | string | No | Token for pagination of results. |
| `dataset_slug` | string | Yes | Slug (name) of the dataset. |
| `dataset_version_number` | string | No | Specific dataset version number, e.g., '1'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Dataset Status

**Slug:** `KAGGLE_DATASET_STATUS`

Check the processing status of a Kaggle dataset after creation or version update. This endpoint is used to monitor datasets that are currently being processed by Kaggle's servers. It returns status information for datasets that are actively uploading, processing, or experiencing errors. For already-published datasets, this endpoint typically returns 404 (Not Found), which is expected behavior. Use this tool immediately after creating a new dataset (KAGGLE_DATASET_CREATE) or updating an existing dataset version (KAGGLE_DATASET_VERSION) to check when the dataset becomes ready. Poll this endpoint periodically until the status indicates completion or error.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `owner_slug` | string | Yes | Owner username or organization name of the dataset. This is the first part of the dataset identifier (e.g., 'username' in 'username/dataset-name'). |
| `dataset_slug` | string | Yes | URL-friendly slug (identifier) of the dataset. This is the second part of the dataset identifier (e.g., 'dataset-name' in 'username/dataset-name'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Dataset Version

**Slug:** `KAGGLE_DATASET_VERSION`

Create a new version of an existing Kaggle dataset. Prerequisites: - You must own the dataset or have edit permissions - Files must be uploaded first to obtain upload tokens (required for the 'files' parameter) Use this when you have updated files or metadata and need to publish a new version of an existing dataset.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `files` | array | Yes | List of files to include in this version. Each file must reference an upload token obtained from a prior file upload to Kaggle's storage. At least one file is required. |
| `subtitle` | string | No | Optional new subtitle for the dataset |
| `owner_slug` | string | Yes | Username or organization slug that owns the dataset. You must have edit permissions for this dataset. |
| `description` | string | No | Optional new description for the dataset |
| `category_ids` | array | No | Optional list of category IDs to tag the dataset with |
| `dataset_slug` | string | Yes | URL-friendly slug identifier of the dataset to create a new version for |
| `version_notes` | string | Yes | Notes describing changes in the new dataset version |
| `convert_to_csv` | boolean | No | Whether to convert tabular data to CSV |
| `delete_old_versions` | boolean | No | Whether to delete all previous versions when creating this new one |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Download competition file

**Slug:** `KAGGLE_DOWNLOAD_COMPETITION_FILE`

Tool to download a specific data file from a Kaggle competition. Use when you need to retrieve a single file from a competition by specifying the competition slug and filename. Note: You must have accepted the competition's rules on Kaggle's website before downloading.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Competition URL slug (identifier). Find this in the competition's URL: kaggle.com/competitions/{slug} |
| `fileName` | string | Yes | Name of the specific competition data file to download (e.g., 'train.csv', 'test.csv'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Download competition leaderboard

**Slug:** `KAGGLE_DOWNLOAD_COMPETITION_LEADERBOARD`

Tool to download the entire competition leaderboard as a CSV file packaged in a ZIP archive. Use when you need to analyze or review competition standings and scores.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Competition name or URL slug (identifier). Find this in the competition's URL: kaggle.com/competitions/{slug} |
| `path` | string | No | Destination folder path where the leaderboard zip file will be saved. If not specified, saves to current working directory. |
| `force` | boolean | No | If true, re-download even if file already exists locally. If false, skip download if file exists. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Download Kaggle Dataset

**Slug:** `KAGGLE_DOWNLOAD_DATASET`

Tool to download all files from a Kaggle dataset as a zip archive. Supports downloading specific versions by providing the dataset_version_number parameter.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `owner_slug` | string | Yes | Owner of the dataset (username or organization). |
| `dataset_slug` | string | Yes | Slug (name) of the dataset. |
| `dataset_version_number` | string | No | Specific dataset version number to download. If not specified, downloads the latest version. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Download Kaggle Dataset File

**Slug:** `KAGGLE_DOWNLOAD_DATASET_FILE`

Tool to download a specific file from a Kaggle dataset. Use when you need to retrieve a single file from a dataset by specifying the owner, dataset, and filename.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file_name` | string | Yes | Name of the file to download from the dataset. |
| `owner_slug` | string | Yes | Dataset owner username or organization name. |
| `dataset_slug` | string | Yes | Dataset slug (name identifier). |
| `dataset_version_number` | string | No | Specific dataset version number to download. If not specified, downloads from the latest version. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Generate Competition Submission URL

**Slug:** `KAGGLE_GENERATE_COMPETITION_SUBMISSION_URL`

Tool to generate a pre-signed URL for uploading competition submission files. Use this before uploading your submission file to Kaggle. This action generates a temporary upload URL and token for submitting to a competition. You must provide the competition ID, file size, and last modified timestamp. After obtaining the URL, upload your submission file to the createUrl, then use the token to finalize the submission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Competition name, as it appears in the competition's URL. For example, use 'titanic' for kaggle.com/c/titanic. You must have accepted the competition rules before generating submission URLs. |
| `fileName` | string | No | Competition submission file name. Typically a CSV file containing your predictions. If not provided, a default name may be assigned. |
| `contentLength` | integer | Yes | Content length of the submission file in bytes. This is the size of the file you plan to upload. |
| `lastModifiedDateUtc` | integer | Yes | Last modified date of the submission file in seconds since epoch (Unix timestamp) in UTC. Use the file's last modified timestamp. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Dataset Metadata

**Slug:** `KAGGLE_GET_DATASET_METADATA`

Tool to get comprehensive metadata for a Kaggle dataset including title, description, licenses, and tags. Use when you need detailed information about a dataset's structure, schema, or properties.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `owner_slug` | string | Yes | Owner username or organization name of the dataset. This is the first part of the dataset identifier (e.g., 'uciml' in 'uciml/iris'). |
| `dataset_slug` | string | Yes | URL-friendly slug (identifier) of the dataset. This is the second part of the dataset identifier (e.g., 'iris' in 'uciml/iris'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Model Details

**Slug:** `KAGGLE_GET_MODEL`

Tool to get a Kaggle model's details including metadata and description. Use when you need information about a specific model on Kaggle.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `model_slug` | string | Yes | Model name/slug. This is the second part of the model identifier (e.g., 'bert' in 'google/bert'). |
| `owner_slug` | string | Yes | Model owner username or organization name. This is the first part of the model identifier (e.g., 'google' in 'google/bert'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Model Instance Details

**Slug:** `KAGGLE_GET_MODEL_INSTANCE`

Tool to get details for a specific Kaggle model instance (variation). Returns metadata including overview, usage instructions, download URL, version information, and license details. Use when you need to inspect or retrieve information about a specific model variation before downloading or using it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `framework` | string | Yes | Framework name for this model variation (e.g., TensorFlow2, PyTorch, Jax, TfLite, TfJs, Coral). |
| `model_slug` | string | Yes | Model name/slug. This is the second part of the model identifier (e.g., 'bert' in 'tensorflow/bert'). |
| `owner_slug` | string | Yes | Model owner username or organization name. This is the first part of the model identifier (e.g., 'tensorflow' in 'tensorflow/bert'). |
| `variation_slug` | string | Yes | Variation name/slug. This identifies the specific model instance or version (e.g., 'bert-en-uncased-l-12-h-768-a-12'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Kaggle Kernel Init

**Slug:** `KAGGLE_KERNEL_INIT`

Initialize a kernel-metadata.json template file in a specified folder. This file is required before pushing/uploading a kernel to Kaggle. The template includes default values for kernel configuration (language, kernel_type, GPU settings, etc.) that can be customized before pushing. Use this when setting up a new Kaggle kernel locally.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `path` | string | No | Folder path where kernel-metadata.json will be created. Use '.' for current directory or provide an absolute/relative path. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Download kernel output

**Slug:** `KAGGLE_KERNEL_OUTPUT`

Tool to download the output of a Kaggle kernel. Use when needing the latest kernel results locally.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `path` | string | No | Directory to download output to; defaults to current working directory. |
| `force` | boolean | No | If true, force re-download even if file exists. |
| `user_name` | string | Yes | Owner of the kernel. |
| `kernel_slug` | string | Yes | Slug name of the kernel. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Kernel Status

**Slug:** `KAGGLE_KERNELS_STATUS`

Get the execution status of a Kaggle kernel (notebook). Returns current status (running, complete, error), timestamps, and output URL. Use this to monitor kernel execution after pushing/submitting a kernel. Note: You need permission to access the kernel - typically only your own kernels or public kernels you have access to.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `userName` | string | Yes | Username of the kernel owner (typically your Kaggle username for your own kernels) |
| `kernelSlug` | string | Yes | URL-friendly identifier (slug) of the kernel, typically lowercase with hyphens (e.g., 'my-analysis-notebook') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List competition data files

**Slug:** `KAGGLE_LIST_COMPETITION_FILES`

Tool to list all data files available for a Kaggle competition. Use when you need to retrieve file names, sizes, and metadata for competition datasets before downloading.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Competition name or URL slug (identifier). Find this in the competition's URL: kaggle.com/competitions/{slug} |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kaggle Competitions

**Slug:** `KAGGLE_LIST_COMPETITIONS`

Tool to list available Kaggle competitions with filters and pagination. Use when you need to discover competitions, search by keywords, or filter by category, group, and sorting options.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for paginated results. Each page typically returns 20 competitions. Default: 1. |
| `group` | string ("general" | "entered" | "inClass") | No | Competition group filter options. |
| `search` | string | No | Search terms to filter competitions by keywords in title or description. Default: empty (no search filter). |
| `sortBy` | string ("grouped" | "prize" | "earliestDeadline" | "latestDeadline" | "numberOfTeams" | "recentlyCreated") | No | Competition sorting options. |
| `category` | string ("all" | "featured" | "research" | "recruitment" | "gettingStarted" | "masters" | "playground") | No | Competition category filter options. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kaggle Datasets

**Slug:** `KAGGLE_LIST_DATASETS`

Tool to list Kaggle datasets with filters and pagination. Use after authenticating with Kaggle API key.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for paginated results. Default: 1. Increment by 1 on each subsequent call to paginate; stop when a call returns no data. |
| `size` | string | No | DEPRECATED: use max_size and min_size instead. Legacy size filter. Default behavior: all. |
| `user` | string | No | Filter datasets by a specific user or organization. |
| `group` | string | No | Display datasets by a particular group. Valid values: 'public' (all public datasets), 'mine' (user's own datasets), 'user' (datasets by specific user when combined with 'user' parameter). Default: public. |
| `search` | string | No | Search terms to filter datasets. Default: empty. |
| `tagids` | string | No | Comma-separated list of tag IDs to filter by. |
| `license` | string | No | Filter datasets by license group. Valid values: 'all', 'cc', 'gpl', 'odb', 'other'. Default: all. |
| `sort_by` | string | No | Sort the results. Valid values: 'hottest', 'votes', 'updated', 'active'. Default: hottest. |
| `filetype` | string | No | Filter datasets by file type. Valid values: 'all', 'csv', 'sqlite', 'json', 'bigQuery'. Default: all. |
| `max_size` | integer | No | Maximum dataset size in bytes. |
| `min_size` | integer | No | Minimum dataset size in bytes. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kernel Output Files

**Slug:** `KAGGLE_LIST_KERNEL_OUTPUT_FILES`

Tool to list output files for a specific kernel run. Use when you need to retrieve paginated file listings by kernel owner and slug.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_size` | integer | No | Number of items per page (default: 20, max: 200). |
| `user_name` | string | Yes | Kernel owner username. |
| `page_token` | string | No | Page token for results paging. |
| `kernel_slug` | string | Yes | Kernel slug/name. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kaggle Kernels

**Slug:** `KAGGLE_LIST_KERNELS`

Tool to list Kaggle kernels (notebooks and scripts) with filters and pagination. Use to discover kernels by search terms, user, language, type, competition, or dataset.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for paginated results. Default: 1. |
| `user` | string | No | Filter kernels by a specific user or organization username. |
| `group` | string ("everyone" | "profile" | "upvoted") | No | Groups for filtering kernels. |
| `search` | string | No | Search terms to filter kernels by title, code, or author. |
| `sortBy` | string ("hotness" | "commentCount" | "dateCreated" | "dateRun" | "scoreAscending" | "scoreDescending" | "viewCount" | "voteCount" | "relevance") | No | Sort options for kernel listings. |
| `dataset` | string | No | Filter kernels that use a specific dataset (format: owner/dataset-name). |
| `language` | string ("all" | "python" | "r" | "sqlite" | "julia") | No | Programming languages supported by Kaggle kernels. |
| `pageSize` | integer | No | Number of kernels per page. Default: 20. |
| `kernelType` | string ("all" | "script" | "notebook") | No | Types of Kaggle kernels. |
| `outputType` | string ("all" | "visualization" | "data") | No | Output types for Kaggle kernels. |
| `competition` | string | No | Filter kernels associated with a specific competition (format: competition-slug). |
| `parentKernel` | string | No | Filter kernels that have forked the specified kernel (format: owner/kernel-name). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Model Instance Version Files

**Slug:** `KAGGLE_LIST_MODEL_INSTANCE_VERSION_FILES`

Tool to list files for a specific version of a model variation. Use when you need to retrieve files for a particular model framework instance version by owner, model, framework, variation, and version.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `framework` | string | Yes | Framework name (e.g., pyTorch, tensorFlow). |
| `page_size` | integer | No | Number of items per page (default: 20). |
| `model_slug` | string | Yes | Model name/slug. |
| `owner_slug` | string | Yes | Model owner username. |
| `page_token` | string | No | Page token for results paging. |
| `variation_slug` | string | Yes | Variation name/slug (instance slug). |
| `version_number` | integer | Yes | Version number of the model variation. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kaggle Models

**Slug:** `KAGGLE_LIST_MODELS`

Tool to list Kaggle models with optional filters for owner, sorting, search, and pagination. Use to discover available models on Kaggle's platform.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `owner` | string | No | Filter to display models by a specific user or organization. Use the owner's username or organization slug. |
| `search` | string | No | Search terms to filter models by title, owner, or other text fields. Leave empty to return all models. |
| `sortBy` | string ("hotness" | "downloadCount" | "voteCount" | "notebookCount" | "publishTime" | "createTime" | "updateTime") | No | Enum for valid model list sort options. |
| `pageSize` | integer | No | Number of models to return per page. Default: 20. Maximum: 100. |
| `pageToken` | string | No | Page token for pagination. Use the 'nextPageToken' from a previous response to fetch the next page of results. Omit for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Pull Kernel Code

**Slug:** `KAGGLE_PULL_KERNEL`

Tool to pull (download) the source code of a Kaggle kernel to local storage. Use when you need to retrieve a kernel's notebook, script, or metadata files. Optionally include metadata JSON file with kernel configuration details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `path` | string | No | Directory to download kernel files to; defaults to current working directory. The kernel source file(s) will be saved in this location. |
| `force` | boolean | No | If true, force re-download even if files already exist in the destination directory. |
| `metadata` | boolean | No | If true, include kernel-metadata.json file in the download. This file contains kernel configuration details like language, GPU settings, and dataset references. |
| `owner_slug` | string | Yes | Kernel owner username (e.g., 'kami1976'). This is the username of the person or organization that owns the kernel. |
| `kernel_slug` | string | Yes | Kernel name/slug (e.g., 'stanford-rna-3d-enhanced-model'). This is the URL-friendly identifier for the kernel, typically lowercase with hyphens. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### View competition leaderboard

**Slug:** `KAGGLE_VIEW_COMPETITION_LEADERBOARD`

Tool to view competition leaderboard information showing rankings and scores of participants. Use when you need to check competition standings, team scores, or analyze leaderboard positions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Competition name or URL slug (identifier). Find this in the competition's URL: kaggle.com/competitions/{slug} |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |