# Trigger.dev MCP by usefulapi

> Trigger.dev MCP by usefulapi is a freemium MCP server for developer tools. Hosted MCP server to debug Trigger.dev background jobs from Claude, ChatGPT or Cursor. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web, vscode
- **Website:** https://usefulapi.io/trigger-dev/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/trigger-dev
- **MCP Registry name:** io.usefulapi/trigger-dev
- **Categories:** developer tools
- **Listing updated:** 2026-11-18

## About

The Trigger.dev connector from usefulapi lets an AI assistant read run history, execution traces, queues and cron schedules from a Trigger.dev project. Instead of clicking through the dashboard, you can ask which runs failed in the last day, then open the trace to see which span broke.

The server is hosted at a remote Streamable HTTP endpoint, so there is nothing to install locally. Sign-in is done through OAuth, and the login page asks for a Trigger.dev secret key that the server then uses to call the Trigger.dev API on your behalf. It exposes 26 tools: 15 read-only calls and 7 that change data, such as cancelling or replaying a run, pausing a schedule or a queue, and adding tags. The README and product page say that write tools are meant to be confirmed by the client before they run.

It suits developers and operators who run scheduled or background tasks on Trigger.dev and want an assistant to help triage failures. The product page notes it is an independent service, not an official Trigger.dev product.

## Features

- **Failed run inspection:** Lists runs filtered by status, task, tag, queue or time window and opens individual runs to read their output and errors.
- **Execution trace reading:** Fetches a run's full trace with spans, timings and lifecycle events such as queued, retried and completed.
- **Queue backlog checks:** Shows queues with their concurrency limits, running counts and queued counts.
- **Schedule management:** Reviews cron schedules, their timezones and next run times, and can activate or deactivate them.
- **Run replay and cancel:** Cancels in-flight runs, replays past runs with the same payload, and reschedules delayed runs.
- **Hosted OAuth connection:** Connects from Claude, ChatGPT, Cursor, VS Code and Codex by URL alone, with login handled by the server.

## Good for

- Find which background task runs failed in the past 24 hours and read their errors
- Trace where a slow or failed run spent its time across spans
- Check whether queues are backing up before work piles up
- Pause a misbehaving cron schedule while investigating
- Replay a past run after a fix has been deployed

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "trigger-dev": {
      "type": "http",
      "url": "https://trigger-dev.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "trigger-dev": {
      "serverUrl": "https://trigger-dev.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `trigger_list_runs`: List task runs, filtered by status, task, tag, queue, schedule or a time window.
- `trigger_get_run`: Fetch a single run's outcome, including status, output, error and attempts.
- `trigger_get_run_trace`: Fetch the full execution trace of a run, with every span, timings and nesting.
- `trigger_get_run_span`: Fetch a single span from a run's trace, with its logs and attributes.
- `trigger_list_run_events`: List the lifecycle events of one run.
- `trigger_get_run_metadata`: Fetch the mutable metadata a run has written about itself.
- `trigger_get_batch_results`: Fetch the outcome of every run in a batch.
- `trigger_list_schedules`: List the cron schedules configured for tasks, with their next run times.
- `trigger_get_schedule`: Fetch a single schedule with its cron expression, timezone and active state.
- `trigger_list_queues`: List task queues with their concurrency limits and current depth.
- `trigger_get_queue`: Fetch a single queue's concurrency limit, running count and queued count.
- `trigger_get_current_deployment`: Fetch the deployment currently serving the key's environment.
- `trigger_list_env_vars`: List environment variables configured for a project environment, read-only.
- `trigger_list_waitpoint_tokens`: List outstanding waitpoint tokens for runs paused waiting on a signal.
- `trigger_list_bulk_actions`: List bulk replay and cancel operations and their progress.
- `trigger_cancel_run`: Cancel an in-flight run.
- `trigger_replay_run`: Re-run one specific past run with the same payload.
- `trigger_reschedule_run`: Change when a delayed run will execute.
- `trigger_add_run_tags`: Attach tags to a run so it can be filtered later.
- `trigger_activate_schedule`: Resume a paused schedule so it fires again.
- `trigger_deactivate_schedule`: Pause a schedule so it stops firing.
- `trigger_pause_queue`: Pause a queue so its runs stop being dequeued, or resume it.
- `trigger_dev_usage_status`: Report the caller's current usage and plan limits.
- `trigger_dev_request_feature`: Send a request to usefulapi for a capability the Trigger.dev tools lack.
- `trigger_dev_upgrade`: Get a paid Pro or Pro+ plan for the Trigger.dev server.
- `trigger_dev_cancel_subscription`: Cancel the Pro subscription at the end of the paid period.

## FAQ

### Is this an official Trigger.dev product?

No. usefulapi is an independent service and is not affiliated with or endorsed by Trigger.dev.

### What do I need to connect?

The login page asks for your Trigger.dev secret key, which you copy from your project's API keys page.

### Can the AI change my Trigger.dev data?

Yes, if you approve it. 7 of the 26 tools can create or change data; the other 15 are read-only.

### What does it cost?

The Free plan allows 50 tool calls per month. Pro is $9/mo or $90/yr for 10,000 calls, and Pro+ is $39/mo or $390/yr for 100,000 calls.

### Is Trigger.dev MCP by usefulapi free?

Trigger.dev MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Trigger.dev MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http trigger-dev https://trigger-dev.usefulapi.io/mcp

### What are the best alternatives to Trigger.dev MCP by usefulapi?

The closest alternatives to Trigger.dev MCP by usefulapi are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/trigger-dev-mcp-by-usefulapi
