Servers Playground How we check Submit a server

Trigger.dev MCP by usefulapi

Working · 434 ms

io.usefulapi/trigger-devv1.17.0 Domain verified

Debug background jobs — runs, traces, spans, schedules, queues and deployments.

Developer Tools

Source Website Registry entry

Try it

Call this server's tools from your browser. Nothing to install.

https://trigger-dev.usefulapi.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

trigger_activate_schedule

Resume a paused schedule so it fires again. Trigger.dev: POST /api/v1/schedules/{scheduleId}/activate.

schedule_idstring, required

The schedule to activate.

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

Trigger.dev MCP by usefulapi MCP server | mcptry

Tools (22)

trigger_activate_schedule

Resume a paused schedule so it fires again. Trigger.dev: POST /api/v1/schedules/{scheduleId}/activate.

destructive

Argument	Type	Description
schedule_id*	string	The schedule to activate.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "schedule_id"
  ],
  "properties": {
    "schedule_id": {
      "type": "string",
      "description": "The schedule to activate."
    }
  }
}

trigger_add_run_tags

Attach tags to a run so you can filter for it later. Additive and safe. Trigger.dev: POST /api/v1/runs/{runId}/tags.

destructive

Argument	Type	Description
tags*	array	Tags to add.
run_id*	string	The run to tag.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "run_id",
    "tags"
  ],
  "properties": {
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tags to add."
    },
    "run_id": {
      "type": "string",
      "description": "The run to tag."
    }
  }
}

trigger_cancel_run

Cancel an in-flight run. Note this is the one endpoint on API v2, not v1. Trigger.dev: POST /api/v2/runs/{runId}/cancel.

destructive

Argument	Type	Description
run_id*	string	The run to cancel.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "run_id"
  ],
  "properties": {
    "run_id": {
      "type": "string",
      "description": "The run to cancel."
    }
  }
}

trigger_deactivate_schedule

Pause a schedule so it stops firing. The usual first move when a scheduled task is misbehaving. Trigger.dev: POST /api/v1/schedules/{scheduleId}/deactivate.

destructive

Argument	Type	Description
schedule_id*	string	The schedule to pause.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "schedule_id"
  ],
  "properties": {
    "schedule_id": {
      "type": "string",
      "description": "The schedule to pause."
    }
  }
}

trigger_get_batch_results

Fetch the outcome of every run in a batch. Trigger.dev: GET /api/v1/batches/{batchId}/results.

read-only

Argument	Type	Description
batch_id*	string	The batch's id (batch_...).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "batch_id"
  ],
  "properties": {
    "batch_id": {
      "type": "string",
      "description": "The batch's id (batch_...)."
    }
  }
}

trigger_get_current_deployment

Fetch the deployment currently serving the key's environment — its version, git ref and status. Trigger.dev: GET /api/v1/deployments/current.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

trigger_get_queue

Fetch a single queue's concurrency limit, running count and queued count. Trigger.dev: GET /api/v1/queues/{queue}.

read-only

Argument	Type	Description
queue*	string	The queue's name or id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "queue"
  ],
  "properties": {
    "queue": {
      "type": "string",
      "description": "The queue's name or id."
    }
  }
}

trigger_get_run

Fetch a single run's outcome — its status, output, error and attempts. Trigger.dev: GET /api/v1/runs/{runId}/result.

read-only

Argument	Type	Description
run_id*	string	The run's id (run_...).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "run_id"
  ],
  "properties": {
    "run_id": {
      "type": "string",
      "description": "The run's id (run_...)."
    }
  }
}

trigger_get_run_metadata

Fetch the mutable metadata a run has written about itself — progress, checkpoints and custom state. Trigger.dev: GET /api/v1/runs/{runId}/metadata.

read-only

Argument	Type	Description
run_id*	string	The run's id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "run_id"
  ],
  "properties": {
    "run_id": {
      "type": "string",
      "description": "The run's id."
    }
  }
}

trigger_get_run_span

Fetch a single span from a run's trace, with its own logs and attributes. Trigger.dev: GET /api/v1/runs/{runId}/spans/{spanId}.

read-only

Argument	Type	Description
run_id*	string	The run's id.
span_id*	string	The span's id, from the trace.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "run_id",
    "span_id"
  ],
  "properties": {
    "run_id": {
      "type": "string",
      "description": "The run's id."
    },
    "span_id": {
      "type": "string",
      "description": "The span's id, from the trace."
    }
  }
}

trigger_get_run_trace

Fetch the full execution trace of a run — every span, with timings and nesting. The tool for 'where did this run spend its time, and where did it break?'. Trigger.dev: GET /api/v1/runs/{runId}/trace.

read-only

Argument	Type	Description
run_id*	string	The run's id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "run_id"
  ],
  "properties": {
    "run_id": {
      "type": "string",
      "description": "The run's id."
    }
  }
}

trigger_get_schedule

Fetch a single schedule with its cron expression, timezone and active state. Trigger.dev: GET /api/v1/schedules/{scheduleId}.

read-only

Argument	Type	Description
schedule_id*	string	The schedule's id (sched_...).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "schedule_id"
  ],
  "properties": {
    "schedule_id": {
      "type": "string",
      "description": "The schedule's id (sched_...)."
    }
  }
}

trigger_list_bulk_actions

List bulk replay and cancel operations and their progress. Trigger.dev: GET /api/v1/bulk-actions.

read-only

Argument	Type	Description
pageSize	integer	Page size, 1-100.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "pageSize": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Page size, 1-100."
    }
  }
}

trigger_list_env_vars

List the environment variables configured for a project environment. Values may be redacted depending on the key's permissions. READ ONLY — this server exposes no env-var writes. Trigger.dev: GET /api/v1/projects/{projectRef}/envvars/{env}.

