Organizations

CLI Commands

madtea org activity

Get organization activity feed

madtea org avatar delete

Delete an organization’s avatar

madtea org avatar upload

Upload an organization avatar

madtea org blocks add

Block a user

madtea org blocks check

Check if a user is blocked

madtea org blocks list

List blocked users

madtea org blocks remove

Unblock a user

madtea org create

Create a new organization

madtea org edit

Edit organization settings

madtea org get

Get organization details

madtea org hooks create

Create an organization webhook

madtea org hooks delete

Delete an organization webhook

madtea org hooks edit

Edit an organization webhook

madtea org hooks get

Get an organization webhook

madtea org hooks list

List organization webhooks

madtea org list

List your organizations

madtea org members

List organization members

madtea org members remove

Remove a member from an organization

madtea org permissions

Check a user’s org permissions

madtea org public-members add

Publicize membership

madtea org public-members check

Check if a user is a public member

madtea org public-members list

List public members

madtea org public-members remove

Conceal membership

madtea org rename

Rename an organization

madtea org repos

List organization repositories

madtea org runners delete

Delete an organization runner

madtea org runners get

Get an organization runner

madtea org runners jobs

List organization runner jobs

madtea org runners list

List organization runners

madtea org runners token

Get a runner registration token

madtea org secrets delete

Delete an organization secret

madtea org secrets list

List organization secrets

madtea org secrets set

Set an organization secret

madtea org teams

List organization teams

madtea org teams activity

Get team activity feed

madtea org teams create

Create a team in an organization

madtea org teams delete

Delete a team

madtea org teams edit

Edit a team

madtea org teams get

Get team details

madtea org teams member-add

Add a member to a team

madtea org teams member-check

Check if a user is a team member

madtea org teams member-remove

Remove a member from a team

madtea org teams members

List team members

madtea org teams repo-add

Add a repo to a team

madtea org teams repo-check

Check if a repo is in a team

madtea org teams repo-remove

Remove a repo from a team

madtea org teams repos

List team repos

madtea org teams search

Search teams in an organization

madtea org variables create

Create an organization variable

madtea org variables delete

Delete an organization variable

madtea org variables get

Get an organization variable

madtea org variables list

List organization variables

madtea org variables set

Set (update) an organization variable

madtea org-labels create

Create organization label

madtea org-labels delete

Delete organization label

madtea org-labels get

Get organization label details

madtea org-labels list

List organization labels

madtea org-labels update

Update organization label

MCP Tools

madt_orgs

Manage organizations (requires madt_enable(domains=[“orgs”])): CRUD, members, public members, blocks, hooks, secrets, variables, runners, teams, labels, avatar, activity, permissions.

Output schema: declared

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

action="activity"

Get an organization’s activity feed.

Required: org

action="avatar_delete"

Delete an organization avatar.

Required: org

action="avatar_upload"

Upload an organization avatar.

Required: org, file

action="blocks_add"

Block a user from an organization.

Required: org, username

action="blocks_check"

Check whether a user is blocked from an organization. Returns a text verdict only — the API returns a bare status, not a JSON body, so raw_json has no effect on either path.

Required: org, username

action="blocks_list"

List users blocked from an organization.

Required: org

action="blocks_remove"

Unblock a user from an organization.

Required: org, username

action="create"

Create a new organization.

Required: name

Optional: description, visibility, full_name, location, website, repo_admin_change_team_access

action="edit"

Edit an organization’s settings. Pass only the fields you want to update; empty-string values are ignored — fields cannot be cleared via edit (use madt_api_call PATCH /orgs/{org} with an explicit empty string to clear).

Required: org

Optional: full_name, description, location, website, visibility

action="get"

Get organization details. Formatted output omits visibility and full_name — use raw_json:true to see all fields.

Required: org

action="hooks_create"

Create an organization webhook. config (with url and content_type) is required by the API. active defaults to false — pass active=true or the hook will never fire.

Required: org, type, config

Optional: events, active

action="hooks_delete"

Delete an organization webhook.

Required: org, id

action="hooks_edit"

