list_repositories
Paginated list of the Git repositories a project's code lives in, each with its provider, owner, name, default branch, privacy and component, narrowed by provider, component, disconnected state or search words.
Return the repositories of one project by full name: where the team registered its code, each with the provider, the owner and name as the provider spells them, the branch releases are cut from, the address, whether it is private, the component it builds and whether it is set aside. Read it before cloning, branching or naming a repository in a commit message, so you work in the repository the team registered and branch from its default branch.
Narrow with provider (github, gitlab or bitbucket), component_id (the repositories that build one component), disconnected (true for disconnected repositories only, false for live ones; omit for both) and search (words in the full name, the address or the default branch). A guest token is refused: where the code lives is the team's business.
Requires ability
The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.
Runs the same action as
The REST endpoint and this tool share one action, so validation, permissions and events are identical.
Annotations
It reads and never changes anything.
Arguments
project_id*stringUUID of the project whose repositories to list.
providerstringoptionalOne provider: github, gitlab or bitbucket.
component_idstringoptionalUUID of a component; lists the repositories that build it only.
disconnectedbooleanoptional`true` lists disconnected repositories only, `false` live ones only; omit for both.
searchstringoptionalWords the full name, the address or the default branch must contain.
limitintegeroptionalRepositories per page (1..100, default 25).
1max100pageintegeroptional1-indexed page number.
1What it returns
{ "data": [ { "id": "b1c2d3e4-f5a6-4b7c-8d9e-0f1a2b3c4d5e", "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13", "component_id": "c2d3e4f5-a6b7-4c8d-9e0f-1a2b3c4d5e6f", "provider": "github", "owner": "zuse-technologies", "name": "customer-portal-web", "full_name": "zuse-technologies/customer-portal-web", "default_branch": "main", "url": "https://github.com/zuse-technologies/customer-portal-web", "private": true, "connected_by": "9b2e4f1a-3c5d-4e6f-8a7b-1c2d3e4f5a6b", "connected_at": "2026-10-20T09:20:00+00:00", "disconnected_at": null, "created_at": "2026-10-20T09:20:00+00:00", "updated_at": "2026-10-27T11:30:00+00:00" } ], "meta": { "page": 1, "limit": 25, "total": 1, "has_more": false }}How it fails
VALIDATION_FAILEDprovider is not one of the three providers, or component_id is not a UUID.
RESOURCE_NOT_FOUNDunknown project_id, or a project outside the token's scope or the person's visibility.
FORBIDDENthe person behind the token may not read the project's repositories, a client guest among them.
TOKEN_MISSING_ABILITYtoken lacks repository:view-any.
How is this guide?
Last updated on