Skip to main content
Glama
Gerrit OpenAPI MCP

Gerrit OpenAPI MCP

by davido

Gerrit OpenAPI → FastMCP

Directly consumes the local Gerrit OpenAPI document. No Gerrit Python SDK and no handwritten endpoint wrappers. Uses the existing FastMCP OpenAPI bridge.

Gerrit extraction → core/openapi.json → pinned profile → FastMCP → MCP tools

Runs on FastMCP 4.2 and Python 3.12+.

Generated artifacts

Profile

Tools

Selection

full

339

Every operation in the pinned core document

read_only

161

Cataloged GET operations; default when serving

agent

162

Same reads plus one constrained revision review

Two plugins are also supported, each with its own source hash and operation catalog: checks (--api checks: 9 / 4 / 4 tools) and code-owners (--api code-owners: 13 / 9 / 9). For both, read_only and agent expose only reads. Plugin writes require the explicit full profile.

The agent profile removes every POST/PUT/DELETE except one revision review. Its review schema permits message, comments, drafts, is_ai, and a labels object bounded to Code-Review ∈ {−1, 0, +1}. It has no on_behalf_of, ready, reviewers, or other controls.

gerrit_openapi_mcp/catalog.json pins explicit method/path/profile decisions and a source hash. A changed spec (new operation or request field) stops generation until the catalog is reviewed.

Related MCP server: Gerrit MCP Server

Run locally

With the sibling ../gerrit-openapi checkout present:

uv sync --python 3.12   # one-time
./update.sh             # regenerate core + plugins, then run the tests

update.sh regenerates every API over a mock transport (no Gerrit requests) and runs the suite. --refresh git-pulls the sibling spec first. A changed spec stops generation until its catalog is reviewed.

Serve

# Core plus every plugin in one server (recommended):
uv run gerrit-openapi-mcp serve-all --base-url https://gerrit.example.com/a/

# A single API:
uv run gerrit-openapi-mcp serve --base-url https://gerrit.example.com/a/ --profile agent

serve-all mounts core unprefixed and each plugin under its name (checks_, code_owners_). Drop one the site lacks with --checks-profile off. It serves from the committed generated/ specs, so uvx --from git+... is self-contained with no sibling checkout needed, and serves the change-screen and changes-list skills alongside the tools. Credentials come from GERRIT_HTTP_USER / GERRIT_HTTP_PASSWORD or GERRIT_COOKIE (server config, not tool arguments).

Example host config. The committed .mcp.json wires gerrit (read-only), gerrit-agent (the bounded review write), and gerrit-full:

{
  "mcpServers": {
    "gerrit": {
      "command": "uv",
      "args": [
        "run", "--project", "/path/to/gerrit-openapi-mcp",
        "gerrit-openapi-mcp", "serve-all",
        "--base-url", "https://gerrit.example.com/a/"
      ],
      "env": { "GERRIT_COOKIE": "${GERRIT_COOKIE:-}" }
    }
  }
}

Verified

