Admin

CLI Commands

madtea admin cron list

List cron tasks

madtea admin cron run

Run a cron task

madtea admin emails list

List all emails

madtea admin emails search

Search emails

madtea admin hooks create

Create a system hook

madtea admin hooks delete

Delete a system hook

madtea admin hooks edit

Edit a system hook

madtea admin hooks get

Get system hook details

madtea admin hooks list

List system hooks

madtea admin jobs list

List workflow jobs

madtea admin orgs list

List all organizations

madtea admin runners delete

Delete a runner

madtea admin runners get

Get runner details

madtea admin runners list

List action runners

madtea admin runners token

Get a runner registration token

madtea admin runs list

List workflow runs

madtea admin unadopted adopt

Adopt an unadopted repository

madtea admin unadopted delete

Delete an unadopted repository

madtea admin unadopted list

List unadopted repositories

madtea admin users badges

List user’s badges

madtea admin users badges-add

Add badges to a user

madtea admin users badges-delete

Remove badges from a user

madtea admin users create

Create a user

madtea admin users edit

Edit a user

madtea admin users emails

List user’s email addresses

madtea admin users emails-delete

Delete email from a user

madtea admin users keys-add

Add an SSH key to a user

madtea admin users keys-delete

Delete an SSH key from a user

madtea admin users list

List all users

madtea admin users org-add

Add user to an organization

madtea admin users orgs

List user’s organizations

madtea admin users rename

Rename a user

madtea admin users repos-create

Create a repo for a user

MCP Tools

madt_admin

Server administration (requires madt_enable(domains=[“admin”]); instance-admin token): users, badges, cron, system hooks, orgs, emails, unadopted repos, runners, runs, jobs.

Output schema: declared

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

action="badges_add"

Add badges to a user. Badge slugs must already exist on the instance (badge definitions cannot be created via the API). Gitea only — Forgejo has no badges endpoints.

Required: username, badges

action="badges_delete"

Remove badges from a user. Badge slugs must already exist on the instance (badge definitions cannot be created via the API). Gitea only — Forgejo has no badges endpoints.

Required: username, badges

action="badges_list"

List badges for a user.

Required: username

action="cron_list"

List cron tasks. Shows task names, schedules, and next/previous run times.

action="cron_run"

Run a cron task. Task names come from cron_list.

Required: task

action="emails"

List or search emails. If q is provided, searches; otherwise lists all.

Optional: q, limit, page

action="hooks_create"

Create a system hook. active defaults to false — the hook is created disabled and will not fire until active=true (or enabled via hooks_edit). Use raw_json:true on hooks_get to see the full hook config.

Required: type, config

Optional: events, active

action="hooks_delete"

Delete a system hook.

Required: id

action="hooks_edit"

Edit a system hook. Pass fields to update as json_fields. Formatted output shows url and content_type only; use raw_json:true to see the full hook config.

Required: id, json_fields

action="hooks_get"

Get a system hook by ID. Formatted output shows url and content_type only; use raw_json:true to see the full hook config.

Required: id

action="hooks_list"

List system hooks.

Optional: limit, page

action="jobs"

List all workflow jobs across the instance.

Optional: limit, page

action="orgs"

List all organizations.

Optional: limit, page

action="runners_delete"

Delete a runner.

Required: runner_id

action="runners_get"

Get runner details.

Required: runner_id

action="runners_list"

List action runners.

action="runners_token"

Get a runner registration token. Response contains a credential — treat as secret.

action="runs"

List all workflow runs across the instance.

Optional: limit, page

action="unadopted_adopt"

Adopt an unadopted repository.

Required: owner, repo

action="unadopted_delete"

Delete an unadopted repository.

Required: owner, repo

action="unadopted_list"

List unadopted repositories.

Optional: limit, page

action="users_create"

Create a new user.

Required: username, email, password

Optional: must_change_password

action="users_edit"

Edit a user. Pass fields to update as json_fields. The API requires login_name and source_id in every edit even when unchanged — copy them from users_list raw_json:true output (the formatted list omits them).

Required: username, json_fields

action="users_emails"

List a user’s email addresses.

Required: username

action="users_emails_delete"

Delete an email address from a user.

Required: username, email

action="users_keys_add"

Add an SSH public key to a user.

Required: username, title, key

action="users_keys_delete"

Delete an SSH public key from a user.

Required: username, key_id

action="users_list"

List all users.

Optional: limit, page

action="users_org_add"

To add a user to an organization, use madt_orgs action=teams_member_add (org membership is team membership; there is no direct add-user-to-org API).

Required: username, org

action="users_orgs"

List a user’s organizations.

Required: username

action="users_rename"

Rename a user.

Required: username, new_name

action="users_repos_create"

Create a repository owned by the user. Pass repo options as json_fields.

Required: username, json_fields