read-only

Argument	Type	Description
environment*	string	Which environment's variables to list.
project_ref*	string	The project reference (proj_...).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "project_ref",
    "environment"
  ],
  "properties": {
    "environment": {
      "enum": [
        "dev",
        "staging",
        "prod",
        "preview"
      ],
      "type": "string",
      "description": "Which environment's variables to list."
    },
    "project_ref": {
      "type": "string",
      "description": "The project reference (proj_...)."
    }
  }
}

trigger_list_queues

List task queues with their concurrency limits and current depth — where you look when work is backing up. Trigger.dev: GET /api/v1/queues.

read-only

Argument	Type	Description
pageSize	integer	Page size, 1-100.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "pageSize": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Page size, 1-100."
    }
  }
}

trigger_list_run_events

List the lifecycle events of one run — queued, dequeued, started, retried, completed. Trigger.dev: GET /api/v1/runs/{runId}/events.

read-only

Argument	Type	Description
run_id*	string	The run's id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "run_id"
  ],
  "properties": {
    "run_id": {
      "type": "string",
      "description": "The run's id."
    }
  }
}

trigger_list_runs

List task runs, filtered by status, task, tag, queue, schedule or a time window. This is the main read for 'what ran, and what failed?'. Trigger.dev: GET /api/v1/runs.

read-only

Argument	Type	Description
to	string	Epoch milliseconds upper bound on creation time.
tag	array	Only runs carrying these tags.
from	string	Epoch milliseconds lower bound on creation time.
after	string	Cursor from the previous page's pagination. Omit for the first page.
batch	string	Only runs in this batch.
queue	array	Only runs on these queues.
isTest	boolean	Only test runs, or only real ones.
period	string	Relative window, e.g. "1h", "24h", "7d".
status	array	Only runs in these states, e.g. ["FAILED","CRASHED"]. Others include PENDING, EXECUTING, COMPLETED, CANCELED, TIMED_OUT.

trigger_list_schedules

List the cron schedules configured for tasks, with their next run times. Trigger.dev: GET /api/v1/schedules.

read-only

Argument	Type	Description
page	integer	1-based page number.
pageSize	integer	Page size, 1-100.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "1-based page number."
    },
    "pageSize": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Page size, 1-100."
    }
  }
}

trigger_list_waitpoint_tokens

List outstanding waitpoint tokens — runs paused waiting for an external signal. Trigger.dev: GET /api/v1/waitpoints/tokens.

read-only

Argument	Type	Description
after	string	Cursor from the previous page's pagination. Omit for the first page.
pageSize	integer	Page size, 1-100.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "after": {
      "type": "string",
      "description": "Cursor from the previous page's pagination. Omit for the first page."
    },
    "pageSize": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Page size, 1-100."
    }
  }
}

trigger_pause_queue

Pause a queue so its runs stop being dequeued, or resume it. The containment move when a task is failing in a loop. Trigger.dev: POST /api/v1/queues/{queue}/pause.

destructive

Argument	Type	Description
queue*	string	The queue's name or id.
paused*	boolean	true to pause, false to resume.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "queue",
    "paused"
  ],
  "properties": {
    "queue": {
      "type": "string",
      "description": "The queue's name or id."
    },
    "paused": {
      "type": "boolean",
      "description": "true to pause, false to resume."
    }
  }
}

trigger_replay_run

Re-run one specific past run with the same payload. This EXECUTES your production task again — the same side effects it had the first time. Trigger.dev: POST /api/v1/runs/{runId}/replay.

destructive

Argument	Type	Description
run_id*	string	The run to replay.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "run_id"
  ],
  "properties": {
    "run_id": {
      "type": "string",
      "description": "The run to replay."
    }
  }
}

trigger_reschedule_run

Change when a delayed run will execute. Only applies to runs that have not started. Trigger.dev: POST /api/v1/runs/{runId}/reschedule.

destructive

Argument	Type	Description
delay*	string	New delay or timestamp, e.g. "1h" or an ISO-8601 datetime.
run_id*	string	The delayed run to move.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "run_id",
    "delay"
  ],
  "properties": {
    "delay": {
      "type": "string",
      "description": "New delay or timestamp, e.g. \"1h\" or an ISO-8601 datetime."
    },
    "run_id": {
      "type": "string",
      "description": "The delayed run to move."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "to": {
      "type": "string",
      "description": "Epoch milliseconds upper bound on creation time."
    },
    "tag": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Only runs carrying these tags."
    },
    "from": {
      "type": "string",
      "description": "Epoch milliseconds lower bound on creation time."
    },
    "after": {
      "type": "string",
      "description": "Cursor from the previous page's pagination. Omit for the first page."
    },
    "batch": {
      "type": "string",
      "description": "Only runs in this batch."
    },
    "queue": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Only runs on these queues."
    },
    "isTest": {
      "type": "boolean",
      "description": "Only test runs, or only real ones."
    },
    "period": {
      "type": "string",
      "description": "Relative window, e.g. \"1h\", \"24h\", \"7d\"."
    },
    "status": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Only runs in these states, e.g. [\"FAILED\",\"CRASHED\"]. Others include PENDING, EXECUTING, COMPLETED, CANCELED, TIMED_OUT."
    },
    "machine": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Only runs on these machine presets."
    },
    "version": {
      "type": "string",
      "description": "Only runs of this deployment version."
    },
    "pageSize": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Page size, 1-100."
    },
    "schedule": {
      "type": "string",
      "description": "Only runs created by this schedule."
    },
    "taskIdentifier": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Only runs of these task ids."
    }
  }
}