Trigger.dev MCP by usefulapi

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

我該用這個嗎

品質與安全性

A
說明品質
100%
結構描述完整度
95%
命名品質
80%
汙染風險
100%
權限相符程度
100%
協定合規性
100%

根據工具定義與協定合規性的自動化分析。

上下文成本

~2,901Token(工具定義)
~797 B典型回應大小
顯著的注意力影響(128k 上下文的 2.27%)

這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高,可用於其他工作的注意力就越少。

安裝

一鍵安裝

將以下內容加入你的 `claude_desktop_config.json` 檔案:

{
  "mcpServers": {
    "trigger-dev": {
      "url": "https://trigger-dev.usefulapi.io/mcp"
    }
  }
}

遠端端點

https://trigger-dev.usefulapi.io/mcpstreamable-http

它能做什麼

工具清單

工具(22)

🟢 唯讀🟡 寫入🔴 刪除⚪ 未知
🟢trigger_list_runs(status, taskIdentifier, tag, queue, machine, ...)

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.

輸入結構描述

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

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

輸入結構描述

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

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.

輸入結構描述

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

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

輸入結構描述

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

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

輸入結構描述

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

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

輸入結構描述

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

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

輸入結構描述

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

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

輸入結構描述

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

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

輸入結構描述

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

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

輸入結構描述

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

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

輸入結構描述

{
  "type": "object",
  "properties": {
    "queue": {
      "type": "string",
      "description": "The queue's name or id."
    }
  },
  "required": [
    "queue"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢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.

輸入結構描述

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢trigger_list_env_vars(project_ref, environment)

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

輸入結構描述

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

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

輸入結構描述

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

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

輸入結構描述

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

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

輸入結構描述

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

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.

輸入結構描述

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

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

輸入結構描述

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

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

輸入結構描述

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

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

輸入結構描述

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

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.

輸入結構描述

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

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.

輸入結構描述

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

社群

為此伺服器評分

證據

近期觀測

已驗證未記錄版本22 個工具
已驗證未記錄版本22 個工具
已驗證未記錄版本22 個工具
已驗證未記錄版本22 個工具