restart_codex_mcp_process
Restart a Codex CLI MCP server process by killing the wrapped child PID from its pidfile. Resolves stalled or unresponsive MCP servers wrapped via wrap_codex_mcp_stdio, avoiding manual CLI restarts.
Instructions
Restart a Codex CLI MCP server process. Works reliably only for wrapped MCPs (via wrap_codex_mcp_stdio) by killing the wrapped child PID from its pidfile; otherwise you typically need to restart Codex CLI.
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": {
"mcp_name": "<mcp_name>"
},
"name": "restart_codex_mcp_process"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mcp_name | Yes | The mcp_servers.<name> entry in ~/.codex/config.toml to restart |