Trigger.dev MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.39.2Updated Nov 14, 2026

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

The publisher's own server: Ably MCP by usefulapi

Overview

AI-generated overview

Hosted MCP server that lets an assistant inspect and control Trigger.dev background jobs: runs, traces, spans, schedules, queues and deployments.

What you can do
  • List and inspect runs, including status, output, errors, attempts, lifecycle events, metadata and batch results
  • Read execution traces and individual spans with timings and nesting to find where a run slowed down or broke
  • List cron schedules and queues with next run times, concurrency limits and depth, plus the current deployment and environment variables
  • List waitpoint tokens and bulk replay or cancel operations
  • Cancel, replay, reschedule or tag runs, activate or deactivate schedules, and pause or resume queues
  • Check usage, request a feature, upgrade or cancel the subscription
When to use it
Useful when you debug Trigger.dev background jobs from a chat client: finding failed runs in a time window, tracing where a run broke, checking schedules and queue backlogs, or cancelling and replaying runs during an incident.
Requirements
Remote streamable HTTP endpoint; no local install. Connect with the server URL only and sign in through OAuth with your Trigger.dev credentials on first connect; no API key or Authorization header goes in the client config. A free plan allows 50 tool calls per month.
Before you install
Write tools change Trigger.dev data: replaying a run executes the production task again with the same side effects, and cancel, reschedule, schedule activation and queue pausing affect live jobs. Your Trigger.dev credentials are pasted into the hosted service and stored per user. Paid plans (Pro, Pro+) are billed through Stripe checkout links, and cancellation gives no refund for the current period.

Installation

In SourceWeft

  1. Open Trigger.dev MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Ftrigger-dev/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "trigger-dev-by-usefulapi": {
      "type": "http",
      "url": "https://trigger-dev.usefulapi.io/mcp"
    }
  }
}

README

Trigger.dev MCP by usefulapi

Debug background jobs — runs, traces, spans, schedules, queues and deployments. Hosted, no local install.

Live endpoint: https://trigger-dev.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://trigger-dev.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http trigger-dev https://trigger-dev.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "trigger-dev": {      "url": "https://trigger-dev.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Trigger.dev credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/trigger-dev/

On first connect you'll paste your Trigger.dev credentials. They are validated, stored per-user, and scoped to you — no keys in config files.

Tools

ToolTypeWhat it does
trigger_list_runsreadList runs
trigger_get_runreadGet one run
trigger_get_run_tracereadGet a run's trace
trigger_get_run_spanreadGet one span of a run
trigger_list_run_eventsreadList a run's events
trigger_get_run_metadatareadGet a run's metadata
trigger_get_batch_resultsreadGet a batch's results
trigger_list_schedulesreadList schedules
trigger_get_schedulereadGet one schedule
trigger_list_queuesreadList queues
trigger_get_queuereadGet one queue
trigger_get_current_deploymentreadGet the current deployment
trigger_list_env_varsreadList environment variables
trigger_list_waitpoint_tokensreadList waitpoint tokens
trigger_list_bulk_actionsreadList bulk actions
trigger_cancel_runwriteCancel a run
trigger_replay_runwriteReplay a run
trigger_reschedule_runwriteReschedule a delayed run
trigger_add_run_tagswriteAdd tags to a run
trigger_activate_schedulewriteActivate a schedule
trigger_deactivate_schedulewriteDeactivate a schedule
trigger_pause_queuewritePause or resume a queue
trigger_dev_usage_statusmetaUsage status (free-tier meter)
trigger_dev_request_featuremetaRequest a missing feature
trigger_dev_upgrademetaUpgrade to Pro or Pro+
trigger_dev_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro$9/mo or $90/yr (2 months free)10,000 tool calls / month
Pro+$39/mo or $390/yr (2 months free)100,000 tool calls / month

Each paid plan covers this server only. Ask your AI to run trigger_dev_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with trigger_dev_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with trigger_dev_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT

Source: servers/trigger-dev/README.md at commit f22f848

Tools

22

trigger_list_runs

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.

ParameterstotagfromafterbatchqueueisTestperiodstatusmachineversionpageSize+2 more

trigger_get_run

Get one run

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

Parametersrun_idrequired

trigger_get_run_trace

Get a run's 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.

Parametersrun_idrequired

trigger_get_run_span

Get one span of a run

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

Parametersrun_idrequiredspan_idrequired

trigger_list_run_events

List a run's events

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

Parametersrun_idrequired

trigger_get_run_metadata

Get a run's metadata

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

Parametersrun_idrequired

trigger_get_batch_results

Get a batch's results

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

Parametersbatch_idrequired

trigger_list_schedules

List schedules

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

ParameterspagepageSize

trigger_get_schedule

Get one schedule

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

Parametersschedule_idrequired

trigger_list_queues

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.

ParameterspageSize

trigger_get_queue

Get one queue

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

Parametersqueuerequired

trigger_get_current_deployment

Get the current deployment

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

Takes no parameters.

trigger_list_env_vars

List environment variables

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}.

Parametersenvironmentrequiredproject_refrequired

trigger_list_waitpoint_tokens

List waitpoint tokens

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

ParametersafterpageSize

trigger_list_bulk_actions

List bulk actions

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

ParameterspageSize

trigger_cancel_run

Cancel a 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.

Parametersrun_idrequired

trigger_replay_run

Replay a 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.

Parametersrun_idrequired

trigger_reschedule_run

Reschedule a delayed run

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

Parametersdelayrequiredrun_idrequired

trigger_add_run_tags

Add tags to a run

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

Parameterstagsrequiredrun_idrequired

trigger_activate_schedule

Activate a schedule

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

Parametersschedule_idrequired

trigger_deactivate_schedule

Deactivate a 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.

Parametersschedule_idrequired

trigger_pause_queue

Pause or resume a 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.

Parametersqueuerequiredpausedrequired

Version history

26
  1. v1.39.2LatestNov 14, 2026
  2. v1.39.1Nov 13, 2026
  3. v1.38.0Nov 12, 2026
  4. v1.37.3Nov 11, 2026
  5. v1.36.5Nov 8, 2026
  6. v1.36.4Nov 7, 2026
  7. v1.35.3Nov 5, 2026
  8. v1.35.2Nov 5, 2026
  9. v1.35.1Nov 4, 2026
  10. v1.35.0Nov 3, 2026
  11. v1.34.1Nov 3, 2026
  12. v1.33.0Nov 1, 2026
  13. v1.31.0Oct 31, 2026
  14. v1.30.0Oct 31, 2026
  15. v1.29.2Oct 30, 2026
  16. v1.29.0Oct 30, 2026
  17. v1.24.0Oct 26, 2026
  18. v1.21.3Oct 25, 2026
  19. v1.21.0Oct 25, 2026
  20. v1.20.0Oct 24, 2026
  21. v1.17.0Oct 23, 2026
  22. v1.16.4Oct 22, 2026
  23. v1.16.3Oct 21, 2026
  24. v1.11.1Oct 9, 2026
  25. v1.10.0Oct 9, 2026
  26. v1.0.0Sep 29, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations