How to Use the Trigger.dev (Background Tasks & Jobs) MCP in Windsurf

Q: How do I search for background tasks using Trigger.dev (Background Tasks & Jobs) and Windsurf?

You can list all active job schedules with listschedules. If you're troubleshooting, use listruns to see recent executions in that environment.

Q: What happens if a job needs correction? How does Trigger.dev (Background Tasks & Jobs) and Windsurf handle that?

The agent can re-run previous jobs using replayrun. Plus, you can update the context of a failed run with updaterunmetadata before trying again.

Q: What is the best way to set up scheduled jobs using Trigger.dev (Background Tasks & Jobs) and Windsurf?

Start by calling createschedule with your desired cron pattern. If you want to test it immediately, use triggertask. This ensures the setup works before the automatic schedule kicks in.

Manage complex background jobs and tasks autonomously with Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Trigger.dev (Background Tasks & Jobs) MCP to Windsurf

Create your Vinkius account to connect Trigger.dev (Background Tasks & Jobs) to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Trigger.dev (Background Tasks & Jobs) with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Task Triggers

You can kick off scheduled or immediate jobs using `trigger_task` or run multiple jobs at once via `batch_trigger_tasks`. Cascade handles the whole sequence, so you just tell it what needs to happen. This lets Windsurf set up complex workflows. For example, if a dashboard fails, your agent can automatically use `get_run` to grab the error details and then notify Slack.

Configure Environment Settings

Need to change how an application runs? Use `create_env_var` or `update_env_var`. The agent can manage these variables before any job starts. It's perfect for setting up differing environments without manual file edits. Don't forget cleanup. You can delete settings when they aren't needed with `delete_env_var`, keeping your project clean and the MCP Server config accurate.

Manage Schedules and Batches

Set up recurring tasks using `create_schedule` to build an IMPERATIVE cron job. The agent handles scheduling logic, giving you reliable background execution. If a large job fails, it's no fun waiting for results. You can trigger a batch with `create_batch` and then use `get_batch_results` later to check what actually happened.

Setup guide

Set up Trigger.dev (Background Tasks & Jobs) MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Trigger.dev (Background Tasks & Jobs) MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Trigger.dev (Background Tasks & Jobs) payment history." If connected, Cascade will call the Trigger.dev (Background Tasks & Jobs) tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "triggerdev-background-tasks-jobs-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Trigger.dev. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Trigger.dev (Background Tasks & Jobs) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Trigger.dev (Background Tasks & Jobs) MCP in Windsurf

You can list all active job schedules with `list_schedules`. If you're troubleshooting, use `list_runs` to see recent executions in that environment.

This MCP Server manages the state of your environment variables. You control this data type using `create_env_var` or removing it with `delete_env_var`. Always verify who has access to those secrets.

The agent can re-run previous jobs using `replay_run`. Plus, you can update the context of a failed run with `update_run_metadata` before trying again.

You can check the status of specific jobs by getting a single run's details with `get_run`. This gives you granular information about what happened during that specific execution.

Start by calling `create_schedule` with your desired cron pattern. If you want to test it immediately, use `trigger_task`. This ensures the setup works before the automatic schedule kicks in.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript