Agent skill

MCP Management

by CodeAlive-AI in CodeAlive-AI/ai-driven-development

Search, install, configure, update, and remove MCP servers across coding agents (Claude Code, Cursor, VS Code, Claude Desktop, Gemini CLI, Codex, Goose, Zed, Devin CLI/Desktop, and more).

MITAuto-check passedAgent Workflows

Install MCP Management

skills CLI
$ npx skills add CodeAlive-AI/ai-driven-development --skill mcp-management -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install CodeAlive-AI/ai-driven-development mcp-management --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/CodeAlive-AI/ai-driven-development.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/mcp-management .claude/skills/mcp-management && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
mcp-management
GitHub stars
157
Used in
1 other repo
Token cost
~2.3k tokens
SKILL.md length
868 words
Files
7 (incl. references)
Skills in repo
22
Repo updated
First seen
Licence
MIT

At a glance

Search, install, configure, update, and remove MCP servers across coding agents (Claude Code, Cursor, VS Code, Claude Desktop, Gemini CLI, Codex, Goose, Zed, Devin CLI/Desktop, and more).

  • Works in 6 steps: Prefer project-level .codex/config.toml… → For HTTP servers that use OAuth, run → For HTTP servers that use bearer tokens,… → …
  • Tasks that involve MCP servers
  • SKILL.md covers Quick Reference (Claude Code), Multi-Agent Installation (npx…, Searching for MCP Servers and Adding Servers (Claude Code), plus 7 more sections
  • Calls claude, codex and npx; reaches mcp.stripe.com

What it does

MCP Management is an agent skill from CodeAlive-AI/ai-driven-development. Search, install, configure, update, and remove MCP servers across coding agents (Claude Code, Cursor, VS Code, Claude Desktop, Gemini CLI, Codex, Goose, Zed, Devin CLI/Desktop, and more). Supports multi-agent installation via npx add-mcp, the official MCP registry, and direct config editing.

Its SKILL.md is about 2.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including reference files (for example `references/multi-agent.md`, `references/opencode-mcp.md` and `references/scopes.md`).

It sits in Agent Workflows, covering MCP servers. It works with Model Context Protocol and Visual Studio Code. The repository describes itself as: Practices, protocols, and skills for AI-driven software development. Skills and safety hooks for Claude Code, Codex, OpenCode, Cursor, Antigravity, and any agent supporting the… The licence is MIT.

When your agent uses it

  • Tasks that involve MCP servers

Example prompts

  • “/mcp-management”

Requirements

  • Node.js
  • A credential in EXAMPLE_API_KEY

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Prefer project-level .codex/config.toml when the user explicitly asks for repo-level
  2. For HTTP servers that use OAuth, run
  3. For HTTP servers that use bearer tokens, prefer Codex's native bearer-token env form
  4. After adding, removing, editing, or logging in to a Codex App MCP server, tell the user to
  5. Verification has two levels
  6. If project-level .codex/config.toml is not being picked up by Codex App, as a temporary

What it can do on your machine

Read from SKILL.md and the folder at commit 25b7b1d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • claude
    • codex
    • npx
    • opencode
    • supabase

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • mcp.stripe.com

    Also links to:

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

MCP Management loads about 2.3k tokens when it runs, and up to ~11k if it reads all its reference files. Until then it costs about 77 tokens; SKILL.md has 868 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~77
When it runs · the whole SKILL.md, loaded when a task matches
~2.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~11k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from CodeAlive-AI/ai-driven-development at commit 25b7b1d, republished under its MIT licence (© CodeAlive-AI). 868 words, ~2,321 tokens.

Download SKILL.mdSave it as .claude/skills/mcp-management/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
mcp-management
description
Search, install, configure, update, and remove MCP servers across coding agents (Claude Code, Cursor, VS Code, Claude Desktop, Gemini CLI, Codex, Goose, Zed, Devin CLI/Desktop, and more). Supports multi-agent installation via npx add-mcp, the official MCP registry, and direct config editing.

MCP Server Management

IMPORTANT: After adding, removing, or updating MCP servers, inform the user to restart the affected agent for changes to take effect.

CRITICAL: Before removing any server, use AskUserQuestion to confirm with the user.

Quick Reference (Claude Code)

bash
# Install
claude mcp add --transport http <name> <url>
claude mcp add --transport stdio <name> -- <command> [args...]
claude mcp add-json <name> '<json>'              # Full JSON config in one shot

# List/inspect
claude mcp list
claude mcp get <name>

# Remove (confirm with user first!)
claude mcp remove <name>

# OAuth login/logout (for OAuth-protected HTTP servers)
claude mcp login <name>
claude mcp logout <name>

Options must come BEFORE the server name. As of 2026-04, --transport http (Streamable HTTP) is recommended; sse is end-of-life.

Plugin MCP servers connect automatically at session start. Use /reload-plugins to re-init after enabling/disabling a plugin mid-session.

Multi-Agent Installation (npx add-mcp)

Install MCP servers to multiple coding agents at once using add-mcp:

bash
# Remote server (HTTP)
npx add-mcp https://mcp.example.com/mcp

# npm package (stdio)
npx add-mcp @modelcontextprotocol/server-postgres

# Local command
npx add-mcp "npx -y @org/mcp-server --flag value"

# SSE transport
npx add-mcp https://mcp.example.com/sse --transport sse
Options
FlagDescription
-g, --globalInstall globally instead of project-level
-a, --agent <agent>Target specific agent(s), repeatable
-n, --name <name>Custom server name
-t, --transport <type>HTTP (default) or SSE
--header <header>Custom HTTP headers, repeatable
-y, --yesSkip confirmation prompts
--allInstall to all detected agents
Supported Agents
AgentCLI ArgumentSupports Project-Level
Claude Codeclaude-codeYes (.mcp.json)
Claude Desktopclaude-desktopNo (global only)
CursorcursorYes (.cursor/mcp.json)
VS CodevscodeYes (.vscode/mcp.json)
Gemini CLIgemini-cliYes (.gemini/settings.json)
CodexcodexYes (.codex/config.toml, trusted projects only)
GoosegooseNo (global only)
GitHub Copilot CLIgithub-copilot-cliYes (.vscode/mcp.json)
OpenCodeopencodeYes (opencode.json)
ZedzedYes (.zed/settings.json)
Codex App / Desktop caveats

Codex has two relevant surfaces:

  • Codex CLI (codex mcp list, codex mcp get, codex mcp login) can see and validate MCP configuration from the CLI process.
  • Codex App / Desktop threads receive MCP tools only when the app starts a thread with those servers loaded and authenticated. A server can appear in codex mcp list but still be absent from the current model turn's tool list if the thread was created before the server was added, authenticated, or reloaded.

When configuring MCP for Codex App:

  1. Prefer project-level .codex/config.toml when the user explicitly asks for repo-level setup. The project must be trusted in ~/.codex/config.toml under [projects."/absolute/path"] trust_level = "trusted".
  2. For HTTP servers that use OAuth, run:
    bash
    codex mcp login <server-name>
    Then verify codex mcp list shows Auth: OAuth.
  3. For HTTP servers that use bearer tokens, prefer Codex's native bearer-token env form over hardcoding a header:
    bash
    codex mcp add <name> --url https://example.com/mcp --bearer-token-env-var EXAMPLE_API_KEY
    If writing .codex/config.toml directly, this is the expected shape:
    toml
    [mcp_servers.example]
    type = "http"
    url = "https://example.com/mcp"
    bearer_token_env_var = "EXAMPLE_API_KEY"
    Some third-party installers write http_headers.Authorization = "Bearer ${EXAMPLE_API_KEY}"; Codex CLI may display this as a bearer-token server, but the native field is clearer.
  4. After adding, removing, editing, or logging in to a Codex App MCP server, tell the user to fully restart Codex App. Existing threads can receive newly available tools after the app restart; create a new thread only as a fallback if tool_search still cannot find the server tools in the existing thread.
  5. Verification has two levels:
    bash
    codex mcp list
    codex mcp get <server-name>
    confirms Codex CLI/config/auth. Inside a Codex App thread, also use tool_search for a server-specific tool name (for example supabase execute_sql or render list_services). If tool_search returns no tools while codex mcp list is correct, the issue is usually App/thread reload or the server being configured only in a scope the App did not load.
  6. If project-level .codex/config.toml is not being picked up by Codex App, as a temporary diagnostic duplicate the server in user-level ~/.codex/config.toml, restart the App, and confirm tools appear. Remove the user-level duplicate afterward if the user wanted repo-only setup.
Show full SKILL.md (354 more words)Show less
Examples
bash
# Install to Claude Code and Cursor only
npx add-mcp -a claude-code -a cursor https://mcp.stripe.com

# Install npm package to all agents, globally
npx add-mcp -g --all @modelcontextprotocol/server-postgres

# Install with custom name and headers
npx add-mcp -n my-api --header "Authorization: Bearer TOKEN" https://api.example.com/mcp

# List available agents
npx add-mcp list-agents

See references/multi-agent.md for agent-specific config paths, formats, and transformations.

Searching for MCP Servers

When users ask to find or install an MCP server, see references/search.md for:

  • Official vendor server lookup (always try first)
  • MCP Registry API queries (fallback)
  • Known official servers table
  • User choice template format

Trust hierarchy: Official vendor > MCP reference servers > Verified partners > Community

Adding Servers (Claude Code)

With Environment Variables

The --env CLI flag is unreliable with special characters. Instead:

  1. Add server without env vars:

    bash
    claude mcp add --transport stdio <name> -- npx -y @package/mcp-server
  2. Edit config file to add env vars. See references/scopes.md for file locations.

Collect Configuration First

Before installing, check if the server needs API keys or tokens. Use AskUserQuestion to collect required values before running install commands.

Updating Servers

No direct update command exists. Options:

  1. Edit config directly (preferred for credential changes)
  2. Remove and re-add (confirm removal with user first)
  3. Use environment variables for credentials that change often

For OAuth servers (GitHub, Sentry): Run /mcp in Claude Code to re-authenticate.

Removing Servers

Always confirm with user via AskUserQuestion before removing.

bash
claude mcp remove <server-name>

For project-scoped servers in .mcp.json, delete the entry from the file after user confirmation.

OpenCode-specific notes

For OpenCode (anomalyco/opencode v1.14.x):

  • Top-level key is mcp (not mcpServers); each server must declare type: "local" or type: "remote"
  • For local servers, command is a single array ["bin", "arg1", "arg2"] — there's no separate args field
  • Env vars go under environment (not env)
  • Per-server enabled: false disables without removing
  • Use opencode mcp auth <name> / opencode mcp logout <name> for OAuth servers (e.g., GitHub)
  • Plugin tool.execute.* hooks do not fire for MCP tool calls in v1.14.x — use permission rules instead

See references/opencode-mcp.md for the full OpenCode MCP reference.

Reference

Scopes Summary (Claude Code)

ScopeFlagConfig LocationUse Case
Local--scope local (default)~/.claude.jsonPersonal dev servers
Project--scope project.mcp.jsonTeam-shared servers
User--scope user~/.claude.jsonCross-project tools

Environment Variable Syntax

In config files: ${VAR} or ${VAR:-default}

Windows Note

Use cmd /c wrapper for npx:

bash
claude mcp add --transport stdio my-server -- cmd /c npx -y @some/package

© CodeAlive-AI, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (references) in skills/mcp-management of CodeAlive-AI/ai-driven-development.

  • SKILL.md
  • references/multi-agent.md
  • references/opencode-mcp.md
  • references/scopes.md
  • references/search.md
  • references/transports.md
  • references/troubleshooting.md

Open the folder on GitHubat commit 25b7b1d

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in CodeAlive-AI/ai-driven-development, which our catalogue first saw on October 7, 2026.

Compare with similar skills

MCP Management next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

MCP Management compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
MCP Management this skillCodeAlive-AI/ai-driven-development1571 repos~2.3kAutomated safety check: PassMIT
Cao MCP Appsawslabs/cli-agent-orchestrator1.4k—~1.9kAutomated safety check: PassApache-2.0
CC Workflow Studio AI Editorbreaking-brake/cc-wf-studio5.4k—~561Automated safety check: PassCustom licence
Agnixagent-sh/agnix445—~874Automated safety check: PassApache-2.0
Claude Docs Consultantcentminmod/my-claude-code-setup2.7k—~959Automated safety check: PassMIT
Agnixagent-sh/agnix445—~563Automated safety check: PassApache-2.0

Similar skills

  • Cao MCP Apps

    awslabs/cli-agent-orchestrator

    Official

    Enable, operate, and extend CAO's MCP Apps surface — the host-rendered fleet dashboard visible inside MCP App hosts (Claude Desktop, ChatGPT, VS Code Copilot, Goose, Postman).

    1.4k GitHub stars~1.9k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • CC Workflow Studio AI Editor

    breaking-brake/cc-wf-studio

    Creates and edits visual agent workflows in CC Workflow Studio through conversation, with the agent reading and writing the canvas over MCP.

    5.4k GitHub stars~561 tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Agnix

    agent-sh/agnix

    A skill your agent uses when user asks to 'lint agent configs', 'validate skills', 'check CLAUDE.md', 'validate hooks', 'lint MCP'.

    445 GitHub stars~874 tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Claude Docs Consultant

    centminmod/my-claude-code-setup

    Consult official Claude Code documentation from code.claude.com using selective fetching.

    2.7k GitHub stars~959 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Agnix

    agent-sh/agnix

    A skill your agent uses when user asks to 'lint agent configs', 'validate skills', 'check CLAUDE.md', 'validate hooks', 'lint MCP'.

    445 GitHub stars~563 tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Setup Context A8c

    woocommerce/woocommerce-ios

    Set up the ContextA8C MCP server for accessing Automattic internal resources (Slack, Linear, P2s, GitHub Enterprise, etc.)

    358 GitHub starsUsed in 1 repo~627 tokens
    Agent WorkflowsAuto-check: notes

More from CodeAlive-AI/ai-driven-development

All 22 skills in this repo
  • Investigating Repository History

    CodeAlive-AI/ai-driven-development

    Investigate GitHub repository history before risky code changes using git blame/log, GitHub PRs, review comments, squash/rebase/cherry-pick/rename heuristics, and cited evidence.

    157 GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Plugins Management

    CodeAlive-AI/ai-driven-development

    Create, publish, delete, and submit plugins for coding agents (Claude Code, OpenCode, Devin CLI/Desktop).

    157 GitHub starsUsed in 1 repo~3.1k tokens
    Auto-check: notes
  • Semantic Scholar Deep

    CodeAlive-AI/ai-driven-development

    Deep research over the Semantic Scholar Graph API. An agent skill from CodeAlive-AI/ai-driven-development.

    157 GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check passed
  • Windows QA Engineer

    CodeAlive-AI/ai-driven-development

    A skill your agent uses when testing Windows 11 desktop apps (WinForms/WPF/UWP) via UFO UIA/Win32 automation MCP.

    157 GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed
  • Agentic Readiness

    CodeAlive-AI/ai-driven-development

    Audit and improve repositories for reliable agentic work across Codex and Codex App, Claude Code, and OpenCode.

    157 GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed
  • Hooks Management

    CodeAlive-AI/ai-driven-development

    Manage hooks and automation for coding agents (Claude Code, Codex CLI, OpenCode, Devin CLI/Desktop).

    157 GitHub stars~4.8k tokensUpdated yesterday
    Auto-check: notes

Categories

Questions about MCP Management

What does MCP Management do?

Search, install, configure, update, and remove MCP servers across coding agents (Claude Code, Cursor, VS Code, Claude Desktop, Gemini CLI, Codex, Goose, Zed, Devin CLI/Desktop, and more). MCP Management is an agent skill from CodeAlive-AI/ai-driven-development. Search, install, configure, update, and remove MCP servers across coding agents (Claude Code, Cursor, VS Code, Claude Desktop, Gemini CLI, Codex, Goose, Zed, Devin CLI/Desktop, and more).

When should I use MCP Management?

MCP Management fits situations like: tasks that involve MCP servers.

How do I install MCP Management in Claude Code?

Run `npx skills add CodeAlive-AI/ai-driven-development --skill mcp-management -a claude-code`. Or copy the skill folder (skills/mcp-management in CodeAlive-AI/ai-driven-development) into .claude/skills/mcp-management in your project. Claude Code loads it when a task matches its description.

How do I install MCP Management in Codex?

Run `npx skills add CodeAlive-AI/ai-driven-development --skill mcp-management -a codex`. Or copy the skill folder (skills/mcp-management in CodeAlive-AI/ai-driven-development) into .agents/skills/mcp-management in your project. Codex loads it when a task matches its description.

Can I use MCP Management in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add CodeAlive-AI/ai-driven-development --skill mcp-management -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mcp-management, .gemini/skills/mcp-management, .github/skills/mcp-management and .opencode/skills/mcp-management in your project.

What does MCP Management need to run?

Going by SKILL.md and its folder, MCP Management needs the command-line tools its instructions call (claude, codex, npx, opencode and supabase). Our summary lists: Node.js; A credential in EXAMPLE_API_KEY.

Does MCP Management access the network?

SKILL.md names 2 domains. In commands or code: mcp.stripe.com; the agent is likely to contact it when it follows the instructions. As links in the text: github.com. This is read from the text; nothing was executed.

Is MCP Management safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does MCP Management use?

MCP Management is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does MCP Management use?

About 2.3k tokens (SKILL.md is roughly 9.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 9k tokens, read only when the agent opens those files.

What are the alternatives to MCP Management?

Skills that share tags, products or a category with MCP Management: Cao MCP Apps (awslabs/cli-agent-orchestrator, 1.4k stars), CC Workflow Studio AI Editor (breaking-brake/cc-wf-studio, 5.4k stars), Agnix (agent-sh/agnix, 445 stars) and Claude Docs Consultant (centminmod/my-claude-code-setup, 2.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains MCP Management?

CodeAlive-AI (a GitHub organization) maintains it in CodeAlive-AI/ai-driven-development, which has 157 GitHub stars. The repository holds 22 skills in this directory. The repository was last updated on October 6, 2026.

Source: CodeAlive-AI/ai-driven-development on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.