agent-add-mcp — Claude Code skill: MCP setup
agent-add-mcp is a Claude Code skill that adds MCP servers to Warp configuration. It handles global or project scope and local or URL-based servers.
AGPL-3.0 ★ 720 updated 2026-11-10
npx skills add dominikmartn/harp --skill agent-add-mcp -a claude-codeWhat agent-add-mcp does
agent-add-mcp guides an agent through adding an MCP server to Warp configuration. It chooses between the global file ~/.warp/.mcp.json and the project file {repo_root}/.warp/.mcp.json, depending on the requested scope.
The skill inspects existing JSON, keeps its recognized wrapper key, and preserves current server entries. Local processes use command and args; HTTP/SSE connections use url. Secret values can be referenced with ${VAR_NAME}, while working_directory sets a different launch directory for relative paths.
When the target file is missing, the setup creates its directory with mkdir -p and starts with an mcpServers object. Warp detects saved .mcp.json changes without a restart, and lists the servers in Settings under MCP as “Detected from Warp”.
What it helps with
- add an MCP server to Warp for every session
- limit an MCP server to one repository
- preserve existing entries while editing
.mcp.json - configure either a local stdio process or an HTTP/SSE URL
- set a working directory for a relative server path
Example prompts for the agent
- Add
server-nameto Warp's global MCP configuration using a local command. - Configure an MCP server with a URL and
${API_KEY}in{repo_root}/.warp/.mcp.json. - Inspect the existing
.mcp.jsonand add the new server without removing current entries.
How to install agent-add-mcp
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill agent-add-mcp -a claude-code2Manually: put the files in place
~/.claude/skills/add-mcp-server/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/add-mcp-server/
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill agent-add-mcp -a codex2Manually: put the files in place
.agents/skills/add-mcp-server/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill agent-add-mcp -a cursor2Manually: put the files in place
.cursor/skills/add-mcp-server/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dominikmartn/harp resources/bundled/skills/add-mcp-server2Manually: put the files in place
.github/skills/add-mcp-server/SKILL.md1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill agent-add-mcp -a gemini-cli2Platform CLI
gemini skills install https://github.com/dominikmartn/harp --path resources/bundled/skills/add-mcp-serverManually: put the files in place
.devin/skills/add-mcp-server/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about agent-add-mcp
How do I install agent-add-mcp in Claude Code?
Run npx skills add dominikmartn/harp --skill agent-add-mcp -a claude-code, then place the skill file at ~/.claude/skills/add-mcp-server/SKILL.md.
What does agent-add-mcp do?
It guides MCP server setup in Warp, including global or repository scope, existing JSON structure, local processes, and URL-based connections.
What is required for agent-add-mcp to work?
Warp and the server connection details are required: either a local process command or a URL. Secret values can come from environment variables referenced as ${VAR_NAME}.