Agent skill

Add MCP Server to Warp

Adds an MCP server to Warp's global or project-level config file, keeping existing servers and choosing between command-based and URL-based setups.

AGPL-3.0Auto-check passedAgent Workflows

Install Add MCP Server to Warp

skills CLI

$ npx skills add warpdotdev/warp --skill agent-add-mcp -a claude-code

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

GitHub CLI

$ gh skill install warpdotdev/warp agent-add-mcp --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/warpdotdev/warp.git skills-src && mkdir -p .claude/skills && cp -r skills-src/resources/bundled/skills/add-mcp-server .claude/skills/agent-add-mcp && 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/

Paste into Claude Code

Install the "agent-add-mcp" agent skill from https://github.com/warpdotdev/warp/tree/master/resources/bundled/skills/add-mcp-server into .claude/skills/agent-add-mcp/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-add-mcp", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/warpdotdev/warp/tree/master/resources/bundled/skills/add-mcp-server

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add warpdotdev/warp --skill agent-add-mcp -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install warpdotdev/warp agent-add-mcp --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/warpdotdev/warp.git skills-src && mkdir -p .agents/skills && cp -r skills-src/resources/bundled/skills/add-mcp-server .agents/skills/agent-add-mcp && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "agent-add-mcp" agent skill from https://github.com/warpdotdev/warp/tree/master/resources/bundled/skills/add-mcp-server into .agents/skills/agent-add-mcp/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-add-mcp", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add warpdotdev/warp --skill agent-add-mcp -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install warpdotdev/warp agent-add-mcp --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/warpdotdev/warp.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/resources/bundled/skills/add-mcp-server .cursor/skills/agent-add-mcp && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "agent-add-mcp" agent skill from https://github.com/warpdotdev/warp/tree/master/resources/bundled/skills/add-mcp-server into .cursor/skills/agent-add-mcp/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-add-mcp", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/warpdotdev/warp.git --path resources/bundled/skills/add-mcp-server

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add warpdotdev/warp --skill agent-add-mcp -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install warpdotdev/warp agent-add-mcp --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/warpdotdev/warp.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/resources/bundled/skills/add-mcp-server .gemini/skills/agent-add-mcp && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "agent-add-mcp" agent skill from https://github.com/warpdotdev/warp/tree/master/resources/bundled/skills/add-mcp-server into .gemini/skills/agent-add-mcp/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-add-mcp", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install warpdotdev/warp agent-add-mcp

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add warpdotdev/warp --skill agent-add-mcp -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/warpdotdev/warp.git skills-src && mkdir -p .github/skills && cp -r skills-src/resources/bundled/skills/add-mcp-server .github/skills/agent-add-mcp && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "agent-add-mcp" agent skill from https://github.com/warpdotdev/warp/tree/master/resources/bundled/skills/add-mcp-server into .github/skills/agent-add-mcp/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-add-mcp", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add warpdotdev/warp --skill agent-add-mcp -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install warpdotdev/warp agent-add-mcp --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/warpdotdev/warp.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/resources/bundled/skills/add-mcp-server .opencode/skills/agent-add-mcp && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "agent-add-mcp" agent skill from https://github.com/warpdotdev/warp/tree/master/resources/bundled/skills/add-mcp-server into .opencode/skills/agent-add-mcp/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-add-mcp", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: agent-add-mcp
GitHub stars: 65k
Used in: 1 other repo
Token cost: ~812 tokens
SKILL.md length: 352 words
Files: 1
Skills in repo: 46
Repo updated: Oct 7, 2026
First seen: Oct 7, 2026
Licence: AGPL-3.0

At a glance

Adds an MCP server to Warp's global or project-level config file, keeping existing servers and choosing between command-based and URL-based setups.

Works in 4 steps: Determine Scope → Gather Server Details → Check and Prepare the Config File → …
Connecting a new MCP server to Warp
SKILL.md covers Step 1: Determine Scope, Step 2: Gather Server Details, Step 3: Check and Prepare the… and Step 4: Write the Server…, plus 1 more section
Needs API_KEY

What it does

The agent first asks whether the server should apply to every project, in `~/.warp/.mcp.json`, or only to one repository, in a `.warp/.mcp.json` file at the repository root. If you have not given connection details, it searches the web for the named server's configuration, and it asks whether the server should run as a local stdio command or be reached by URL over HTTP or SSE streaming.

It then creates the config file with an empty `mcpServers` wrapper if needed, or reads the existing file to see which wrapper key is already used, among `mcpServers`, `mcp_servers`, `servers`, `mcp.servers` or a flat map, and preserves it. Existing server entries are never removed. Stdio servers start from the repo root for project configs and the home directory for global ones, and a `working_directory` setting overrides that when the command uses relative paths.

When your agent uses it

