---

name: composio-ci-runs description: Use when Codex needs to run CI/CD or cross-service automations through the Composio MCP server.

Composio CI Runs

Purpose

Drive multi-service workflows (deploy previews, QA notifications, release toggles) using the Composio-hosted MCP server defined under servers/composio.

Setup Checklist

1. Export COMPOSIO_ENDPOINT + COMPOSIO_API_KEY and update mcp.json with the websocket transport.
2. Map pipelines (e.g., deploy-preview, promote-prod) inside the Composio dashboard and document their inputs in servers/composio/README.md.
3. Confirm each connector account (GitHub, Slack, Vercel, etc.) has least-privilege scopes before triggering live runs.

Workflow

1. Plan – outline prerequisites (tests pass, approvals granted) and choose the pipeline or action ID to invoke.
2. Trigger – call runPipeline/invokeAction with structured payloads and include an idempotency key when rerunning.
3. Monitor – poll getRun for status; fetch logs when state is failed or warning and summarize them.
4. Close out – after success, post a short confirmation back to the requester; if failure repeats after one retry, halt and request human review.

Notes

• Record every automation invocation in the related pull request or issue so humans can audit history.
• Keep secrets out of payloads—Composio resolves connector credentials internally.
• This skill often pairs with github-operations (to prep PRs) and playwright-automation (for smoke tests); coordinate order explicitly in the plan.