| name | mcp |
| description | Manage MCP (Model Context Protocol) servers — list configured tools, check status, show invocation format, or add a new server to .codex/config.toml. |
MCP Skill
Manage Model Context Protocol (MCP) servers for this project.
Usage
$mcp # List configured servers + invocation format
$mcp status # Check which tool binaries are installed
$mcp add <server> # Add a new MCP server
$mcp format # Show all tool invocation strings
MCP Tool Invocation Format
mcp__SERVER_KEY__TOOL_FUNCTION_NAME
Where SERVER_KEY is the key in .codex/config.toml under [mcp_servers.*].
Instructions
If list or empty:
- Read
.codex/config.toml — show currently configured [mcp_servers.*] sections
- Show invocation format for each tool
- Suggest additional servers based on tech stack in
brain/architecture.md
If status:
- Check which MCP binaries are installed:
command -v uvx &>/dev/null && echo "uvx: ✅" || echo "uvx: ❌ missing — install via: pip install uv"
command -v npx &>/dev/null && echo "npx: ✅" || echo "npx: ⚠️ missing — install Node.js"
command -v ccc &>/dev/null && echo "cocoindex CLI (ccc): ✅" || echo "cocoindex CLI: ⚠️ optional — install via: pip install cocoindex"
If add <server-name>:
- Prefer CLI:
codex mcp add <server-name> -- <command> [args] (e.g., codex mcp add context7 -- npx -y @upstash/context7-mcp)
- Or manually add to
.codex/config.toml under [mcp_servers.<name>]
- For HTTP servers requiring OAuth:
codex mcp login <server-name> after configuration
- Update
AGENTS.md — add to Plugin Ecosystem section
If format:
Show all available MCP tool invocations from .codex/config.toml.
Pre-Configured MCP Stack
| Key in config.toml | Binary | Invocation prefix |
|---|
codebase-memory | uvx codebase-memory-mcp@latest | mcp__codebase-memory__ |
cocoindex-code | uvx cocoindex-code-mcp-server@latest | mcp__cocoindex-code__ |
code-review-graph | uvx code-review-graph@latest | mcp__code-review-graph__ |
serena | uvx serena@latest | mcp__serena__ |
playwright | npx @playwright/mcp@latest | mcp__playwright__ |
Adding a New Server — config.toml Format
[mcp_servers.github]
command = "npx"
args = ["-y", "@github/mcp-server"]
env = { GITHUB_TOKEN = "YOUR_GITHUB_TOKEN_HERE" }
env_vars = ["GITHUB_TOKEN"]
startup_timeout_sec = 10
tool_timeout_sec = 60
enabled = true
required = false
enabled_tools = ["search", "create"]
disabled_tools = ["delete"]
[mcp_servers.figma]
url = "https://mcp.figma.com/mcp"
bearer_token_env_var = "FIGMA_OAUTH_TOKEN"
Security Rules
- NEVER hardcode API keys — use env var placeholders like
"YOUR_KEY_HERE"
- For DB tools: prefer read-only access unless write is explicitly required
- After any config changes, restart Codex for MCP servers to take effect