1. Docs
2. /
3. Tool reference
4. /
5. GitHub & Code
6. /
7. listRepoTree

GitHub & Code

listRepoTree

List Repo Tree

Browse a connected GitHub repo's file tree at a ref, optionally scoped to a path and depth.

readexternal

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "list files in <repo>", and it calls listRepoTree.

Example call

The MCP tools/call params, with the required arguments only.

{
  "arguments": {
    "owner": "<owner>",
    "repo": "<repo>"
  },
  "name": "listRepoTree"
}

Arguments

• depthintegeroptionalLimit results to this many directory levels below path (1 = immediate children). Omit for the full subtree.
• limitintegeroptionalMax entries returned (default 1500, ceiling 3000).
• ownerstringrequiredRepository owner
• pathstringoptionalSubtree path to filter to
• refstringoptionalBranch, tag, or commit SHA. Defaults to the repo default branch.
• repostringrequiredRepository name

Returns

The registry does not declare a return shape.

Declared limits

• depth: minimum 1
• depth: maximum 9007199254740991
• limit: minimum 1
• limit: maximum 3000

Ask for it

The Cloud routes these requests to this verb.

• list files in <repo>
• what's in <dir>

Pair it with

The verbs that finish the job.

• readRepoFile

Questions

• What does listRepoTree do?

  Browse a connected GitHub repo's file tree at a ref, optionally scoped to a path and depth. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use listRepoTree from Claude or ChatGPT?

  Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "list files in <repo>", and it calls listRepoTree.

• Is listRepoTree safe to let an AI call?

  listRepoTree is read-only: it changes nothing. It reaches a system outside The Cloud on your behalf.

Connect

One endpoint gives your AI this tool and every other one: connect Claude, ChatGPT, Cursor or Gemini, read what The Cloud is, or see pricing.