> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agents.labs.bandwidth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Browse documentation

> MCP reference for list_docs.

Tool: `list_docs`. Requires **Viewer or higher** in the applicable workspace and a connected [OAuth session](https://docs.agents.labs.bandwidth.com/mcp/authentication.md).

Browse navigation sections using optional `path` and depth 1–3. Section paths come from this tool; page paths from search/read are published routes. With no path, starts at the navigation root. Unknown sections or pages return a tool error.

## Arguments

| Name | Type | Required | Defaults and limits |
| - | - | - | - |
| `depth` | integer | No | Default: `1`; minimum: `1`; maximum: `3` |
| `path` | string or null | No | Default: `null` |

## Example arguments

Replace sample resource IDs with IDs returned in your selected workspace.

```json theme={null}
{
  "depth": 1
}
```

## Result and errors

The schema below describes MCP `structuredContent`, including the `result` wrapper where present. Your client may also display a text representation. Read success flags and structured errors before continuing; transport success alone does not prove the operation succeeded. Authentication, missing membership, and insufficient role can fail before a tool result is produced. See [troubleshooting](https://docs.agents.labs.bandwidth.com/mcp/troubleshooting.md).

**Effect:** Reads data. **Retry:** Declared idempotent. Discovery annotations describe behavior; they do not grant permission or replace confirmation for consequential actions.

> [accordion] Input schema
>
> ```json theme={null}
> {
>   "additionalProperties": false,
>   "properties": {
>     "depth": {
>       "default": 1,
>       "maximum": 3,
>       "minimum": 1,
>       "type": "integer"
>     },
>     "path": {
>       "anyOf": [
>         {
>           "type": "string"
>         },
>         {
>           "type": "null"
>         }
>       ],
>       "default": null
>     }
>   },
>   "type": "object"
> }
> ```

> [accordion] Result schema
>
> ```json theme={null}
> {
>   "properties": {
>     "result": {
>       "items": {
>         "anyOf": [
>           {
>             "properties": {
>               "breadcrumb": {
>                 "type": "string"
>               },
>               "child_count": {
>                 "type": "integer"
>               },
>               "has_children": {
>                 "type": "boolean"
>               },
>               "kind": {
>                 "const": "section",
>                 "type": "string"
>               },
>               "llm_hint": {
>                 "type": "string"
>               },
>               "page_count": {
>                 "type": "integer"
>               },
>               "path": {
>                 "type": "string"
>               },
>               "title": {
>                 "type": "string"
>               }
>             },
>             "required": [
>               "kind",
>               "path",
>               "title",
>               "breadcrumb",
>               "has_children",
>               "child_count",
>               "page_count"
>             ],
>             "type": "object"
>           },
>           {
>             "properties": {
>               "breadcrumb": {
>                 "type": "string"
>               },
>               "kind": {
>                 "const": "page",
>                 "type": "string"
>               },
>               "llm_hint": {
>                 "type": "string"
>               },
>               "path": {
>                 "type": "string"
>               },
>               "section_slug": {
>                 "type": "string"
>               },
>               "section_title": {
>                 "type": "string"
>               },
>               "title": {
>                 "type": "string"
>               }
>             },
>             "required": [
>               "kind",
>               "path",
>               "title",
>               "breadcrumb"
>             ],
>             "type": "object"
>           }
>         ]
>       },
>       "type": "array"
>     }
>   },
>   "required": [
>     "result"
>   ],
>   "type": "object"
> }
> ```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.