48 tests pass (Ruff + formatting clean): per-profile tool registration, the outgoing guard (origin/path/profile checks, the bounded −1/0/+1 review, ±2 and other writes rejected before any request reaches the wire, no redirect-following, XSSI handling), the drift gate, the mounted serve-all topology, and both served skills. The suite also pins that stock FastMCP 4.2 no longer clamps the nested bound (#6457), so the guard, not the framework, enforces it.

Available Tools

173 tools
checks_getChangesChangeIdRevisionsRevisionIdChecksChecks GetchangeschangeidrevisionsrevisionidchecksC

Retrieves all checks for a given revision and change.

Inputs: change-id (required), revision-id (required).

checks_getChangesChangeIdRevisionsRevisionIdChecksCheckIdChecks GetchangeschangeidrevisionsrevisionidcheckscheckidC

Retrieves a check.

Inputs: check-id (required), change-id (required), revision-id (required), O, +1 more. Returns: object

checks_getPluginsChecksCheckersChecks GetpluginscheckscheckersC

Retrieves all checkers.

Inputs: no named parameters. Returns: result

checks_getPluginsChecksCheckersCheckerIdChecks GetpluginscheckscheckerscheckeridC

Retrieves a checker.

Inputs: checker-id (required). Returns: object

code_owners_getChangesChangeIdCodeOwnersStatusCode Owners GetchangeschangeidcodeownersstatusC

Gets the code owner statuses for the files in a change.

Inputs: change-id (required), limit, start. Returns: object

code_owners_getChangesChangeIdRevisionsRevisionIdCodeOwnersPathIdCode Owners GetchangeschangeidrevisionsrevisionidcodeownerspathidC

Suggests accounts that are code owners of a file in a change revision.

Inputs: path-id (required), change-id (required), revision-id (required), O, +6 more.

code_owners_getChangesChangeIdRevisionsRevisionIdOwnedPathsCode Owners GetchangeschangeidrevisionsrevisionidownedpathsC

Lists the files of the revision that are owned by the specified user (see user request parameter below).

Inputs: change-id (required), revision-id (required), user, limit, +2 more. Returns: object

code_owners_getProjectsProjectIdBranchesBranchIdCodeOwnersBranchConfCode Owners GetprojectsprojectidbranchesbranchidcodeownersbranchconfC

Gets the code owner branch configuration.

Inputs: branch-id (required), project-id (required). Returns: object

code_owners_getProjectsProjectIdBranchesBranchIdCodeOwnersCheckCode Owners GetprojectsprojectidbranchesbranchidcodeownerscheckC

Checks the code ownership of a user for a path in a branch.

Inputs: branch-id (required), project-id (required), path, user, +2 more. Returns: object

code_owners_getProjectsProjectIdBranchesBranchIdCodeOwnersConfigFileCode Owners GetprojectsprojectidbranchesbranchidcodeownersconfigfileC

Lists the code owner config files in a branch.

Inputs: branch-id (required), project-id (required), path, email, +1 more. Returns: result

code_owners_getProjectsProjectIdBranchesBranchIdCodeOwnersConfigPathCode Owners GetprojectsprojectidbranchesbranchidcodeownersconfigpathC

Gets a code owner config for a path in a branch.

Inputs: path-id (required), branch-id (required), project-id (required).

code_owners_getProjectsProjectIdBranchesBranchIdCodeOwnersPathIdCode Owners GetprojectsprojectidbranchesbranchidcodeownerspathidC

Lists the accounts that are code owners of a file or folder in a branch.

Inputs: path-id (required), branch-id (required), project-id (required), O, +7 more.

code_owners_getProjectsProjectIdCodeOwnersProjectConfigCode Owners GetprojectsprojectidcodeownersprojectconfigC

Gets the code owner project configuration.

Inputs: project-id (required). Returns: object

getAccessGetaccessB

Lists the access rights of one or more projects, named by the repeated project parameter.

Inputs: project. Returns: object

getAccountsGetaccountsB

Queries accounts visible to the caller. The query is given by the query parameter; use limit and start to page and o to request extra fields.

Inputs: O, o, limit, query, +2 more. Returns: result

getAccountsAccountIdGetaccountsaccountidC

Returns the details of one account as an AccountInfo entity.

Inputs: account-id (required). Returns: object

getAccountsAccountIdActiveGetaccountsaccountidactiveC

Checks if an account is active.

Inputs: account-id (required).

getAccountsAccountIdAgreementsGetaccountsaccountidagreementsC

Gets a list of the user's signed contributor agreements.

Inputs: account-id (required). Returns: result

getAccountsAccountIdAvatarGetaccountsaccountidavatarC

Retrieves the avatar image of the user.

Inputs: account-id (required), size.

getAccountsAccountIdAvatarChangeUrlGetaccountsaccountidavatarchangeurlC

Retrieves the URL where the user can change the avatar image.

Inputs: account-id (required). Returns: result

getAccountsAccountIdCapabilitiesGetaccountsaccountidcapabilitiesC

Returns the global capabilities that are enabled for the specified user.

Inputs: account-id (required), q. Returns: object

getAccountsAccountIdCapabilitiesCapabilityIdGetaccountsaccountidcapabilitiescapabilityidC

Checks if a user has a certain global capability.

Inputs: account-id (required), capability-id (required). Returns: result

getAccountsAccountIdDetailGetaccountsaccountiddetailC

Retrieves the details of an account as an AccountDetailInfo entity.

Inputs: account-id (required). Returns: object

getAccountsAccountIdEmailsGetaccountsaccountidemailsB

Returns the email addresses that are configured for the specified user.

Inputs: account-id (required). Returns: result

getAccountsAccountIdEmailsEmailIdGetaccountsaccountidemailsemailidC

Retrieves an email address of a user.

Inputs: email-id (required), account-id (required). Returns: object

getAccountsAccountIdExternalIdsGetaccountsaccountidexternalidsC

Retrieves the external ids of a user account.

Inputs: account-id (required). Returns: result

getAccountsAccountIdGpgkeysGetaccountsaccountidgpgkeysC

Returns the GPG keys of an account.

Inputs: account-id (required). Returns: object

getAccountsAccountIdGpgkeysGpgKeyIdGetaccountsaccountidgpgkeysgpgkeyidC

Retrieves a GPG key of a user.

Inputs: account-id (required), gpg-key-id (required). Returns: object

getAccountsAccountIdGroupsGetaccountsaccountidgroupsC

Lists all groups that contain the specified user as a member.

Inputs: account-id (required). Returns: result

getAccountsAccountIdNameGetaccountsaccountidnameB

Retrieves the full name of an account.

Inputs: account-id (required). Returns: result

getAccountsAccountIdPreferencesGetaccountsaccountidpreferencesC

Retrieves the user's preferences.

Inputs: account-id (required). Returns: object

getAccountsAccountIdPreferencesDiffGetaccountsaccountidpreferencesdiffC

Retrieves the diff preferences of a user.

Inputs: account-id (required). Returns: object

getAccountsAccountIdPreferencesEditGetaccountsaccountidpreferenceseditC

Retrieves the edit preferences of a user.

Inputs: account-id (required). Returns: object

getAccountsAccountIdSshkeysGetaccountsaccountidsshkeysC

Returns the SSH keys of an account.

Inputs: account-id (required). Returns: result

getAccountsAccountIdSshkeysSshKeyIdGetaccountsaccountidsshkeyssshkeyidC

Retrieves an SSH key of a user.

Inputs: account-id (required), ssh-key-id (required). Returns: object

getAccountsAccountIdStarredChangesGetaccountsaccountidstarredchangesC

Gets the changes that were starred with the default star by the identified user account.

Inputs: account-id (required). Returns: result

getAccountsAccountIdStateGetaccountsaccountidstateB

Retrieves the superset of all information related to an account. This information is useful to inspect issues with the account and its permissions. The account state is returned as an AccountStateInfo entity.

Inputs: account-id (required). Returns: object

getAccountsAccountIdStatusGetaccountsaccountidstatusC

Retrieves the status of an account.

Inputs: account-id (required). Returns: result

getAccountsAccountIdTokensGetaccountsaccountidtokensB

Lists the token ids of an account as a list of AuthTokenInfos. The plain text token will never be returned.

Inputs: account-id (required). Returns: result

getAccountsAccountIdUsernameGetaccountsaccountidusernameC

Retrieves the username of an account.

Inputs: account-id (required). Returns: result

getAccountsAccountIdWatchedProjectsGetaccountsaccountidwatchedprojectsC

Retrieves all projects a user is watching.

Inputs: account-id (required). Returns: result

getChangesGetchangesC

Queries changes visible to the caller. The query is given by the repeatable query parameter; use limit/start to page and o to request extra fields.

Inputs: O, o, limit, query, +4 more. Returns: result

getChangesChangeIdGetchangeschangeidB

Retrieves a single change as a ChangeInfo entity; request additional data with the o parameter.

Inputs: change-id (required), O, o, meta. Returns: object

getChangesChangeIdAttentionGetchangeschangeidattentionB

Returns all users that are currently in the attention set. As response a list of AttentionSetInfo entity is returned.

Inputs: change-id (required). Returns: result

getChangesChangeIdCheckGetchangeschangeidcheckC

Performs consistency checks on the change, and returns a ChangeInfo entity with the problems field set to a list of ProblemInfo entities.

Inputs: change-id (required). Returns: object

getChangesChangeIdCommentsGetchangeschangeidcommentsB

Lists the published comments of all revisions of a change, grouped by file path.

Inputs: change-id (required), enable-context, context-padding. Returns: object

getChangesChangeIdCustomKeyedValuesGetchangeschangeidcustomkeyedvaluesC

Gets the custom keyed values associated with a change.

Inputs: change-id (required). Returns: object

getChangesChangeIdDetailGetchangeschangeiddetailC

Retrieves a change with labels, detailed labels, detailed accounts, reviewer updates, and messages.

Inputs: change-id (required), O, o.

getChangesChangeIdDraftsGetchangeschangeiddraftsC

Lists the draft comments of all revisions of the change that belong to the calling user.

Inputs: change-id (required), enable-context, context-padding. Returns: object

getChangesChangeIdEditGetchangeschangeideditC

Retrieves the change edit of the calling user, if one exists, as an EditInfo entity.

Inputs: change-id (required), base, list, download-commands.

getChangesChangeIdEditChangeEditIdGetchangeschangeideditchangeeditidC

Retrieves content of a file from a change edit.

Inputs: change-id (required), change-edit-id (required), base.

getChangesChangeIdEditChangeEditIdMetaGetchangeschangeideditchangeeditidmetaB

Retrieves meta data of a file from a change edit. Currently only web links are returned.

Inputs: change-id (required), change-edit-id (required). Returns: object

getChangesChangeIdEditMessageGetchangeschangeideditmessageC

Retrieves commit message from change edit.

Inputs: change-id (required), base. Returns: result

getChangesChangeIdFlowsGetchangeschangeidflowsB

Lists the flows of a change that are visible to the caller.

Inputs: change-id (required). Returns: result

getChangesChangeIdFlowsActionsGetchangeschangeidflowsactionsC

Lists the flows actions that are configured for the given change.

Inputs: change-id (required). Returns: result

getChangesChangeIdFlowsFlowIdGetchangeschangeidflowsflowidC

Gets a flow on the change.

Inputs: flow-id (required), change-id (required). Returns: object

getChangesChangeIdHashtagsGetchangeschangeidhashtagsB

Gets the hashtags associated with a change.

Inputs: change-id (required). Returns: result

getChangesChangeIdInGetchangeschangeidinC

Retrieves the branches and tags in which a change is included. As result an IncludedInInfo entity is returned.

Inputs: change-id (required). Returns: object

getChangesChangeIdIsFlowsEnabledGetchangeschangeidisflowsenabledB

Returns whether flows are enabled for this change.

Inputs: change-id (required). Returns: object

getChangesChangeIdMessageGetchangeschangeidmessageB

Returns the commit message of the change (from the current patch set).

Inputs: change-id (required). Returns: object

getChangesChangeIdMessagesGetchangeschangeidmessagesC

Lists the messages of a change as ChangeMessageInfo entities.

Inputs: change-id (required). Returns: result

getChangesChangeIdMessagesChangeMessageIdGetchangeschangeidmessageschangemessageidD

As response a ChangeMessageInfo entity is returned.

Inputs: change-id (required), change-message-id (required). Returns: object

getChangesChangeIdMetaDiffGetchangeschangeidmetadiffC

Retrieves the difference between two historical states of a change by specifying the old=SHA-1 and the meta=SHA-1 parameters.

Inputs: change-id (required), O, o, old, +1 more. Returns: object

getChangesChangeIdPureRevertGetchangeschangeidpurerevertA

Check if the given change is a pure revert of the change it references in revertOf. Optionally, the query parameter o can be passed in to specify a commit (SHA-1 in 40 digit hex representation) to check against. It takes precedence over revertOf. If the change has no reference in revertOf, the parameter is mandatory.

Inputs: change-id (required), claimed-original. Returns: object

getChangesChangeIdQueryGetchangeschangeidqueryC

Evaluates whether the given change query expression matches the change.

Inputs: change-id (required), use-index, expression. Returns: object

getChangesChangeIdReviewersGetchangeschangeidreviewersC

Lists the reviewers of a change as ReviewerInfo entities.

Inputs: change-id (required). Returns: result

getChangesChangeIdReviewersReviewerIdGetchangeschangeidreviewersrevieweridC

Retrieves a reviewer of a change.

Inputs: change-id (required), reviewer-id (required). Returns: result

getChangesChangeIdReviewersReviewerIdVotesGetchangeschangeidreviewersrevieweridvotesC

Lists the votes for a specific reviewer of the change.

Inputs: change-id (required), reviewer-id (required). Returns: object

getChangesChangeIdRevisionsRevisionIdGetchangeschangeidrevisionsrevisionidC

Retrieves a revision of a change.

Inputs: change-id (required), revision-id (required). Returns: object

getChangesChangeIdRevisionsRevisionIdActionsGetchangeschangeidrevisionsrevisionidactionsC

Retrieves revision actions of the revision of a change.

Inputs: change-id (required), revision-id (required). Returns: object

getChangesChangeIdRevisionsRevisionIdArchiveGetchangeschangeidrevisionsrevisionidarchiveC

Retrieves an archive of the files in a revision.

Inputs: change-id (required), revision-id (required), format. Returns: result

getChangesChangeIdRevisionsRevisionIdCommentsGetchangeschangeidrevisionsrevisionidcommentsC

Lists the published comments of a revision, grouped by file path.

Inputs: change-id (required), revision-id (required). Returns: object

getChangesChangeIdRevisionsRevisionIdCommentsCommentIdGetchangeschangeidrevisionsrevisionidcommentscommentidC

Retrieves a published comment of a revision.

Inputs: change-id (required), comment-id (required), revision-id (required). Returns: object

getChangesChangeIdRevisionsRevisionIdCommitGetchangeschangeidrevisionsrevisionidcommitC

Retrieves the commit of a revision as a CommitInfo entity.

Inputs: change-id (required), revision-id (required), links. Returns: object

getChangesChangeIdRevisionsRevisionIdDescriptionGetchangeschangeidrevisionsrevisioniddescriptionC

Retrieves the description of a patch set.

Inputs: change-id (required), revision-id (required). Returns: result

getChangesChangeIdRevisionsRevisionIdDraftsGetchangeschangeidrevisionsrevisioniddraftsB

Lists the draft comments of the calling user on a revision, grouped by file path.

Inputs: change-id (required), revision-id (required). Returns: object

getChangesChangeIdRevisionsRevisionIdDraftsDraftCommentIGetchangeschangeidrevisionsrevisioniddraftsdraftcommentiB

Retrieves a draft comment of a revision that belongs to the calling user.

Inputs: change-id (required), revision-id (required), draft-comment-id (required). Returns: object

getChangesChangeIdRevisionsRevisionIdFilesGetchangeschangeidrevisionsrevisionidfilesC

Lists the files that were added, modified, or deleted in a revision.

Inputs: change-id (required), revision-id (required), q, base, +2 more. Returns: object

getChangesChangeIdRevisionsRevisionIdFilesFileIdBlameGetchangeschangeidrevisionsrevisionidfilesfileidblameC

Gets the blame of a file from a certain revision.

Inputs: file-id (required), change-id (required), revision-id (required), base. Returns: result

getChangesChangeIdRevisionsRevisionIdFilesFileIdContentGetchangeschangeidrevisionsrevisionidfilesfileidcontentC

Gets the content of a file from a certain revision.

Inputs: file-id (required), change-id (required), revision-id (required), parent. Returns: result

getChangesChangeIdRevisionsRevisionIdFilesFileIdDiffGetchangeschangeidrevisionsrevisionidfilesfileiddiffC

Gets the diff of a file from a certain revision.

Inputs: file-id (required), change-id (required), revision-id (required), base, +5 more. Returns: object

getChangesChangeIdRevisionsRevisionIdFilesFileIdDownloadGetchangeschangeidrevisionsrevisionidfilesfileiddownloadC

Downloads the content of a file from a certain revision, in a safe format that poses no risk for inadvertent execution of untrusted code.

Inputs: file-id (required), change-id (required), revision-id (required), parent. Returns: result

getChangesChangeIdRevisionsRevisionIdFixesFixIdPreviewGetchangeschangeidrevisionsrevisionidfixesfixidpreviewC

Gets the diffs of all files for a certain \{fix-id\}. As response, a map of DiffInfo entities is returned that describes the diffs.

Inputs: fix-id (required), change-id (required), revision-id (required). Returns: object

getChangesChangeIdRevisionsRevisionIdMergeableGetchangeschangeidrevisionsrevisionidmergeableC

Returns whether a revision can be merged into the destination branch as a MergeableInfo entity.

Inputs: change-id (required), revision-id (required), other-branches. Returns: object

getChangesChangeIdRevisionsRevisionIdMergelistGetchangeschangeidrevisionsrevisionidmergelistB

Returns the list of commits that are being integrated into a target branch by a merge commit. By default the first parent is assumed to be uninteresting. By using the parent option another parent can be set as uninteresting (parents are 1-based).

Inputs: change-id (required), revision-id (required), links, parent.

getChangesChangeIdRevisionsRevisionIdPatchGetchangeschangeidrevisionsrevisionidpatchB

Returns the formatted patch of a revision (base64-encoded unless the raw content type is requested).

Inputs: change-id (required), revision-id (required), raw, zip, +4 more. Returns: result

getChangesChangeIdRevisionsRevisionIdPortedCommentsGetchangeschangeidrevisionsrevisionidportedcommentsC

Ports comments of other revisions to the requested revision.

Inputs: change-id (required), revision-id (required). Returns: object

getChangesChangeIdRevisionsRevisionIdPortedDraftsGetchangeschangeidrevisionsrevisionidporteddraftsC

Ports draft comments of other revisions to the requested revision.

Inputs: change-id (required), revision-id (required). Returns: object

getChangesChangeIdRevisionsRevisionIdRelatedGetchangeschangeidrevisionsrevisionidrelatedC

Lists the changes related to a revision by ancestry as a RelatedChangesInfo entity.

Inputs: change-id (required), revision-id (required), o. Returns: object

getChangesChangeIdRevisionsRevisionIdReviewGetchangeschangeidrevisionsrevisionidreviewC

Retrieves a change with the review-relevant fields (labels, messages) for a revision.

Inputs: change-id (required), revision-id (required).

getChangesChangeIdRevisionsRevisionIdReviewersGetchangeschangeidrevisionsrevisionidreviewersC

Lists the reviewers of a revision.

Inputs: change-id (required), revision-id (required). Returns: result

getChangesChangeIdRevisionsRevisionIdReviewersReviewerIdGetchangeschangeidrevisionsrevisionidreviewersrevieweridC

Retrieves a reviewer of a change.

Inputs: change-id (required), reviewer-id (required), revision-id (required). Returns: result

getChangesChangeIdRevisionsRevisionIdReviewersReviewerId_2Getchangeschangeidrevisionsrevisionidreviewersreviewerid 2C

Lists the votes for a specific reviewer of the revision.

Inputs: change-id (required), reviewer-id (required), revision-id (required). Returns: object

getChangesChangeIdRevisionsRevisionIdRobotcommentsGetchangeschangeidrevisionsrevisionidrobotcommentsC

Lists the robot comments of a revision.

Inputs: change-id (required), revision-id (required).

getChangesChangeIdRevisionsRevisionIdRobotcommentsRobotCGetchangeschangeidrevisionsrevisionidrobotcommentsrobotcC

Retrieves a robot comment of a revision.

Inputs: change-id (required), revision-id (required), robot-comment-id (required).

getChangesChangeIdRevisionsRevisionIdSubmitTypeGetchangeschangeidrevisionsrevisionidsubmittypeC

Gets the method the server will use to submit (merge) the change.

Inputs: change-id (required), revision-id (required). Returns: result

getChangesChangeIdRobotcommentsGetchangeschangeidrobotcommentsC

Lists the robot comments of all revisions of the change.

Inputs: change-id (required).

getChangesChangeIdSubmittedTogetherGetchangeschangeidsubmittedtogetherB

Computes list of all changes which are submitted when Submit is called for this change, including the current change itself.

Inputs: change-id (required), o. Returns: object

getChangesChangeIdSuggestReviewersGetchangeschangeidsuggestreviewersC

Suggest the reviewers for a given query q and result limit n. If result limit is not passed, then the default 10 is used.

Inputs: change-id (required), limit, query, exclude-groups, +1 more. Returns: result

getChangesChangeIdTopicGetchangeschangeidtopicC

Retrieves the topic of a change.

Inputs: change-id (required). Returns: result

getChangesChangeIdValidationOptionsGetchangeschangeidvalidationoptionsC

Retrieves the validation options that apply to the change.

Inputs: change-id (required). Returns: object

getConfigServerCachesGetconfigservercachesB

Lists the caches of the server. Caches defined by plugins are included.

Inputs: format, include-diskstats.

getConfigServerCachesCacheIdGetconfigservercachescacheidC

Retrieves information about a cache.

Inputs: cache-id (required). Returns: object

getConfigServerCapabilitiesGetconfigservercapabilitiesA

Lists the capabilities that are available in the system. There are two kinds of capabilities: core and plugin-owned capabilities.

Inputs: no named parameters. Returns: object

getConfigServerExperimentsGetconfigserverexperimentsC

Lists the experiments that are available in the system.

Inputs: enabled-only. Returns: object

getConfigServerExperimentsExperimentIdGetconfigserverexperimentsexperimentidC

Retrieves the details of the experiment with the given name.

Inputs: experiment-id (required). Returns: object

getConfigServerIndexesGetconfigserverindexesA

Lists the indexes used by Gerrit. It provides details about the index versions, which index version is used to search and which versions are written to.

Inputs: no named parameters. Returns: result

getConfigServerIndexesIndexIdGetconfigserverindexesindexidB

Get an index used by Gerrit. It provides details about the index versions, which index version is used to search and which versions are written to.

Inputs: index-id (required). Returns: object

getConfigServerIndexesIndexIdVersionsGetconfigserverindexesindexidversionsC

Lists versions of an index used by Gerrit.

Inputs: index-id (required). Returns: object

getConfigServerIndexesIndexIdVersionsIndexVersionIdGetconfigserverindexesindexidversionsindexversionidB

Get info about one version of an index used by Gerrit.

Inputs: index-id (required), index-version-id (required). Returns: object

getConfigServerInfoGetconfigserverinfoB

Returns the public configuration of the Gerrit server as a ServerInfo entity.

Inputs: no named parameters. Returns: object

getConfigServerLabelsGetconfigserverlabelsA

Lists the globally defined labels (labels that are added programmatically via the LabelType extension point).

Inputs: no named parameters. Returns: result

getConfigServerMetricsGetconfigservermetricsC

Lists the metrics of the server, returning a map of metric name to a MetricInfo entity.

Inputs: prefix, data-only. Returns: object

getConfigServerMetricsMetricIdGetconfigservermetricsmetricidA

Retrieves a single metric of the server. The metric name is used as the \{metric-id\} and must be URL-encoded because it may contain slashes.

Inputs: metric-id (required), data-only. Returns: object

getConfigServerPreferencesGetconfigserverpreferencesB

Returns the default user preferences for the server.

Inputs: no named parameters. Returns: object

getConfigServerPreferencesDiffGetconfigserverpreferencesdiffA

Returns the default diff preferences for the server.

Inputs: no named parameters. Returns: object

getConfigServerPreferencesEditGetconfigserverpreferenceseditB

Returns the default edit preferences for the server.

Inputs: no named parameters. Returns: object

getConfigServerSubmitRequirementsGetconfigserversubmitrequirementsA

Lists the globally defined submit requirements (submit requirements that are added programmatically via the SubmitRequirement extension point).

Inputs: no named parameters. Returns: result

getConfigServerSummaryGetconfigserversummaryC

Retrieves a summary of the current server state.

Inputs: jvm. Returns: object

getConfigServerTasksGetconfigservertasksC

Lists the tasks from the background work queues that the Gerrit daemon is currently performing, or will perform in the near future.

Inputs: state. Returns: result

getConfigServerTasksTaskIdGetconfigservertaskstaskidB

Retrieves a task from the background work queue that the Gerrit daemon is currently performing, or will perform in the near future.

Inputs: task-id (required). Returns: object

getConfigServerTopMenusGetconfigservertopmenusC

Returns the list of additional top menu entries.

Inputs: no named parameters. Returns: result

getConfigServerVersionGetconfigserverversionC

Returns the version of the Gerrit server.

Inputs: verbose.

getGroupsGetgroupsC

Lists the internal groups visible to the caller.

Inputs: O, o, user, group, +10 more.

getGroupsGroupIdGetgroupsgroupidC

Retrieves a single group as a GroupInfo entity.

Inputs: group-id (required). Returns: object

getGroupsGroupIdDescriptionGetgroupsgroupiddescriptionB

Retrieves the description of a group.

Inputs: group-id (required). Returns: result

getGroupsGroupIdDetailGetgroupsgroupiddetailB

Retrieves a group with the direct members and the directly included groups.

Inputs: group-id (required). Returns: object

getGroupsGroupIdGroupsGetgroupsgroupidgroupsB

Lists the direct subgroups of a group.

Inputs: group-id (required). Returns: result

getGroupsGroupIdGroupsSubgroupIdGetgroupsgroupidgroupssubgroupidD

Retrieves a subgroup.

Inputs: group-id (required), subgroup-id (required). Returns: object

getGroupsGroupIdLogAuditGetgroupsgroupidlogauditC

Gets the audit log of a Gerrit internal group.

Inputs: group-id (required). Returns: result

getGroupsGroupIdMembersGetgroupsgroupidmembersC

Lists the direct members of a Gerrit internal group.

Inputs: group-id (required), recursive. Returns: result

getGroupsGroupIdMembersMemberIdGetgroupsgroupidmembersmemberidC

Retrieves a group member.

Inputs: group-id (required), member-id (required). Returns: object

getGroupsGroupIdNameGetgroupsgroupidnameC

Retrieves the name of a group.

Inputs: group-id (required). Returns: result

getGroupsGroupIdOptionsGetgroupsgroupidoptionsC

Retrieves the options of a group.

Inputs: group-id (required). Returns: object

getGroupsGroupIdOwnerGetgroupsgroupidownerB

Retrieves the owner group of a Gerrit internal group.

Inputs: group-id (required). Returns: object

getPluginsGetpluginsA

Lists the plugins installed on the Gerrit server. Only the enabled plugins are returned unless the all option is specified.

Inputs: r, all, limit, match, +2 more. Returns: object

getPluginsPluginIdGerritStatusGetpluginspluginidgerritstatusC

Retrieves the status of a plugin on the Gerrit server.

Inputs: plugin-id (required). Returns: object

getProjectsGetprojectsC

Lists the projects accessible by the caller, optionally filtered by prefix, regex, or substring.

Inputs: r, all, tree, type, +10 more.

getProjectsProjectIdGetprojectsprojectidC

Retrieves a single project as a ProjectInfo entity.

Inputs: project-id (required). Returns: object

getProjectsProjectIdAccessGetprojectsprojectidaccessC

Lists the access rights for a single project.

Inputs: project-id (required). Returns: object

getProjectsProjectIdBranchesGetprojectsprojectidbranchesC

Lists the branches of a project as BranchInfo entities.

Inputs: project-id (required), limit, match, regex, +2 more. Returns: result

getProjectsProjectIdBranchesBranchIdGetprojectsprojectidbranchesbranchidA

Retrieves a branch of a project. For the "All-Users" repository, the magic branch "refs/users/self" is automatically resolved to the user branch of the calling user.

Inputs: branch-id (required), project-id (required). Returns: object

getProjectsProjectIdBranchesBranchIdFilesFileIdContentGetprojectsprojectidbranchesbranchidfilesfileidcontentB

Gets the content of a file from the HEAD revision of a certain branch.

Inputs: file-id (required), branch-id (required), project-id (required). Returns: result

getProjectsProjectIdBranchesBranchIdFilesFileIdDiffGetprojectsprojectidbranchesbranchidfilesfileiddiffC

Gets the diff for a single file between two commits. The base query parameter is required (same as Diff Between Commits).

Inputs: file-id (required), branch-id (required), project-id (required), base, +2 more. Returns: object

getProjectsProjectIdBranchesBranchIdMergeableGetprojectsprojectidbranchesbranchidmergeableC

Gets whether the source is mergeable with the target branch.

Inputs: source (required), branch-id (required), project-id (required), strategy. Returns: object

getProjectsProjectIdBranchesBranchIdReflogGetprojectsprojectidbranchesbranchidreflogC

Gets the reflog of a certain branch.

Inputs: branch-id (required), project-id (required), to, from, +1 more. Returns: result

getProjectsProjectIdBranchesBranchIdSuggestReviewersGetprojectsprojectidbranchesbranchidsuggestreviewersC

Suggest the reviewers for a given query q and result limit n. If result limit is not passed, then the default 10 is used.

Inputs: branch-id (required), project-id (required), limit, query, +2 more. Returns: result

getProjectsProjectIdBranchesBranchIdValidationOptionsGetprojectsprojectidbranchesbranchidvalidationoptionsC

Retrieves the validation options applicable for the given project and branch.

Inputs: branch-id (required), project-id (required). Returns: object

getProjectsProjectIdCheckAccessGetprojectsprojectidcheckaccessB

This command runs access checks for other users. This requires the View Access global capability.

Inputs: project-id (required), ref, perm, account. Returns: object

getProjectsProjectIdChildrenGetprojectsprojectidchildrenC

List the direct child projects of a project.

Inputs: project-id (required), limit, recursive. Returns: result

getProjectsProjectIdChildrenChildProjectIdGetprojectsprojectidchildrenchildprojectidB

Retrieves a child project. If a non-direct child project should be retrieved the parameter recursive must be set.

Inputs: project-id (required), child-project-id (required), recursive. Returns: object

getProjectsProjectIdCommitsCommitIdGetprojectsprojectidcommitscommitidC

Retrieves a commit of a project.

Inputs: commit-id (required), project-id (required). Returns: object

getProjectsProjectIdCommitsCommitIdDiffGetprojectsprojectidcommitscommitiddiffC

Lists the files that differ between two commits. This is useful for comparing commits across multiple changes (similar to a pull request diff).

Inputs: commit-id (required), project-id (required), base, name-only. Returns: object

getProjectsProjectIdCommitsCommitIdFilesGetprojectsprojectidcommitscommitidfilesC

Lists the files that were modified, added or deleted in a commit.

Inputs: commit-id (required), project-id (required), parent. Returns: object

getProjectsProjectIdCommitsCommitIdFilesFileIdContentGetprojectsprojectidcommitscommitidfilesfileidcontentC

Gets the content of a file from a certain commit.

Inputs: file-id (required), commit-id (required), project-id (required). Returns: result

getProjectsProjectIdCommitsCommitIdFilesFileIdDiffGetprojectsprojectidcommitscommitidfilesfileiddiffC

Gets the diff for a single file between two commits. The base query parameter is required (same as Diff Between Commits).

Inputs: file-id (required), commit-id (required), project-id (required), base, +2 more. Returns: object

getProjectsProjectIdCommitsCommitIdInGetprojectsprojectidcommitscommitidinB

Retrieves the branches and tags in which a change is included. As result an IncludedInInfo entity is returned.

Inputs: commit-id (required), project-id (required). Returns: object

getProjectsProjectIdCommitsInGetprojectsprojectidcommitsinC

Gets refs in which the specified commits were merged into. Returns a map of commits to sets of full ref names.

Inputs: ref (required), commit (required), project-id (required). Returns: object

getProjectsProjectIdConfigGetprojectsprojectidconfigC

Gets some configuration information about a project. Note that this config info is not simply the contents of project.config; it generally contains fields that may have been inherited from parent projects.

Inputs: project-id (required). Returns: object

getProjectsProjectIdDashboardsGetprojectsprojectiddashboardsC

List custom dashboards for a project.

Inputs: project-id (required), inherited. Returns: result

getProjectsProjectIdDashboardsDashboardIdGetprojectsprojectiddashboardsdashboardidC

Retrieves a project dashboard. The dashboard can be defined on that project or be inherited from a parent project.

Inputs: project-id (required), dashboard-id (required), inherited. Returns: object

getProjectsProjectIdDescriptionGetprojectsprojectiddescriptionC

Retrieves the description of a project.

Inputs: project-id (required). Returns: result

getProjectsProjectIdHEADGetprojectsprojectidheadB

Retrieves for a project the name of the branch to which HEAD points.

Inputs: project-id (required). Returns: result

getProjectsProjectIdLabelsGetprojectsprojectidlabelsC

Lists the labels that are defined in this project.

Inputs: project-id (required), inherited, voteable-on-ref. Returns: result

getProjectsProjectIdLabelsLabelIdGetprojectsprojectidlabelslabelidB

Retrieves the definition of a label that is defined in this project.

Inputs: label-id (required), project-id (required). Returns: object

getProjectsProjectIdParentGetprojectsprojectidparentB

Retrieves the name of a project's parent project. For the All-Projects root project an empty string is returned.

Inputs: project-id (required). Returns: result

getProjectsProjectIdStatisticsGitGetprojectsprojectidstatisticsgitC

Return statistics for the repository of a project.

Inputs: project-id (required). Returns: object

getProjectsProjectIdSubmitRequirementsGetprojectsprojectidsubmitrequirementsB

Retrieves a list of all submit requirements for this project. The inherited parameter can be supplied to also list submit requirements from parent projects.

Inputs: project-id (required), inherited. Returns: result

getProjectsProjectIdSubmitRequirementsSubmitRequirementIGetprojectsprojectidsubmitrequirementssubmitrequirementiC

Retrieves the definition of a submit requirement that is defined in this project.

Inputs: project-id (required), submit-requirement-id (required). Returns: object

getProjectsProjectIdSubmitRequirementsTemplatesGetprojectsprojectidsubmitrequirementstemplatesA

Retrieves submit requirement templates configured in project.config and in its parent projects.

Inputs: project-id (required). Returns: result

getProjectsProjectIdSubmitRequirementsTemplatesSubmitReqGetprojectsprojectidsubmitrequirementstemplatessubmitreqB

Retrieves a single effective submit requirement template for a project. The returned template may be defined in the project itself or inherited from one of its parent projects.

Inputs: project-id (required), submit-requirement-template-id (required). Returns: object

getProjectsProjectIdTagsGetprojectsprojectidtagsC

List the tags of a project.

Inputs: project-id (required), limit, match, regex, +3 more. Returns: result

getProjectsProjectIdTagsTagIdGetprojectsprojectidtagstagidC

Retrieves a tag of a project.

Inputs: tag-id (required), project-id (required). Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.2/5.0

    Scored across 173 tools

    Disambiguation2/5

    With 173 tools there is heavy structural overlap: getChangesChangeIdReviewers vs getChangesChangeIdRevisionsRevisionIdReviewers, getChangesChangeIdComments vs the per-revision comments, and getAccountsAccountId vs getAccountsAccountIdDetail/State/Name all target closely-related data. The presence of a literal getChangesChangeIdRevisionsRevisionIdReviewersReviewerId_2 suffix signals near-duplicate tools an agent cannot easily distinguish. Descriptions are precise individually but the sheer volume of near-identical reviewer/comment/diff variants makes misselection likely.

    Naming Consistency2/5

    Names are mechanically generated path concatenations in camelCase (getChangesChangeIdRevisionsRevisionIdFilesFileIdDiff) mixed with snake_case namespace prefixes (code_owners_, checks_), so conventions are not unified. The get-verb prefix is used throughout but conveys little since almost every tool is a read. Length and case mixing break any clean verb_noun pattern.

    Tool Count1/5

    173 tools for a single server is a massive, machine-dumped surface far beyond what an agent can navigate coherently. It is essentially an entire REST API flattened into one namespace rather than a curated tool set. This is the extreme-mismatch end of the scale.

    Completeness2/5

    Read coverage is exhaustive (accounts, changes, projects, groups, config, plugins), but the surface appears to be get-only with no create/update/delete operations—no posting reviews, submitting changes, creating changes, or adding reviewers. For a code-review domain this leaves critical write workflows as dead ends despite the enormous read surface.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers