Users

CLI Commands

madtea gpg-key add

Add a GPG key

madtea gpg-key delete

Delete a GPG key

madtea gpg-key list

List GPG keys

madtea user activity

Get user activity feed

madtea user avatar delete

Delete avatar

madtea user avatar upload

Upload avatar image

madtea user blocks add

Block a user

madtea user blocks check

Check if a user is blocked

madtea user blocks list

List blocked users

madtea user blocks remove

Unblock a user

madtea user emails add

Add email addresses

madtea user emails delete

Delete email addresses

madtea user emails list

List email addresses

madtea user follow

Follow a user

madtea user followers

List followers of the authenticated user

madtea user followers-of

List followers of a user

madtea user following check

Check if following a user

madtea user following list

List following (default)

madtea user following-of

List users a user is following

madtea user get

Get user by username

madtea user gpg-keys add

Add a GPG key

madtea user gpg-keys delete

Delete a GPG key

madtea user gpg-keys get

Get GPG key details

madtea user gpg-keys list

List GPG keys

madtea user gpg-keys token

Get GPG key verification token

madtea user gpg-keys verify

Verify GPG key ownership

madtea user gpg-keys-of

List GPG keys for a user

madtea user heatmap

Get activity heatmap for a user

madtea user hooks create

Create a user webhook

madtea user hooks delete

Delete a user webhook

madtea user hooks edit

Update a user webhook

madtea user hooks get

Get user webhook details

madtea user hooks list

List user webhooks

madtea user jobs list

List workflow jobs

madtea user keys

SSH key operations

madtea user keys add

Add an SSH key

madtea user keys delete

Delete an SSH key

madtea user keys list

List SSH keys

madtea user keys-of

List user’s public SSH keys

madtea user me

Get authenticated user info

madtea user oauth2 create

Create an OAuth2 application

madtea user oauth2 delete

Delete an OAuth2 application

madtea user oauth2 get

Get OAuth2 application details

madtea user oauth2 list

List OAuth2 applications

madtea user oauth2 update

Update an OAuth2 application

madtea user quota

Quota usage (Forgejo only)

madtea user quota artifacts

Artifact quota usage (Forgejo only)

madtea user quota attachments

Attachment quota usage (Forgejo only)

madtea user quota packages

Package quota usage (Forgejo only)

madtea user repos-of

List user’s public repositories

madtea user runners delete

Delete a user runner

madtea user runners get

Get runner details

madtea user runners list

List user runners

madtea user runners token

Get runner registration token

madtea user runs list

List workflow runs

madtea user search

Search users

madtea user secrets delete

Delete a user secret

madtea user secrets set

Set a user secret

madtea user settings

Get user settings

madtea user settings-update

Update user settings

madtea user star

Star a repository

madtea user starred check

Check if a repo is starred

madtea user starred list

List starred repos (default)

madtea user starred-by

List repos starred by a user

madtea user stopwatches

List active stopwatches

madtea user subscriptions

List watched repos

madtea user subscriptions-of

List repos watched by a user

madtea user teams

List current user’s teams

madtea user times

List tracked time for the current user

madtea user tokens create

Create an access token

madtea user tokens delete

Delete an access token

madtea user tokens list

List access tokens

madtea user unfollow

Unfollow a user

madtea user unstar

Unstar a repository

madtea user variables create

Create a user variable

madtea user variables delete

Delete a user variable

madtea user variables get

Get a user variable

madtea user variables list

List user variables

madtea user variables set

Create or update a user variable

MCP Tools

madt_users

Manage authenticated user profile and settings, and look up other users (get/search, their repos, activity, heatmap, SSH/GPG keys, followers, starred/watched repos) (requires madt_enable(domains=[“users”])): emails, avatar, blocks, social, GPG keys, OAuth2 apps, tokens, user-level Actions (secrets/variables/runners/runs/jobs/hooks), quota, time tracking.

Output schema: declared

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

action="activity"

Get user activity feed.

Required: username

action="avatar_delete"

Delete the avatar for the authenticated user.

action="avatar_upload"

Upload an avatar image for the authenticated user.

Required: file

action="blocks_add"

Block a user.

Required: username

action="blocks_check"

Check whether a user is blocked by the authenticated user.

Required: username

action="blocks_list"

List blocked users for the authenticated user.

action="blocks_remove"

Unblock a user.

Required: username

action="emails_add"

Add email addresses to the authenticated user.

Required: emails

action="emails_delete"

Remove email addresses from the authenticated user.

Required: emails

action="emails_list"

List email addresses for the authenticated user.

action="follow"

Follow a user.

Required: username

action="followers"

List followers of the authenticated user.

Optional: limit, page

action="followers_of"

List followers of a specific user.

Required: username

Optional: limit, page

action="following"

List users the authenticated user is following.

Optional: limit, page

action="following_check"

Check whether the authenticated user is following a user.

Required: username

action="following_of"

List users a specific user is following.

Required: username

Optional: limit, page

action="get"

Get a user by username.

Required: username

action="gpg_keys_add"

Add a GPG key for the authenticated user.

Required: armored_public_key

action="gpg_keys_delete"

Delete a GPG key by ID.

