Cmd. /mcp
List configured MCP tools and inspect server diagnostics.
Key takeaways
/mcplists configured Model Context Protocol tools available to Codex;/mcp verboseadds server-level diagnostics.- Run it before asking Codex to use an external tool, and use verbose mode when a server is present but a tool is missing or failing.
- Tool availability can differ by profile, workspace, and trust state.
- Pair MCP write or destructive tools with
/permissionsand team policy. - Since 0.143.0, MCP tool search is the default and ChatGPT-hosted servers can request session auth; in 0.144.0 interactive authentication no longer needs an experimental opt-in.
- Before implementing a Figma selection, confirm that
get_design_context,get_metadata, andget_screenshotare exposed. - In 0.146.0, refresh MCP connections and App tools after auth, config, or plugin changes without restarting the CLI.
Original Command Declaration
/mcpOfficial Summary
/mcp lists configured Model Context Protocol tools available to Codex. Use /mcp verbose for
server-level diagnostics.
Usage
/mcpGood Examples
- Run
/mcpbefore asking Codex to use an external tool. - Run
/mcp verbosewhen a server is present but a tool is missing or failing. - Confirm the design-context, metadata, and screenshot tools before starting from a Figma node.
Similar Commands
| Command | Difference | Choose It When |
|---|---|---|
/mcp | Lists MCP tools and diagnostics | You need the actual tool surface |
/apps | Inserts app mentions | You need a connector in the prompt |
/plugins | Manages packaged capabilities | You need to inspect installed bundles |
Use Cases
- Auditing available MCP tools.
- Debugging missing server tools.
- Verifying team tool configuration before automation.
- Pulling exact Figma design context and assets before Playwright-backed visual verification.
Recent Changes
/mcp verboseprovides deeper server diagnostics.- Built-in MCPs and plugin-provided capabilities are increasingly first-class in runtime flows.
- 0.146.0 adds live MCP/App-tool refresh and broader proxy handling across auth redirects, MCP, and remote WebSockets.
Cautions
- Tool availability can differ by profile, workspace, and trust state.
- Pair MCP write or destructive tools with
/permissionsand team policy.
Release Basis
- Judgment: confirmed addition
- First evidence version:
rust-v0.23.0 - Date (UTC): 2025-08-20
- Release link: https://github.com/openai/codex/releases/tag/rust-v0.23.0
Sources
- Codex slash commands: https://developers.openai.com/codex/cli/slash-commands
- Codex CLI features: https://developers.openai.com/codex/cli/features
- Codex MCP customization: https://learn.chatgpt.com/docs/customization/overview#mcp
- Figma designs to code: https://learn.chatgpt.com/use-cases/figma-designs-to-code