Skip to content

Trigger.dev MCP by usefulapi

by usefulapi.io · remote · no sign-in to list tools · v1.16.3 · published by io.usefulapi

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

Deletes · 7Final · 1Changes · 14

22 tools: 7 can delete or cancel things, 1 do something that can't be undone and 14 change things.

Scanned Oct 21, 2026

15 checks matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http trigger-dev https://trigger-dev.usefulapi.io/mcp

Findings

Matches of fixed checks, with the text they matched.

15 warn
  • The server marks "trigger_list_runs" read-only (readOnlyHint: true), and its own name, description or input give the class "irreversible".

    Matched text

    annotations: {"readOnlyHint":true}; The name "trigger_list_runs" says "trigger": a word for a change.

    What this check looks for
  • The server marks "trigger_get_run" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true}; The name "trigger_get_run" says "trigger": a word for a change.

    What this check looks for
  • The server marks "trigger_get_run_trace" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true}; The name "trigger_get_run_trace" says "trigger": a word for a change.

    What this check looks for
  • The server marks "trigger_get_run_span" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true}; The name "trigger_get_run_span" says "trigger": a word for a change.

    What this check looks for
  • The server marks "trigger_list_run_events" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true}; The name "trigger_list_run_events" says "trigger": a word for a change.

    What this check looks for
  • The server marks "trigger_get_run_metadata" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true}; The name "trigger_get_run_metadata" says "trigger": a word for a change.

    What this check looks for
Show 9 more findings
  • The server marks "trigger_get_batch_results" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true}; The name "trigger_get_batch_results" says "trigger": a word for a change.

    What this check looks for
  • The server marks "trigger_list_schedules" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true}; The name "trigger_list_schedules" says "trigger": a word for a change.

    What this check looks for
  • The server marks "trigger_get_schedule" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true}; The name "trigger_get_schedule" says "trigger": a word for a change.

    What this check looks for
  • The server marks "trigger_list_queues" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true}; The name "trigger_list_queues" says "trigger": a word for a change.

    What this check looks for
  • The server marks "trigger_get_queue" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true}; The name "trigger_get_queue" says "trigger": a word for a change.

    What this check looks for
  • The server marks "trigger_get_current_deployment" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true}; The name "trigger_get_current_deployment" says "trigger": a word for a change.

    What this check looks for
  • The server marks "trigger_list_env_vars" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true}; The name "trigger_list_env_vars" says "trigger": a word for a change.

    What this check looks for
  • The server marks "trigger_list_waitpoint_tokens" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true}; The name "trigger_list_waitpoint_tokens" says "trigger": a word for a change.

    What this check looks for
  • The server marks "trigger_list_bulk_actions" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true}; The name "trigger_list_bulk_actions" says "trigger": a word for a change.

    What this check looks for

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

22 tools

Deletes or cancels 7Claude Code: deny
  • trigger_activate_scheduleResume a paused schedule so it fires again.No findings

    Why it is in this group

    • The name "trigger_activate_schedule" says "trigger": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Resume a paused schedule so it fires again. Trigger.dev: POST /api/v1/schedules/{scheduleId}/activate.

    Annotations the server declares

    • title: Activate a schedule
    • destructiveHint: true
  • trigger_add_run_tagsAttach tags to a run so you can filter for it later.No findings

    Why it is in this group

    • The name "trigger_add_run_tags" says "trigger": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Attach tags to a run so you can filter for it later. Additive and safe. Trigger.dev: POST /api/v1/runs/{runId}/tags.

    Annotations the server declares

    • title: Add tags to a run
    • destructiveHint: true
  • trigger_cancel_runCancel an in-flight run.No findings

    Why it is in this group

    • The name "trigger_cancel_run" says "trigger": a word for a change.
    • The description's first verb is "cancel": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Cancel an in-flight run. Note this is the one endpoint on API v2, not v1. Trigger.dev: POST /api/v2/runs/{runId}/cancel.

    Annotations the server declares

    • title: Cancel a run
    • destructiveHint: true
  • trigger_deactivate_schedulePause a schedule so it stops firing.No findings

    Why it is in this group

    • The name "trigger_deactivate_schedule" says "trigger": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Deactivate a schedule
    • destructiveHint: true
  • trigger_pause_queuePause a queue so its runs stop being dequeued, or resume it.No findings

    Why it is in this group

    • The name "trigger_pause_queue" says "trigger": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Pause or resume a queue
    • destructiveHint: true
  • trigger_replay_runRe-run one specific past run with the same payload.No findings

    Why it is in this group

    • The name "trigger_replay_run" says "trigger": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Replay a run
    • destructiveHint: true
  • trigger_reschedule_runChange when a delayed run will execute.No findings

    Why it is in this group

    • The name "trigger_reschedule_run" says "trigger": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Change when a delayed run will execute. Only applies to runs that have not started. Trigger.dev: POST /api/v1/runs/{runId}/reschedule.

    Annotations the server declares

    • title: Reschedule a delayed run
    • destructiveHint: true
