Skip to main content
reopt Handbook
reopt Handbook
Codex Command MasterLabels and command selectionHow to read a detail guideComplete command listTerminal CLI Commands and Options

Task guides

Core Command GroupSession Command GroupCustom Command GuideMCP Command and Integration GuideDesign Workflows

Conversation and context

Cmd. /clearCmd. /renameCmd. /archiveCmd. /deleteCmd. /compactCmd. /copyCmd. /memoriesCmd. /importCmd. /initCmd. /mentionCmd. /forkCmd. /sideCmd. /resumeCmd. /newCmd. /cdCmd. /exportCmd. /recap

Planning and execution

Cmd. /planCmd. /goalCmd. /psCmd. /stopCmd. /app

Review and verification

Cmd. /review

Models and settings

Cmd. /modelCmd. /fast

Permissions and integrations

Cmd. /permissionsCmd. /ideCmd. /setup-default-sandboxCmd. /sandbox-add-read-dirCmd. /pluginsCmd. /hooksCmd. /approveCmd. /skillsCmd. /mcp

Status and diagnostics

Cmd. /agentCmd. /appsCmd. /diffCmd. /feedbackCmd. /personalityCmd. /rawCmd. /statusCmd. /debug-configCmd. /title

Display and input

Cmd. /keymapCmd. /vimCmd. /experimentalCmd. /statuslineCmd. /themeCmd. /petsCmd. /voiceCmd. /worktree

Account and usage

Cmd. /exitCmd. /logoutCmd. /quitCmd. /usage

Legacy

Cmd. /approvals

Verification and history

Current verification scopeHandbook updatesRelease coverage historyEarlier verification recordsCommand change history
Handbook›Codex Command Master›Cmd. /mcp
한국어English

Cmd. /mcp

List configured MCP tools and inspect server diagnostics.

Key takeaways

  • List configured MCP tools and inspect server diagnostics.
  • Check the input surface and availability before using the examples below.

Purpose

List configured MCP tools and inspect server diagnostics.

/mcp

Availability

FieldValue
Input surfaceRunning CLI prompt
KindBuilt-in
StatusCurrent reference
Aliases—
Documented minimumNot specified
Reviewed against2026-09-22 · Codex CLI 0.155.1

The installed command menu and account or organization settings determine availability.

Examples

/mcp

When to use it

  1. Run /mcp before asking Codex to use an external tool.
  2. Run /mcp verbose when a server is present but a tool is missing or failing.
  3. Confirm the design-context, metadata, and screenshot tools before starting from a Figma node.

Choosing related commands

CommandDifferenceChoose It When
/mcpLists MCP tools and diagnosticsYou need the actual tool surface
/appsInserts app mentionsYou need a connector in the prompt
/pluginsManages packaged capabilitiesYou need to inspect installed bundles

Effects and persistence

Inspects configured MCP servers and exposed tools. Use the appropriate codex mcp subcommand to add or remove servers.

/mcp lists configured Model Context Protocol tools available to Codex. Use /mcp verbose for server-level diagnostics.

Authentication in 0.155.0

Local TUI sessions on supported Macs can use Touch ID verification for MCP requests. Expired OAuth credentials are reported more accurately, with reconnect guidance after refresh failure.

Official changelog

Cautions

  • Tool availability can differ by profile, workspace, and trust state.
  • Pair MCP write or destructive tools with /permissions and team policy.
  • Do not read “deprecated” as “already removed,” and do not postpone migration merely because the old subcommand still starts.

Official sources

  • Developer Commands
  • Cli
  • Overview#Mcp
  • Figma Designs To Code
  • Changelog

Complete command list · Verification scope · History for this command

Related docs

MCP Integration

Advanced Codex Usage · Connect Codex to MCP servers with explicit tool, data, and trust boundaries.

MCP Integration

Claude Code Complete Guide · Connect Claude Code to tools and resources through Model Context Protocol servers.

MCP Command and Integration Guide

How to operate MCP servers and tools safely from Codex.

Cmd. /mcp

Claude Code Command Master · Manage MCP connections, OAuth, and enabled state.

Cmd. /apps

Browse apps and connectors, then insert app mentions into the prompt.

Cmd. /skills

Browse and apply local skills for task-specific behavior.

Cmd. /agent

Switch between spawned Codex subagent threads to inspect each agent transcript, status, model, and reasoning effort before merging their work.

On this page

PurposeAvailabilityExamplesWhen to use itChoosing related commandsEffects and persistenceAuthentication in 0.155.0CautionsOfficial sources