Required: id

action="gpg_keys_get"

Get GPG key details by ID.

Required: id

action="gpg_keys_list"

List GPG keys for the authenticated user.

action="gpg_keys_of"

List GPG keys for a specific user.

Required: username

action="gpg_keys_token"

Get a GPG key verification token for the authenticated user. Clearsign this token and submit the signature via gpg_key_verify to prove key ownership.

action="gpg_keys_verify"

Verify GPG key ownership. NOTE: this action cannot yet pass the required key_id/armored_signature — use madt_api_call POST /user/gpg_key_verify with {“key_id”, “armored_signature”} (clearsign the token from gpg_keys_token).

action="heatmap"

Get activity heatmap for a user.

Required: username

action="hooks_create"

Create a user-level webhook. Defaults: active=false (the hook will NOT fire until created/edited with active:true) and events=[push] — set both explicitly.

Required: type, config

Optional: events, active

action="hooks_delete"

Delete a user-level webhook.

Required: id

action="hooks_edit"

Update a user-level webhook. Pass fields as json_fields.

Required: id, json_fields

action="hooks_get"

Get a user-level webhook by ID.

Required: id

action="hooks_list"

List user-level webhooks.

action="jobs"

List user-level workflow jobs.

Optional: limit, page

action="keys_add"

Add an SSH key for the authenticated user.

Required: title, key

action="keys_delete"

Delete an SSH key by ID.

Required: id

action="keys_list"

List SSH keys for the authenticated user.

action="keys_of"

List a user’s public SSH keys.

Required: username

action="me"

Get the authenticated user.

action="oauth2_create"

Create an OAuth2 application.

Required: name, redirect_uris

Optional: confidential_client

action="oauth2_delete"

Delete an OAuth2 application.

Required: id

action="oauth2_get"

Get OAuth2 application details by ID.

Required: id

action="oauth2_list"

List OAuth2 applications for the authenticated user.

action="oauth2_update"

Update an OAuth2 application. Pass fields as json_fields.

Required: id, json_fields

action="quota"

Get quota usage for the authenticated user (Forgejo only).

action="quota_artifacts"

List artifact quota usage for the authenticated user (Forgejo only).

action="quota_attachments"

List attachment quota usage for the authenticated user (Forgejo only).

action="quota_packages"

List package quota usage for the authenticated user (Forgejo only).

action="repos_of"

List a user’s public repositories.

Required: username

Optional: limit, page

action="runners_delete"

Delete a user-level runner.

Required: runner_id

action="runners_get"

Get a user-level runner by ID.

Required: runner_id

action="runners_list"

List user-level runners.

action="runners_token"

Get a registration token for user-level runners. Response contains a credential — treat as secret.

action="runs"

List user-level workflow runs.

Optional: limit, page

action="search"

Search users by username/full-name/email substring. Same endpoint as madt_search action=users — use that ungated tool if the users domain is not already enabled.

Required: query

Optional: limit, page

action="secrets_delete"

Delete a user-level secret.

Required: name

action="secrets_set"

Set a user-level secret.

Required: name, value

action="settings_get"

Get current user settings. Formatted output shows common fields only; use raw_json:true to see all fields and the valid field names for settings_update json_fields.

action="settings_update"

Update current user settings. Pass a JSON object with fields to update. Formatted output shows common fields only; use raw_json:true to see all fields and the valid json_fields names.

Required: json_fields

action="star"

Star a repository.

Required: owner, repo

action="starred"

List repositories starred by the authenticated user.

Optional: sort, order, limit, page

action="starred_by"

List repositories starred by a specific user.

Required: username

Optional: sort, order, limit, page

action="starred_check"

Check whether the authenticated user has starred a repository.

Required: owner, repo

action="stopwatches"

List active stopwatches for the authenticated user.

action="subscriptions"

List repositories watched by the authenticated user.

Optional: sort, order, limit, page

action="subscriptions_of"

List repositories watched by a specific user.

Required: username

Optional: sort, order, limit, page

action="teams"

List teams for the authenticated user.

action="times_list"

List all tracked time for the authenticated user.

Optional: limit, page

action="tokens_create"

Create an access token for a user. The token value is returned only in this response and cannot be retrieved later (tokens_list omits it) — capture it immediately and treat as secret. NOTE: requires basic auth (username/password) — fails with 401 under normal API-token auth.

Required: username, name

Optional: scopes

action="tokens_delete"

Delete an access token. NOTE: the Gitea token endpoints require basic auth (username/password) — fails with 401 under normal API-token auth.

Required: username, token_id

action="tokens_list"

List access tokens for a user. NOTE: the Gitea token endpoints require basic auth (username/password) — fails with 401 under normal API-token auth.

Required: username

action="unfollow"

Unfollow a user.

Required: username

action="unstar"

Unstar a repository.

Required: owner, repo

action="variables_create"

Create a user-level action variable. Fails if it already exists.

Required: name, value

action="variables_delete"

Delete a user-level action variable.

Required: name

action="variables_get"

Get a user-level action variable by name.

Required: name

action="variables_list"

List user-level action variables.

action="variables_set"

Create or update a user-level action variable.

Required: name, value