CI/CD & Actions

CLI Commands

madtea actions artifacts delete

Delete an artifact

madtea actions artifacts download

Download an artifact zip

madtea actions artifacts get

Get artifact details

madtea actions artifacts list

List repository artifacts

madtea actions dispatch

Trigger a workflow dispatch

madtea actions job

Get job details by ID

madtea actions job-logs

Get job logs by ID

madtea actions jobs

List jobs in a workflow run

madtea actions rerun

Rerun a workflow

madtea actions rerun-job

Rerun a single job

madtea actions run-artifacts

List artifacts produced by a workflow run

madtea actions run-delete

Delete a workflow run

madtea actions runners delete

Delete a runner

madtea actions runners get

Get runner details

madtea actions runners jobs

List runner jobs

madtea actions runners list

List runners

madtea actions runners token

Get runner registration token

madtea actions runs get

Get workflow run details

madtea actions runs list

List workflow runs

madtea actions runs watch

Watch a workflow run until it completes

madtea actions secrets delete

Delete repository secret

madtea actions secrets list

List repository secrets

madtea actions secrets set

Set repository secret

madtea actions tasks

List action tasks

madtea actions variables delete

Delete repository variable

madtea actions variables list

List repository variables

madtea actions variables set

Set repository variable

madtea actions workflows disable

Disable a workflow

madtea actions workflows enable

Enable a workflow

madtea actions workflows get

Get workflow details

madtea actions workflows list

List workflows

MCP Tools

madt_actions

Forgejo/Gitea Actions (CI/CD): workflows, runs, jobs, logs, runners, artifacts, dispatch, and tasks. On Forgejo only runs, run_watch, dispatch, runners, secrets, variables, and tasks are available — the workflows, jobs/logs, rerun, artifacts, and run_delete families are Gitea-only (see docs/COMPAT.md).

Output schema: declared

One tool, action-dispatched. Set action to one of:

action="artifacts_delete"

Delete an artifact.

Required: artifact_id

action="artifacts_download"

Download an artifact zip inline as base64 — small artifacts only (check Size via artifacts_get first). For large ones use the CLI: madtea actions artifacts download –output .

Required: artifact_id

action="artifacts_get"

Get artifact details by ID.

Required: artifact_id

action="artifacts_list"

List repository artifacts.

Optional: limit, page

action="dispatch"

Trigger a workflow_dispatch event for a workflow. The workflow must declare an on: workflow_dispatch trigger; ref (branch or tag, e.g. main) is required by the server.

Required: workflow

Optional: ref, inputs

action="job_get"

Get job details by job ID.

Required: job_id

action="job_logs"

Get job logs by job ID.

Required: job_id

action="jobs"

List jobs in a workflow run.

Required: run_id

action="rerun"

Rerun an entire workflow run.

Required: run_id

action="rerun_job"

Rerun a single job in a workflow run.

Required: run_id, job_id

action="run_artifacts"

List artifacts for a workflow run.

Required: run_id

action="run_delete"

Delete a completed workflow run (in-progress/queued runs are rejected with 400; cancelling a run is web-UI only). Gitea only — Forgejo returns 405.

Required: run_id

action="run_get"

Get a workflow run by API id (not the web UI run number).

Required: run_id

action="run_watch"

Poll a workflow run until it completes (success/failure/cancelled/skipped) or a timeout is reached.

Required: run_id

Optional: interval_seconds, timeout_seconds

action="runners"

List runners. Repository-scoped by default; pass org to list an organization’s runners (/orgs/{org}/actions/runners) without enabling the orgs domain.

Optional: org

action="runners_delete"

Delete a runner. Pass org to delete an organization runner.

Required: runner_id

Optional: org

action="runners_get"

Get runner details by ID. Pass org to target an organization runner.

Required: runner_id

Optional: org

action="runners_jobs"

List jobs currently assigned to runners. Pass org to list an organization’s runner jobs.

Optional: org

action="runners_token"

Get a runner registration token. Response contains a credential - treat as secret. Pass org to get an organization runner token.

Optional: org

action="runs"

List workflow runs. Filter by workflow FILENAME (the workflow field; workflow_id is NOT accepted and is silently ignored) and status. event_payload is stripped from output by default; pass include_payload=true to include it.

Optional: workflow, status, limit, page, include_payload

action="secrets_delete"

Delete a repository secret.

Required: name

action="secrets_list"

List repository secrets (names and creation dates only — secret values are write-only and can never be read back, with or without raw_json).

action="secrets_set"

Set a repository secret (creates or updates).

Required: name, value

action="tasks"

List action tasks — job-level executions across ALL runs (no run_id needed). Use jobs for one run’s jobs, runners_jobs for jobs assigned to runners. event_payload is stripped from output by default; pass include_payload=true to include it.

Optional: limit, page, include_payload

action="variables_delete"

Delete a repository variable.

Required: name

action="variables_list"

List repository variables.

action="variables_set"

Set a repository variable (creates or updates).

Required: name, value

action="workflow_disable"

Disable a workflow.

One of: workflow | workflow_id

action="workflow_enable"

Enable a workflow.

One of: workflow | workflow_id

action="workflow_get"

Get workflow details by ID or filename.

One of: workflow | workflow_id

action="workflows"

List repository workflows.

Optional: limit, page