CleanClean
MCP Tools

list_repos

List all indexed repositories available for search.

list_repos shows every indexed repository, with its branch, status, entity count, and detected language/framework. Call it first if you're unsure what you can search across, or to check whether an indexing job has finished.

Inputs

This tool takes no arguments.

{ "name": "list_repos", "arguments": {} }

What you get back

For each repo, one line showing:

  • Repo nameowner/repo, with @branch appended when a non-default branch was indexed.
  • Statusready, indexing, cloning, or error.
  • Entity count — how many functions/classes/methods are indexed.
  • Detected metadata — primary language, framework tags, and a short description, when available.

Example output:

Indexed repositories:
  facebook/react        | ready    | 4,213 entities | JavaScript | "A declarative UI library"
  local/myproject       | indexing | 0 entities

When to call it

  • First, if you don't know which repos are indexed.
  • After index_repo to watch for the status flipping to ready.
  • When a search reports a repo isn't ready, to confirm its current state.

On this page