MCP tool exposed by `codex mcp-server` to start a Codex conversation from another agent or host. Accepts configuration parameters matching the Codex Config struct.
inputSchema
type
object
required
prompt
properties
approval-policy
description
Approval policy for shell commands generated by the model: `untrusted`, `on-failure`, `on-request`, `never`.
type
string
enum
untrusted
on-failure
on-request
never
base-instructions
description
The set of instructions to use instead of the default ones.
type
string
compact-prompt
description
Prompt used when compacting the conversation.
type
string
config
description
Individual config settings that will override what is in CODEX_HOME/config.toml.
type
object
additionalProperties
true
cwd
description
Working directory for the session. If relative, it is resolved against the server process's current working directory.
type
string
developer-instructions
description
Developer instructions that should be injected as a developer role message.
type
string
model
description
Optional override for the model name.
type
string
profile
description
Configuration profile from config.toml to specify default options.
type
string
prompt
description
The initial user prompt to start the Codex conversation.
type
string
sandbox
description
Sandbox mode: `read-only`, `workspace-write`, or `danger-full-access`.