Can't be undone 1Claude Code: ask
  • trigger_list_runsList task runs, filtered by status, task, tag, queue, schedule or a time window.1 finding

    Why it is in this group

    • The name "trigger_list_runs" says "trigger": a word for a change.
    • The input addresses people (input.to): what it sends cannot be taken back.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "trigger_list_runs" read-only (readOnlyHint: true), and its own name, description or input give the class "irreversible".

      Matched text

      annotations: {"readOnlyHint":true}; The name "trigger_list_runs" says "trigger": a word for a change.

      What this check looks for
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: List runs
    • readOnlyHint: true
Changes things 14Claude Code: ask
  • trigger_get_batch_resultsFetch the outcome of every run in a batch.1 finding

    Why it is in this group

    • The name "trigger_get_batch_results" says "trigger": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "trigger_get_batch_results" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true}; The name "trigger_get_batch_results" says "trigger": a word for a change.

      What this check looks for
    Description, as the server wrote it
    Fetch the outcome of every run in a batch. Trigger.dev: GET /api/v1/batches/{batchId}/results.

    Annotations the server declares

    • title: Get a batch's results
    • readOnlyHint: true
  • trigger_get_current_deploymentFetch the deployment currently serving the key's environment — its version, git ref and status.1 finding

    Why it is in this group

    • The name "trigger_get_current_deployment" says "trigger": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "trigger_get_current_deployment" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true}; The name "trigger_get_current_deployment" says "trigger": a word for a change.

      What this check looks for
    Description, as the server wrote it
    Fetch the deployment currently serving the key's environment — its version, git ref and status. Trigger.dev: GET /api/v1/deployments/current.

    Annotations the server declares

    • title: Get the current deployment
    • readOnlyHint: true
  • trigger_get_queueFetch a single queue's concurrency limit, running count and queued count.1 finding

    Why it is in this group

    • The name "trigger_get_queue" says "trigger": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "trigger_get_queue" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true}; The name "trigger_get_queue" says "trigger": a word for a change.

      What this check looks for
    Description, as the server wrote it
    Fetch a single queue's concurrency limit, running count and queued count. Trigger.dev: GET /api/v1/queues/{queue}.

    Annotations the server declares

    • title: Get one queue
    • readOnlyHint: true
  • trigger_get_runFetch a single run's outcome — its status, output, error and attempts.1 finding

    Why it is in this group

    • The name "trigger_get_run" says "trigger": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "trigger_get_run" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true}; The name "trigger_get_run" says "trigger": a word for a change.

      What this check looks for
    Description, as the server wrote it
    Fetch a single run's outcome — its status, output, error and attempts. Trigger.dev: GET /api/v1/runs/{runId}/result.

    Annotations the server declares

    • title: Get one run
    • readOnlyHint: true
  • trigger_get_run_metadataFetch the mutable metadata a run has written about itself — progress, checkpoints and custom state.1 finding

    Why it is in this group

    • The name "trigger_get_run_metadata" says "trigger": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "trigger_get_run_metadata" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true}; The name "trigger_get_run_metadata" says "trigger": a word for a change.

      What this check looks for
    Description, as the server wrote it
    Fetch the mutable metadata a run has written about itself — progress, checkpoints and custom state. Trigger.dev: GET /api/v1/runs/{runId}/metadata.

    Annotations the server declares

    • title: Get a run's metadata
    • readOnlyHint: true
  • trigger_get_run_spanFetch a single span from a run's trace, with its own logs and attributes.1 finding

    Why it is in this group

    • The name "trigger_get_run_span" says "trigger": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "trigger_get_run_span" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true}; The name "trigger_get_run_span" says "trigger": a word for a change.

      What this check looks for
    Description, as the server wrote it
    Fetch a single span from a run's trace, with its own logs and attributes. Trigger.dev: GET /api/v1/runs/{runId}/spans/{spanId}.

    Annotations the server declares

    • title: Get one span of a run
    • readOnlyHint: true
  • trigger_get_run_traceFetch the full execution trace of a run — every span, with timings and nesting.1 finding

    Why it is in this group

    • The name "trigger_get_run_trace" says "trigger": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "trigger_get_run_trace" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true}; The name "trigger_get_run_trace" says "trigger": a word for a change.

      What this check looks for
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Get a run's trace
    • readOnlyHint: true
  • trigger_get_scheduleFetch a single schedule with its cron expression, timezone and active state.1 finding

    Why it is in this group

    • The name "trigger_get_schedule" says "trigger": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "trigger_get_schedule" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true}; The name "trigger_get_schedule" says "trigger": a word for a change.

      What this check looks for
    Description, as the server wrote it
    Fetch a single schedule with its cron expression, timezone and active state. Trigger.dev: GET /api/v1/schedules/{scheduleId}.

    Annotations the server declares

    • title: Get one schedule
    • readOnlyHint: true
  • trigger_list_bulk_actionsList bulk replay and cancel operations and their progress.1 finding

    Why it is in this group

    • The name "trigger_list_bulk_actions" says "trigger": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "trigger_list_bulk_actions" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true}; The name "trigger_list_bulk_actions" says "trigger": a word for a change.

      What this check looks for
    Description, as the server wrote it
    List bulk replay and cancel operations and their progress. Trigger.dev: GET /api/v1/bulk-actions.

    Annotations the server declares

    • title: List bulk actions
    • readOnlyHint: true
  • trigger_list_env_varsList the environment variables configured for a project environment.1 finding

    Why it is in this group

    • The name "trigger_list_env_vars" says "trigger": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "trigger_list_env_vars" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true}; The name "trigger_list_env_vars" says "trigger": a word for a change.

      What this check looks for
    Description, as the server wrote it
    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}.

    Annotations the server declares

    • title: List environment variables
    • readOnlyHint: true
  • trigger_list_queuesList task queues with their concurrency limits and current depth — where you look when work is backing up.1 finding

    Why it is in this group

    • The name "trigger_list_queues" says "trigger": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "trigger_list_queues" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true}; The name "trigger_list_queues" says "trigger": a word for a change.

      What this check looks for
    Description, as the server wrote it
    List task queues with their concurrency limits and current depth — where you look when work is backing up. Trigger.dev: GET /api/v1/queues.

    Annotations the server declares

    • title: List queues
    • readOnlyHint: true
  • trigger_list_run_eventsList the lifecycle events of one run — queued, dequeued, started, retried, completed.1 finding

    Why it is in this group

    • The name "trigger_list_run_events" says "trigger": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "trigger_list_run_events" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true}; The name "trigger_list_run_events" says "trigger": a word for a change.

      What this check looks for
    Description, as the server wrote it
    List the lifecycle events of one run — queued, dequeued, started, retried, completed. Trigger.dev: GET /api/v1/runs/{runId}/events.

    Annotations the server declares

    • title: List a run's events
    • readOnlyHint: true
  • trigger_list_schedulesList the cron schedules configured for tasks, with their next run times.1 finding

    Why it is in this group

    • The name "trigger_list_schedules" says "trigger": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "trigger_list_schedules" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true}; The name "trigger_list_schedules" says "trigger": a word for a change.

      What this check looks for
    Description, as the server wrote it
    List the cron schedules configured for tasks, with their next run times. Trigger.dev: GET /api/v1/schedules.

    Annotations the server declares

    • title: List schedules
    • readOnlyHint: true
  • trigger_list_waitpoint_tokensList outstanding waitpoint tokens — runs paused waiting for an external signal.1 finding

    Why it is in this group

    • The name "trigger_list_waitpoint_tokens" says "trigger": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "trigger_list_waitpoint_tokens" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true}; The name "trigger_list_waitpoint_tokens" says "trigger": a word for a change.

      What this check looks for
    Description, as the server wrote it
    List outstanding waitpoint tokens — runs paused waiting for an external signal. Trigger.dev: GET /api/v1/waitpoints/tokens.

    Annotations the server declares

    • title: List waitpoint tokens
    • readOnlyHint: true

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.16.3. Values in angle brackets are yours to fill in.

