mcp

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:

1. Read .codex/config.toml — show currently configured [mcp_servers.*] sections
2. Show invocation format for each tool
3. Suggest additional servers based on tech stack in brain/architecture.md

If status:

1. 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"
   # uvx-based tools (codebase-memory, code-review-graph, serena, cocoindex-code) are available when uvx is installed
   

If add <server-name>:

1. Prefer CLI: codex mcp add <server-name> -- <command> [args] (e.g., codex mcp add context7 -- npx -y @upstash/context7-mcp)
2. Or manually add to .codex/config.toml under [mcp_servers.<name>]
3. For HTTP servers requiring OAuth: codex mcp login <server-name> after configuration
4. 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

# STDIO server
[mcp_servers.github]
command = "npx"
args = ["-y", "@github/mcp-server"]
env = { GITHUB_TOKEN = "YOUR_GITHUB_TOKEN_HERE" }
env_vars = ["GITHUB_TOKEN"]         # forward from local env
startup_timeout_sec = 10             # default: 10
tool_timeout_sec = 60                # default: 60
enabled = true                       # false = disabled without deleting
required = false                     # true = fail if server can't start
enabled_tools = ["search", "create"] # tool allow list
disabled_tools = ["delete"]          # deny list (applied after enabled_tools)

# HTTP/streamable server
[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