Edit an organization webhook. Pass fields to update as data (config, events, active).

Required: org, id, data

action="hooks_get"

Get an organization webhook by ID.

Required: org, id

action="hooks_list"

List organization webhooks.

Required: org

action="labels_create"

Create an organization-level label.

Required: org, name

Optional: color, description, exclusive, is_archived

action="labels_delete"

Delete an organization-level label.

Required: org, id

action="labels_get"

Get organization label details.

Required: org, id

action="labels_list"

List organization-level labels.

Required: org

Optional: limit, page

action="labels_update"

Update an organization-level label.

Required: org, id, data

action="list"

List organizations the authenticated user belongs to.

Optional: limit, page

action="members_list"

List organization members. To ADD a member, use teams_member_add — Gitea has no direct add-to-org endpoint; membership is established via team membership.

Required: org

Optional: limit, page

action="members_remove"

Remove a user from an organization.

Required: org, username

action="permissions"

Check a user’s permissions within an organization.

Required: org, username

action="public_members_add"

Publicize a user’s EXISTING membership in an organization (does not add a non-member; use teams_member_add to add a user to the org).

Required: org, username

action="public_members_check"

Check whether a user is a public member of an organization. Returns a text verdict only — the API returns a bare status, not a JSON body, so raw_json has no effect on either path.

Required: org, username

action="public_members_list"

List public members of an organization.

Required: org

action="public_members_remove"

Conceal a user’s membership in an organization.

Required: org, username

action="rename"

Rename an organization.

Required: org, new_name

action="repos"

List repositories belonging to an organization.

Required: org

Optional: limit, page

action="runners_delete"

Delete an organization runner.

Required: org, runner_id

action="runners_get"

Get an organization runner by ID.

Required: org, runner_id

action="runners_jobs"

List jobs for organization runners.

Required: org

action="runners_list"

List organization runners.

Required: org

action="runners_token"

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

Required: org

action="secrets_delete"

Delete an organization secret.

Required: org, name

action="secrets_list"

List organization secrets.

Required: org

action="secrets_set"

Set an organization secret.

Required: org, name, value

action="teams_create"

Create a team within an organization.

Required: org, name, permission

Optional: units, description, includes_all_repositories, can_create_org_repo

action="teams_delete"

Delete a team.

Required: team_id

action="teams_edit"

Edit a team’s settings. Pass fields as json_fields (JSON object). The API requires “name” in the body even when unchanged — fetch the current name with teams_get first. Fields: name, description, permission, units, includes_all_repositories, can_create_org_repo.

Required: team_id, json_fields

action="teams_get"

Get team details by team ID.

Required: team_id

action="teams_list"

List teams within an organization. Formatted output omits team IDs — use teams_search or raw_json:true to get the team_id needed by teams_get/teams_edit/teams_member_*.

Required: org

Optional: limit, page

action="teams_member_add"

Add a member to a team. This is also how you add a user to an organization (Gitea has no direct add-to-org endpoint).

Required: team_id, username

action="teams_member_check"

Check whether a user is a member of a team. Returns a text verdict; raw_json applies only when the user is a member (the not-a-member path is always prose).

Required: team_id, username

action="teams_member_remove"

Remove a member from a team.

Required: team_id, username

action="teams_members"

List members of a team.

Required: team_id

action="teams_repo_add"

Add a repo to a team.

Required: team_id, org, repo

action="teams_repo_check"

Check whether a repo is assigned to a team. Returns a text verdict; raw_json applies only when the repo is assigned (the not-assigned path is always prose).

Required: team_id, org, repo

action="teams_repo_remove"

Remove a repo from a team.

Required: team_id, org, repo

action="teams_repos"

List repos assigned to a team.

Required: team_id

action="teams_search"

Search teams in an organization.

Required: org

Optional: q, limit, page

action="variables_create"

Create an organization variable.

Required: org, name, value

action="variables_delete"

Delete an organization variable.

Required: org, name

action="variables_get"

Get an organization variable by name.

Required: org, name

action="variables_list"

List organization variables.

Required: org

action="variables_set"

Set (update) an organization variable.

Required: org, name, value