> ## 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.

# Get voice-prompting guidance

> MCP reference for get_voice_prompting_guide.

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

Choose `stage` from plan, create, or review, or select a `topic` returned by a prior briefing. Stage and topic are mutually exclusive. `node_type` narrows relevant advice when supported. Use the guide for turn-taking, persona, and spoken interaction; use documentation search for product setup.

## Arguments

| Name | Type | Required | Defaults and limits |
| - | - | - | - |
| `node_type` | string or null | No | Default: `null` |
| `stage` | string or null | No | Default: `null` |
| `topic` | string or null | No | Default: `null` |

## Example arguments

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

```json theme={null}
{
  "stage": "plan"
}
```

## 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": {
>     "node_type": {
>       "anyOf": [
>         {
>           "type": "string"
>         },
>         {
>           "type": "null"
>         }
>       ],
>       "default": null
>     },
>     "stage": {
>       "anyOf": [
>         {
>           "enum": [
>             "plan",
>             "create",
>             "review"
>           ],
>           "type": "string"
>         },
>         {
>           "type": "null"
>         }
>       ],
>       "default": null
>     },
>     "topic": {
>       "anyOf": [
>         {
>           "type": "string"
>         },
>         {
>           "type": "null"
>         }
>       ],
>       "default": null
>     }
>   },
>   "type": "object"
> }
> ```

> [accordion] Result schema
>
> ```json theme={null}
> {
>   "properties": {
>     "result": {
>       "anyOf": [
>         {
>           "properties": {
>             "next": {
>               "type": "string"
>             },
>             "topics": {
>               "items": {
>                 "properties": {
>                   "id": {
>                     "type": "string"
>                   },
>                   "title": {
>                     "type": "string"
>                   }
>                 },
>                 "required": [
>                   "id",
>                   "title"
>                 ],
>                 "type": "object"
>               },
>               "type": "array"
>             }
>           },
>           "required": [
>             "topics",
>             "next"
>           ],
>           "type": "object"
>         },
>         {
>           "properties": {
>             "drill_in": {
>               "type": "string"
>             },
>             "filtered_to_node_type": {
>               "type": "string"
>             },
>             "intro": {
>               "type": "string"
>             },
>             "stage": {
>               "enum": [
>                 "plan",
>                 "create",
>                 "review"
>               ],
>               "type": "string"
>             },
>             "topics": {
>               "items": {
>                 "properties": {
>                   "id": {
>                     "type": "string"
>                   },
>                   "lens": {
>                     "type": "string"
>                   },
>                   "title": {
>                     "type": "string"
>                   }
>                 },
>                 "required": [
>                   "id",
>                   "title",
>                   "lens"
>                 ],
>                 "type": "object"
>               },
>               "type": "array"
>             }
>           },
>           "required": [
>             "stage",
>             "intro",
>             "topics",
>             "drill_in"
>           ],
>           "type": "object"
>         },
>         {
>           "properties": {
>             "applies_to_node_types": {
>               "items": {
>                 "type": "string"
>               },
>               "type": "array"
>             },
>             "content": {
>               "type": "string"
>             },
>             "cross_refs": {
>               "items": {
>                 "type": "string"
>               },
>               "type": "array"
>             },
>             "id": {
>               "type": "string"
>             },
>             "severity": {
>               "enum": [
>                 "low",
>                 "medium",
>                 "high"
>               ],
>               "type": "string"
>             },
>             "stages_relevant": {
>               "items": {
>                 "type": "string"
>               },
>               "type": "array"
>             },
>             "title": {
>               "type": "string"
>             }
>           },
>           "required": [
>             "id",
>             "title",
>             "severity",
>             "content",
>             "stages_relevant"
>           ],
>           "type": "object"
>         }
>       ]
>     }
>   },
>   "required": [
>     "result"
>   ],
>   "type": "object"
> }
> ```


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