airtrigger-mcp

MCP server for AirTrigger — trigger and monitor AI agent tasks from any MCP-compatible client (Cursor, Claude Desktop, etc.).

Installation

npx airtrigger-mcp

Or install globally:

npm install -g airtrigger-mcp

Configuration

Set these environment variables:

| Variable | Required | Description | |---|---|---| | AIRTRIGGER_API_KEY | Yes | Your API key (tr_dev_xxx or tr_prod_xxx) | | AIRTRIGGER_PROJECT_REF | Yes | Project reference (proj_xxx) | | AIRTRIGGER_API_URL | No | API base URL (defaults to https://airtrigger.io) |

MCP Client Setup

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "airtrigger": {
      "command": "npx",
      "args": ["-y", "airtrigger-mcp"],
      "env": {
        "AIRTRIGGER_API_KEY": "tr_dev_your_key_here",
        "AIRTRIGGER_PROJECT_REF": "proj_your_ref_here"
      }
    }
  }
}

Cursor

Add to your .cursor/mcp.json:

{
  "mcpServers": {
    "airtrigger": {
      "command": "npx",
      "args": ["-y", "airtrigger-mcp"],
      "env": {
        "AIRTRIGGER_API_KEY": "tr_dev_your_key_here",
        "AIRTRIGGER_PROJECT_REF": "proj_your_ref_here"
      }
    }
  }
}

Tools

| Tool | Description | |---|---| | trigger_task | Fire a task run with a custom payload | | get_run_status | Check if a run completed, failed, or is still running | | list_tasks | List all tasks in the configured project | | get_run_logs | Pull the trace and output of any run | | cancel_run | Cancel a running task |

License

Apache-2.0