The Trigger.dev MCP Server provides a comprehensive set of tools that enable AI assistants to interact with your Trigger.dev projects. These tools cover everything from project management to task execution and monitoring.

​
Documentation and Search Tools

​
search_docs

Search across the Trigger.dev documentation to find relevant information, code examples, API references, and guides.
​
query
string
required
The search query to find information in the Trigger.dev documentation
Usage Examples:
  • “How do I create a scheduled task?”
  • “webhook examples”
  • “deployment configuration”
  • “error handling patterns”
{
  "tool": "search_docs",
  "arguments": {
    "query": "webhook examples"
  }
}

​
Project Management Tools

​
list_projects

List all projects in your Trigger.dev account. No parameters required
​
projects
array
Array of project objects containing project details, IDs, and metadata
{
  "projects": [
    {
      "id": "proj_abc123",
      "name": "My App",
      "slug": "my-app",
      "organizationId": "org_xyz789"
    }
  ]
}

​
list_orgs

List all organizations you have access to. No parameters required
​
orgs
array
Array of organization objects containing organization details and metadata

​
create_project_in_org

Create a new project in an organization.
​
orgParam
string
required
The organization to create the project in, can either be the organization slug or the ID. Use the list_orgs tool to get a list of organizations and ask the user to select one.
​
name
string
required
The name of the project to create
{
  "tool": "create_project_in_org",
  "arguments": {
    "orgParam": "my-org",
    "name": "New Project"
  }
}

​
initialize_project

Initialize Trigger.dev in your project with automatic setup and configuration.
​
orgParam
string
required
The organization to create the project in, can either be the organization slug or the ID. Use the list_orgs tool to get a list of organizations and ask the user to select one.
​
projectRef
string
The trigger.dev project ref, starts with proj_. We will attempt to automatically detect the project ref if running inside a directory that includes a trigger.config.ts file.
​
projectName
string
required
The name of the project to create. If projectRef is not provided, we will use this name to create a new project in the organization you select.
​
cwd
string
required
The current working directory of the project

​
Task Management Tools

​
get_tasks

Get all tasks in a project.
​
projectRef
string
The trigger.dev project ref, starts with proj_. We will attempt to automatically detect the project ref if running inside a directory that includes a trigger.config.ts file.
​
configPath
string
The path to the trigger.config.ts file. Only used when the trigger.config.ts file is not at the root dir (like in a monorepo setup). If not provided, we will try to find the config file in the current working directory.
​
environment
string
default:"dev"
The environment to get tasks for. Options: dev, staging, prod, preview
​
branch
string
The branch to get tasks for, only used for preview environments
{
  "tool": "get_tasks",
  "arguments": {
    "projectRef": "proj_abc123",
    "environment": "dev"
  }
}

​
trigger_task

Trigger a task to run.
​
projectRef
string
The trigger.dev project ref, starts with proj_. We will attempt to automatically detect the project ref if running inside a directory that includes a trigger.config.ts file.
​
configPath
string
The path to the trigger.config.ts file. Only used when the trigger.config.ts file is not at the root dir (like in a monorepo setup).
​
environment
string
default:"dev"
The environment to trigger the task in. Options: dev, staging, prod, preview
​
branch
string
The branch to trigger the task in, only used for preview environments
​
taskId
string
required
The ID/slug of the task to trigger. Use the get_tasks tool to get a list of tasks and ask the user to select one if it’s not clear which one to use.
​
payload
string
required
The payload to trigger the task with, must be a valid JSON string
​
options
object
Additional options for the task run
{
  "tool": "trigger_task",
  "arguments": {
    "projectRef": "proj_abc123",
    "taskId": "email-notification",
    "payload": "{\"email\": \"user@example.com\", \"subject\": \"Hello World\"}",
    "options": {
      "tags": ["urgent"],
      "maxAttempts": 3
    }
  }
}

​
Run Monitoring Tools

​
get_run_details

Get the details of a specific task run.
​
projectRef
string
The trigger.dev project ref, starts with proj_. We will attempt to automatically detect the project ref if running inside a directory that includes a trigger.config.ts file.
​
configPath
string
The path to the trigger.config.ts file. Only used when the trigger.config.ts file is not at the root dir (like in a monorepo setup).
​
environment
string
default:"dev"
The environment to get the run details from. Options: dev, staging, prod, preview
​
branch
string
The branch to get the run details from, only used for preview environments
​
runId
string
required
The ID of the run to get the details of, starts with run_
​
debugMode
boolean
Enable debug mode to get more detailed information about the run, including the entire trace (all logs and spans for the run and any child run). Set this to true if prompted to debug a run.

​
cancel_run