Connecting a new MCP server to Warp
Choosing between a global and a repo-scoped MCP configuration
Editing an existing Warp MCP config without losing other servers

Example prompts

“Add the GitHub MCP server to my Warp setup for every project.”
“Set up an MCP server only for this repository, running from ./tooling/mcp/server.js.”
“Connect a remote MCP server by URL in Warp without touching my other servers.”

Requirements

Warp with native MCP config file support

Workflow steps

4 steps, taken from the step headings in SKILL.md.

Determine Scope
Gather Server Details
Check and Prepare the Config File
Write the Server Configuration

What it can do on your machine

Read from SKILL.md and the folder at commit f571865. 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
No scripts in the folder and no shell commands in SKILL.md (its code samples are json).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Add MCP Server to Warp loads about 812 tokens when it runs. Until then it costs about 23 tokens; SKILL.md has 352 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~23
When it runs · the whole SKILL.md, loaded when a task matches: ~812

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 warpdotdev/warp at commit f571865, republished under its AGPL-3.0 licence (© warpdotdev). 352 words, ~812 tokens.

Download SKILL.mdSave it as .claude/skills/agent-add-mcp/SKILL.md (or your agent's skills folder).

name: agent-add-mcp
description: Use this skill when helping users add MCP servers to their Warp configuration.

Adding MCP Servers to Warp

Warp supports MCP servers via native config files. Follow these steps when helping a user add an MCP server.

Step 1: Determine Scope

If the user hasn't specified, ask whether they want to configure the server globally (for all projects) or project-scoped (for a specific repository only).

Config file paths:

Global (user-scoped): ~/.warp/.mcp.json
Project-scoped: {repo_root}/.warp/.mcp.json

Step 2: Gather Server Details

If the user hasn't provided the server's connection details, use WebSearch to find the correct configuration for the named server.

If it's unclear whether the server should be run as a local CLI process (stdio transport) or connected to via URL (HTTP/SSE streaming transport), ask the user which they prefer.

Step 3: Check and Prepare the Config File

Check whether the target config file exists.

If it does not exist, create it with mkdir -p for the directory and initialize it with an empty mcpServers wrapper key:
json
```
{
  "mcpServers": {}
}
```
If it exists, read it to determine which top-level wrapper key is already in use. Recognized wrapper keys (in order of preference):
- mcpServers (preferred)
- mcp_servers
- servers
- mcp.servers (nested under a mcp key)
- Flat map (each top-level key is a server name)
Preserve the existing wrapper key when writing. If the existing key is unrecognized or incompatible, switch to mcpServers.

Never remove existing server entries — only add or update the new server.

Show full SKILL.md (129 more words)Show less

Step 4: Write the Server Configuration

Command-based server (stdio transport)

json

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@scope/package-name"],
      "env": {
        "API_KEY": "${API_KEY}"
      }
    }
  }
}

By default, Warp spawns stdio servers from the directory the config was discovered in:

Project-scoped configs ({repo_root}/.warp/.mcp.json) run from the repo root.
Global configs (~/.warp/.mcp.json, ~/.claude.json, etc.) run from the home directory.

If the server's command or args are relative paths (e.g. ./tooling/mcp/server.js) or the server expects a specific cwd, set working_directory to override the default:

json

{
  "mcpServers": {
    "server-name": {
      "command": "node",
      "args": ["./tooling/mcp/server.js"],
      "working_directory": "/absolute/path/to/repo"
    }
  }
}

URL-based server (HTTP/SSE streaming transport)

json

{
  "mcpServers": {
    "server-name": {
      "url": "https://example.com/mcp",
      "env": {
        "API_KEY": "${API_KEY}"
      }
    }
  }
}

For environment variables containing secrets, use ${VAR_NAME} syntax — Warp will substitute the value from the user's environment at runtime.

Notes

Warp auto-detects changes to .mcp.json files on save — no restart required.
Configured servers appear in Warp's Settings under MCP, labeled "Detected from Warp".
Global config applies across all sessions; project config only applies when working inside that repository.

Files

Just SKILL.md in resources/bundled/skills/add-mcp-server of warpdotdev/warp.

Open the folder on GitHubat commit f571865

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 warpdotdev/warp, which our catalogue first saw on October 7, 2026.

Heartcoolman/warp-cnresources/bundled/skills/add-mcp-server

Compare with similar skills

Add MCP Server to Warp 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.

