Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add dominikmartn/harp --skill agent-add-mcp -a claude-code
Open on GitHub

What 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-name to 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.json and 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-code

2Manually: put the files in place

~/.claude/skills/add-mcp-server/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/add-mcp-server/

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}.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set62

The whole set →
update-tab-config update-tab-config is a Claude Code skill that edits existing Warp tab TOML configs from natural-language requests. It targets files already open or present in the project. CX Codex +1 ★ 720repo stars create-tab-config The create-tab-config skill for Claude Code generates TOML configuration files for Warp terminal layouts. It triggers when a user requests a new tab configuration or layout. CX Codex +1 ★ 720repo stars dedupe-issue-local dedupe-issue-local is a Claude Code skill that refines issue deduplication for the Warp repository. It adds repository rules for terminal, agent, MCP, and UI reports. CX Codex +1 ★ 720repo stars modify-settings modify-settings is a Claude Code skill that inspects and edits Warp terminal preferences using JSON Schema. It updates the user TOML configuration without breaking nested sections. CX Codex +1 ★ 720repo stars add-feature-flag add-feature-flag is a Claude Code skill that integrates feature flags into the Warp codebase. It isolates experimental code and manages rollouts across release channels. CX Codex +1 ★ 720repo stars gui-ui-guidelines gui-ui-guidelines is a Claude Code skill for Warp’s graphical UI. It is read before UI changes in the repository so its rules guide the implementation. CX Codex +1 ★ 720repo stars test-warp-ui The test-warp-ui skill for Claude Code automates visual testing of Warp interface features. It is used with the computer_use tool to launch the app and verify UI behavior. CX Codex +1 ★ 720repo stars remove-feature-flag remove-feature-flag is a Claude Code skill that removes a stabilized feature flag from Warp code. It runs after the feature reaches all users and production is stable. CX Codex +1 ★ 720repo stars

Project sponsors

Companies that keep this analytics open