{
  "id": "tool-descriptor:codex.mcp.codex",
  "_kind": "ToolDescriptor",
  "_file": "extensions/tool-descriptors/codex-mcp-server-tools.yaml",
  "_cluster": "extensions",
  "attributes": {
    "schema": "{}",
    "displayName": "Codex MCP: Start Conversation",
    "description": "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`.",
          "type": "string",
          "enum": [
            "read-only",
            "workspace-write",
            "danger-full-access"
          ]
        }
      }
    },
    "outputSchema": {
      "type": "object",
      "required": [
        "threadId",
        "content"
      ],
      "properties": {
        "threadId": {
          "type": "string"
        },
        "content": {
          "type": "string"
        }
      }
    },
    "mode": "normal",
    "streamable": true,
    "timeoutMs": 120000
  },
  "outgoingEdges": [
    {
      "from": "tool-descriptor:codex.mcp.codex",
      "to": "tool-server:codex-mcp-server",
      "kind": "contained_in_plugin",
      "attributes": {}
    }
  ],
  "incomingEdges": [
    {
      "from": "tool-server:codex-mcp-server",
      "to": "tool-descriptor:codex.mcp.codex",
      "kind": "contains_tool_descriptor",
      "attributes": {}
    },
    {
      "from": "tool-server:codex-mcp-server",
      "to": "tool-descriptor:codex.mcp.codex",
      "kind": "exposes_tool",
      "attributes": {}
    }
  ]
}