How do I install the MCP Installer skill?

Run npx skillmds@latest add knuckles-team/mcp-installer in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is MCP Installer safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with MCP Installer?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is MCP Installer free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published MCP Installer?

Knuckles-Team (@knuckles-team) published this skill. Their other Agent Skills are listed on their SkillMD profile.

MCP Installer by knuckles-team — Agent Skill

Name: MCP Installer
Author: Knuckles-Team

MCP Installer

Install and merge a pre-configured MCP JSON file for Windsurf, Claude Code, Claude Desktop, OpenCode, Antigravity, Devin, agent-utilities, or an explicit JSON target. Use when an MCP client supports the mcpServers JSON convention; use the client's native command instead for Codex registration.

Knuckles-Team 71f462d 2 files · 10.9 KB Updated Sep 17, 2026

File contents

MCP Installer Skill

Use scripts/install.py to merge a pre-configured mcp_config.json into a supported JSON-based client's configuration.

Supported Tools

windsurf: ~/.codeium/windsurf/mcp_config.json
claude: ~/.claude.json (Claude Code)
claude-desktop: ~/.config/Claude/claude_desktop_config.json (Linux XDG path)
opencode: ~/.config/opencode/mcp.json
antigravity: ~/.gemini/antigravity/mcp_config.json
agent-utilities / agent-terminal-ui: ~/.config/agent-utilities/mcp_config.json
devin: ~/.config/devin/mcp_config.json

Codex is intentionally not a JSON target. Register servers through its native codex mcp add command so Codex owns the corresponding config.toml entry. For GraphOS, agent-utilities provides setup-config codex, which canonicalizes this portable launcher without env, secrets, or machine paths:

codex mcp add graph-os -- graph-os --transport stdio

Tools

install_mcp_config

Install an mcp_config.json file into a target tool's configuration directory. It merges the mcpServers object so you don't lose your existing configuration, unless you specify --force.

Arguments

--config: The path to the source mcp_config.json file you want to install.
--tool: The JSON-config target tool (windsurf, claude, claude-desktop, opencode, antigravity, devin).
--path: (Optional) Explicit custom path to the target configuration file.
--force: (Optional) Overwrite existing configuration entirely rather than merging mcpServers.

Examples

# Install into Windsurf
python scripts/install.py --config ./my_mcp_config.json --tool windsurf

# Install into Antigravity (Agent Utilities XDG dir)
python scripts/install.py --config ./mcp_config.json --tool antigravity

# Install into Claude Code
python scripts/install.py --config /path/to/mcp_config.json --tool claude

# Install into a custom configuration file explicitly
python scripts/install.py --config ./mcp_config.json --path ~/.my_custom_agent/mcp.json

---name: mcp-installerdescription: Install and merge a pre-configured MCP JSON file for Windsurf, Claude Code, Claude Desktop, OpenCode, Antigravity, Devin, agent-utilities, or an explicit JSON target. Use when an MCP client supports the mcpServers JSON convention; use the client's native command instead for Codex registration.license: MIT---# MCP Installer SkillUse `scripts/install.py` to merge a pre-configured `mcp_config.json` into asupported JSON-based client's configuration.## Supported Tools- **windsurf**: `~/.codeium/windsurf/mcp_config.json`- **claude**: `~/.claude.json` (Claude Code)- **claude-desktop**: `~/.config/Claude/claude_desktop_config.json` (Linux XDG path)- **opencode**: `~/.config/opencode/mcp.json`- **antigravity**: `~/.gemini/antigravity/mcp_config.json`- **agent-utilities** / **agent-terminal-ui**: `~/.config/agent-utilities/mcp_config.json`- **devin**: `~/.config/devin/mcp_config.json`Codex is intentionally not a JSON target. Register servers through its native`codex mcp add` command so Codex owns the corresponding `config.toml` entry. ForGraphOS, agent-utilities provides `setup-config codex`, which canonicalizes thisportable launcher without env, secrets, or machine paths:```bashcodex mcp add graph-os -- graph-os --transport stdio```## Tools### install_mcp_configInstall an `mcp_config.json` file into a target tool's configuration directory. It merges the `mcpServers` object so you don't lose your existing configuration, unless you specify `--force`.#### Arguments- `--config`: The path to the source `mcp_config.json` file you want to install.- `--tool`: The JSON-config target tool (windsurf, claude, claude-desktop, opencode, antigravity, devin).- `--path`: (Optional) Explicit custom path to the target configuration file.- `--force`: (Optional) Overwrite existing configuration entirely rather than merging `mcpServers`.#### Examples```bash# Install into Windsurfpython scripts/install.py --config ./my_mcp_config.json --tool windsurf# Install into Antigravity (Agent Utilities XDG dir)python scripts/install.py --config ./mcp_config.json --tool antigravity# Install into Claude Codepython scripts/install.py --config /path/to/mcp_config.json --tool claude# Install into a custom configuration file explicitlypython scripts/install.py --config ./mcp_config.json --path ~/.my_custom_agent/mcp.json```

Frequently asked questions