Gerrit OpenAPI MCP
Provides tools for interacting with Gerrit through its OpenAPI document, including read-only operations, bounded revision reviews, and optional checks and code-owners plugins. Profiles expose read operations by default, a constrained review workflow, or the full set of Gerrit API operations.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Gerrit OpenAPI MCP Show me the open Gerrit changes assigned to me"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 toolsRuns on FastMCP 4.2 and Python 3.12+.
Generated artifacts
Profile | Tools | Selection |
| 339 | Every operation in the pinned core document |
| 161 | Cataloged GET operations; default when serving |
| 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 testsupdate.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 agentserve-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 toolschecks_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
Scored across 173 tools
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.
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.
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.
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
Related MCP Connectors
Detect breaking changes, generate changelogs, diff, and validate OpenAPI specs.
Point Gecko at an OpenAPI spec; get first-call-correct, auth-hidden agent tools.
AI-native git hosting — repos, PRs, issues, CI gates, and AI code review over MCP (60 tools).
Every Canopy public API operation as a tool, run as you after a browser sign-in or on an API key.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides integration with Gerrit code review system, allowing AI assistants to fetch change details and compare patchset differences for code reviews.38MIT
- AlicenseBqualityBmaintenanceEnables interaction with Gerrit code review system via REST API, allowing language models to query changes, retrieve details, and manage reviews.2524Apache 2.0
- AlicenseAqualityDmaintenanceProvides MCP tools to review git changes using OpenAI Codex CLI, enabling code review of unstaged, staged, or last-commit changes.39 npmMIT
- AlicenseNot gradedqualityCmaintenanceAn MCP server that exposes Gerrit code review operations as capability-gated tools, enabling AI agents to search and read changes, publish comments, vote, and manage change state, with write capabilities as explicit opt-in.9MIT