Start a discussion with Codex
discussion_startStart an independent read-only Codex conversation to get a second opinion on a coding question. Select model and effort, then read the reply with discussion_read.
Instructions
Start an independent read-only Codex conversation. Call models_list first, then select model and effort for the question complexity. Supply the question, relevant context and optional absolute project cwd. Returns discussionId and turnId immediately; read output using discussion_read.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"message": "<message>"
},
"name": "discussion_start"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | No | Absolute project directory. Defaults to --cwd or the MCP process working directory. | |
| model | No | Exact model value returned by models_list. Choose based on the question complexity and model description. | |
| effort | No | One of the selected model supportedReasoningEfforts. Reasoning efforts differ between models. | |
| message | Yes |