Add MCP Server to Warp compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Add MCP Server to Warp this skillwarpdotdev/warp	65k	1 repos	~812	Automated safety check: Pass	AGPL-3.0	yesterday
MCP Server Builderanthropics/skills	180k	62 repos	~2.3k	Automated safety check: Pass	Apache-2.0	2 days ago
MCP Server BuildershareAI-lab/learn-claude-code	78k	5 repos	~1.2k	Automated safety check: Pass	MIT	9 days ago
MCP Integration for Pluginsanthropics/claude-plugins-official	37k	11 repos	~3.1k	Automated safety check: Pass	Apache-2.0	yesterday
Fastmcp Client CLIPrefectHQ/fastmcp	28k	1 repos	~823	Automated safety check: Pass	Apache-2.0	yesterday
Crush Configurationcharmbracelet/crush	29k	—	~3.7k	Automated safety check: Pass	Custom licence	yesterday

Similar skills

MCP Server Builder
anthropics/skills
Official
Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.
180k GitHub starsUsed in 62 repos~2.3k tokens
Agent WorkflowsAuto-check passed
MCP Server Builder
shareAI-lab/learn-claude-code
Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.
78k GitHub starsUsed in 5 repos~1.2k tokens
Agent WorkflowsAuto-check passed
MCP Integration for Plugins
anthropics/claude-plugins-official
Official
Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.
37k GitHub starsUsed in 11 repos~3.1k tokens
Agent WorkflowsAuto-check passed
Fastmcp Client CLI
PrefectHQ/fastmcp
Query and invoke tools on MCP servers using fastmcp list and fastmcp call.
28k GitHub starsUsed in 1 repo~823 tokens
Agent WorkflowsAuto-check passed
Crush Configuration
charmbracelet/crush
Explains how to configure the Crush coding agent with crushrc or crush.json, covering providers, models, LSPs, MCP servers, hooks, permissions and config precedence.
29k GitHub stars~3.7k tokensUpdated yesterday
Agent WorkflowsAuto-check passed
Context Mode Output Sandbox
mksglu/context-mode
Routes large command, file, API and browser output through context-mode tools so only the needed result enters the agent's context, instead of dumping it via Bash.
26k GitHub stars~4.1k tokensUpdated yesterday
Agent WorkflowsAuto-check passed

Questions about Add MCP Server to Warp

What does Add MCP Server to Warp do?

Adds an MCP server to Warp's global or project-level config file, keeping existing servers and choosing between command-based and URL-based setups. json` file at the repository root. If you have not given connection details, it searches the web for the named server's configuration, and it asks whether the server should run as a local stdio command or be reached by URL over HTTP or SSE streaming.

When should I use Add MCP Server to Warp?

Add MCP Server to Warp fits situations like: connecting a new MCP server to Warp; choosing between a global and a repo-scoped MCP configuration; editing an existing Warp MCP config without losing other servers.

How do I install Add MCP Server to Warp in Claude Code?

Run `npx skills add warpdotdev/warp --skill agent-add-mcp -a claude-code`. Or copy the skill folder (resources/bundled/skills/add-mcp-server in warpdotdev/warp) into .claude/skills/agent-add-mcp in your project. Claude Code loads it when a task matches its description.

How do I install Add MCP Server to Warp in Codex?

Run `npx skills add warpdotdev/warp --skill agent-add-mcp -a codex`. Or copy the skill folder (resources/bundled/skills/add-mcp-server in warpdotdev/warp) into .agents/skills/agent-add-mcp in your project. Codex loads it when a task matches its description.

Can I use Add MCP Server to Warp 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 warpdotdev/warp --skill agent-add-mcp -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agent-add-mcp, .gemini/skills/agent-add-mcp, .github/skills/agent-add-mcp and .opencode/skills/agent-add-mcp in your project.

What does Add MCP Server to Warp need to run?

Going by SKILL.md and its folder, Add MCP Server to Warp needs credentials named API_KEY. Our summary lists: Warp with native MCP config file support.

Does Add MCP Server to Warp access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Add MCP Server to Warp 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 Add MCP Server to Warp use?

Add MCP Server to Warp is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Add MCP Server to Warp use?

About 812 tokens (SKILL.md is roughly 3.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Add MCP Server to Warp?

Skills that share tags, products or a category with Add MCP Server to Warp: MCP Server Builder (anthropics/skills, 180k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), MCP Integration for Plugins (anthropics/claude-plugins-official, 37k stars) and Fastmcp Client CLI (PrefectHQ/fastmcp, 28k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Add MCP Server to Warp?

warpdotdev (a GitHub organization) maintains it in warpdotdev/warp, which has 65,380 GitHub stars. The repository holds 46 skills in this directory. The repository was last updated on October 7, 2026.

Source: warpdotdev/warp on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Add MCP Server to Warp

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Adding MCP Servers to Warp

Step 1: Determine Scope

Step 2: Gather Server Details

Step 3: Check and Prepare the Config File

Step 4: Write the Server Configuration

Command-based server (stdio transport)

URL-based server (HTTP/SSE streaming transport)

Notes

Files

Used in 1 other repository

Compare with similar skills

Similar skills

More from warpdotdev/warp

Related

Questions about Add MCP Server to Warp