Cancel a running task.
​
runId
string
required
The ID of the run to cancel, starts with run_
​
projectRef
string
The trigger.dev project ref, starts with proj_. We will attempt to automatically detect the project ref if running inside a directory that includes a trigger.config.ts file.
​
configPath
string
The path to the trigger.config.ts file. Only used when the trigger.config.ts file is not at the root dir (like in a monorepo setup).
​
environment
string
default:"dev"
The environment to cancel the run in. Options: dev, staging, prod, preview
​
branch
string
The branch to cancel the run in, only used for preview environments
{
  "tool": "cancel_run",
  "arguments": {
    "runId": "run_abc123",
    "projectRef": "proj_abc123"
  }
}

​
list_runs

List all runs for a project with comprehensive filtering options.
​
projectRef
string
The trigger.dev project ref, starts with proj_. We will attempt to automatically detect the project ref if running inside a directory that includes a trigger.config.ts file.
​
configPath
string
The path to the trigger.config.ts file. Only used when the trigger.config.ts file is not at the root dir (like in a monorepo setup).
​
environment
string
default:"dev"
The environment to list runs from. Options: dev, staging, prod, preview
​
branch
string
The branch to list runs from, only used for preview environments
​
cursor
string
The cursor to use for pagination, starts with run_
​
limit
integer
The number of runs to list in a single page. Up to 100
​
status
string
Filter for runs with this run status. Options: PENDING_VERSION, QUEUED, DEQUEUED, EXECUTING, WAITING, COMPLETED, CANCELED, FAILED, CRASHED, SYSTEM_FAILURE, DELAYED, EXPIRED, TIMED_OUT
​
taskIdentifier
string
Filter for runs that match this task identifier
​
version
string
Filter for runs that match this version, e.g. 20250808.3
​
tag
string
Filter for runs that include this tag
​
from
string
Filter for runs created after this ISO 8601 timestamp
​
to
string
Filter for runs created before this ISO 8601 timestamp
​
period
string
Filter for runs created in the last N time period. Examples: 7d, 30d, 365d
​
machine
string
Filter for runs that match this machine preset. Options: micro, small-1x, small-2x, medium-1x, medium-2x, large-1x, large-2x
{
  "tool": "list_runs",
  "arguments": {
    "projectRef": "proj_abc123",
    "status": "COMPLETED",
    "limit": 10,
    "period": "7d"
  }
}

​
Deployment Tools

​
deploy

Deploy a project to staging or production environments.
​
projectRef
string
The trigger.dev project ref, starts with proj_. We will attempt to automatically detect the project ref if running inside a directory that includes a trigger.config.ts file.
​
configPath
string
The path to the trigger.config.ts file. Only used when the trigger.config.ts file is not at the root dir (like in a monorepo setup).
​
environment
string
default:"prod"
The environment to deploy to. Options: staging, prod, preview
​
branch
string
The branch to deploy, only used for preview environments
​
skipPromotion
boolean
Skip promoting the deployment to the current deployment for the environment
​
skipSyncEnvVars
boolean
Skip syncing environment variables when using the syncEnvVars extension
​
skipUpdateCheck
boolean
Skip checking for @trigger.dev package updates
{
  "tool": "deploy",
  "arguments": {
    "projectRef": "proj_abc123",
    "environment": "prod",
    "skipUpdateCheck": true
  }
}

​
list_deployments

List deployments for a project with comprehensive filtering options.
​
projectRef
string
The trigger.dev project ref, starts with proj_. We will attempt to automatically detect the project ref if running inside a directory that includes a trigger.config.ts file.
​
configPath
string
The path to the trigger.config.ts file. Only used when the trigger.config.ts file is not at the root dir (like in a monorepo setup).
​
environment
string
default:"prod"
The environment to list deployments for. Options: staging, prod, preview
​
branch
string
The branch to list deployments from, only used for preview environments
​
cursor
string
The deployment ID to start the search from, to get the next page
​
limit
number
The number of deployments to return, defaults to 20 (max 100)
​
status
string
Filter deployments that are in this status. Options: PENDING, BUILDING, DEPLOYING, DEPLOYED, FAILED, CANCELED, TIMED_OUT
​
from
string
The date to start the search from, in ISO 8601 format
​
to
string
The date to end the search, in ISO 8601 format
​
period
string
The period to search within. Examples: 1d, 7d, 3h
{
  "tool": "list_deployments",
  "arguments": {
    "projectRef": "proj_abc123",
    "environment": "prod",
    "status": "DEPLOYED",
    "limit": 10
  }
}

​
list_preview_branches

List all preview branches in the project.
​
projectRef
string
The trigger.dev project ref, starts with proj_. We will attempt to automatically detect the project ref if running inside a directory that includes a trigger.config.ts file.
​
configPath
string
The path to the trigger.config.ts file. Only used when the trigger.config.ts file is not at the root dir (like in a monorepo setup). If not provided, we will try to find the config file in the current working directory.
{
  "tool": "list_preview_branches",
  "arguments": {
    "projectRef": "proj_abc123"
  }
}