# Source: https://trigger.dev/docs/mcp-tools.md

> ## Documentation Index
> Fetch the complete documentation index at: https://trigger.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Tools

> Learn about how to use the tools available in the Trigger.dev MCP Server

## Documentation and Search Tools

### search\_docs

Search the Trigger.dev documentation for guides, examples, and API references.

**Example usage:**

* *"How do I create a scheduled task?"*
* *"Show me webhook examples"*
* *"What are the deployment options?"*

## Project Management Tools

### list\_orgs

List all organizations you have access to.

**Example usage:**

* *"What organizations do I have?"*
* *"Show me my orgs"*

### list\_projects

List all projects in your Trigger.dev account.

**Example usage:**

* *"What projects do I have?"*
* *"List my Trigger.dev projects"*

### create\_project\_in\_org

Create a new project in an organization.

**Example usage:**

* *"Create a new project called 'my-app'"*
* *"Set up a new Trigger.dev project"*

### initialize\_project

Initialize Trigger.dev in your project with automatic setup and configuration.

**Example usage:**

* *"Set up Trigger.dev in this project"*
* *"Add Trigger.dev to my app"*

## Task Management Tools

### get\_current\_worker

Get the current worker for a project, including the worker version, SDK version, and registered tasks with their payload schemas.

**Example usage:**

* *"What tasks are available?"*
* *"Show me the tasks in dev"*

### trigger\_task

Trigger a task to run with a specific payload. You can add a delay, set tags, configure retries, choose a machine size, set a TTL, or use an idempotency key.

**Example usage:**

* *"Run the email-notification task"*
* *"Trigger my-task with userId 123"*
* *"Execute the sync task in production"*

## Run Monitoring Tools

### get\_run\_details

Get detailed information about a specific task run, including logs and status. Enable debug mode to get the full trace with all logs and spans.

**Example usage:**

* *"Show me details for run run\_abc123"*
* *"Why did this run fail?"*

### list\_runs

List runs for a project. Filter by status, task, tags, version, machine size, or time period.

**Example usage:**

* *"Show me recent runs"*
* *"List failed runs from the last 7 days"*
* *"What runs are currently executing?"*

### wait\_for\_run\_to\_complete

Wait for a specific run to finish and return the result.

**Example usage:**

* *"Wait for run run\_abc123 to complete"*

### cancel\_run

Cancel a running or queued run.

**Example usage:**

* *"Cancel run run\_abc123"*
* *"Stop that task"*

## Deployment Tools

### deploy

Deploy your project to staging or production.

**Example usage:**

* *"Deploy to production"*
* *"Deploy to staging"*

### list\_deploys

List deployments for a project. Filter by status or time period.

**Example usage:**

* *"Show me recent deployments"*
* *"What's deployed to production?"*

### list\_preview\_branches

List all preview branches in the project.

**Example usage:**

* *"What preview branches exist?"*
* *"Show me preview deployments"*

<Callout type="warning">
  The deploy and list\_preview\_branches tools are not available when the MCP server is running with the `--dev-only` flag.
</Callout>