claude mcp add --transport http trigger-dev https://trigger-dev.usefulapi.io/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [],
    "ask": [
      "mcp__trigger-dev__trigger_list_runs",
      "mcp__trigger-dev__trigger_get_run",
      "mcp__trigger-dev__trigger_get_run_trace",
      "mcp__trigger-dev__trigger_get_run_span",
      "mcp__trigger-dev__trigger_list_run_events",
      "mcp__trigger-dev__trigger_get_run_metadata",
      "mcp__trigger-dev__trigger_get_batch_results",
      "mcp__trigger-dev__trigger_list_schedules",
      "mcp__trigger-dev__trigger_get_schedule",
      "mcp__trigger-dev__trigger_list_queues",
      "mcp__trigger-dev__trigger_get_queue",
      "mcp__trigger-dev__trigger_get_current_deployment",
      "mcp__trigger-dev__trigger_list_env_vars",
      "mcp__trigger-dev__trigger_list_waitpoint_tokens",
      "mcp__trigger-dev__trigger_list_bulk_actions"
    ],
    "deny": [
      "mcp__trigger-dev__trigger_cancel_run",
      "mcp__trigger-dev__trigger_replay_run",
      "mcp__trigger-dev__trigger_reschedule_run",
      "mcp__trigger-dev__trigger_add_run_tags",
      "mcp__trigger-dev__trigger_activate_schedule",
      "mcp__trigger-dev__trigger_deactivate_schedule",
      "mcp__trigger-dev__trigger_pause_queue"
    ]
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as trigger-dev. Review it before you use it.