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.
22 tools: 7 can delete or cancel things, 1 do something that can't be undone and 14 change things.
Scanned Oct 21, 2026
- Deletes or cancels7Claude Code: deny: see these tools
- Can't be undone1Claude Code: ask: see these tools
- Changes things14Claude Code: ask: see these tools
- Only reads0Claude Code: allow
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/mcpFindings
Matches of fixed checks, with the text they matched.
The server marks "trigger_list_runs" read-only (readOnlyHint: true), and its own name, description or input give the class "irreversible".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_list_runs" says "trigger": a word for a change.
- Warntrigger_get_run
The server marks "trigger_get_run" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_get_run" says "trigger": a word for a change.
The server marks "trigger_get_run_trace" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_get_run_trace" says "trigger": a word for a change.
The server marks "trigger_get_run_span" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_get_run_span" says "trigger": a word for a change.
The server marks "trigger_list_run_events" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_list_run_events" says "trigger": a word for a change.
The server marks "trigger_get_run_metadata" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_get_run_metadata" says "trigger": a word for a change.
Show 9 more findingsShow fewer
The server marks "trigger_get_batch_results" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_get_batch_results" says "trigger": a word for a change.
The server marks "trigger_list_schedules" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_list_schedules" says "trigger": a word for a change.
The server marks "trigger_get_schedule" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_get_schedule" says "trigger": a word for a change.
The server marks "trigger_list_queues" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_list_queues" says "trigger": a word for a change.
The server marks "trigger_get_queue" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_get_queue" says "trigger": a word for a change.
The server marks "trigger_get_current_deployment" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_get_current_deployment" says "trigger": a word for a change.
The server marks "trigger_list_env_vars" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_list_env_vars" says "trigger": a word for a change.
The server marks "trigger_list_waitpoint_tokens" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_list_waitpoint_tokens" says "trigger": a word for a change.
The server marks "trigger_list_bulk_actions" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_list_bulk_actions" says "trigger": a word for a change.
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".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_list_runs" says "trigger": a word for a change.
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".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_get_batch_results" says "trigger": a word for a change.
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".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_get_current_deployment" says "trigger": a word for a change.
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".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_get_queue" says "trigger": a word for a change.
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".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_get_run" says "trigger": a word for a change.
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".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_get_run_metadata" says "trigger": a word for a change.
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".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_get_run_span" says "trigger": a word for a change.
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".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_get_run_trace" says "trigger": a word for a change.
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".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_get_schedule" says "trigger": a word for a change.
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".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_list_bulk_actions" says "trigger": a word for a change.
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".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_list_env_vars" says "trigger": a word for a change.
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".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_list_queues" says "trigger": a word for a change.
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".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_list_run_events" says "trigger": a word for a change.
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".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_list_schedules" says "trigger": a word for a change.
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".
What this check looks forMatched text
annotations: {"readOnlyHint":true}; The name "trigger_list_waitpoint_tokens" says "trigger": a word for a change.
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/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change, deny the deletes. Paste into .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.