add-mcp-server

Automate MCP server configuration in Warp for global and project scopes.

64.1k|5.4k|Updated Jul 8, 2021
One-click install
npx skills add https://github.com/warpdotdev/warp --skill add-mcp-server-warpdotdev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-mcp-server
Source: https://github.com/warpdotdev/warp/tree/main/resources/bundled/skills/add-mcp-server
Command: npx skills add https://github.com/warpdotdev/warp --skill add-mcp-server-warpdotdev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps operators configure MCP servers in Warp by guiding scope, transport choices, and config file integration.

Core Features & Use Cases

  • Guided scope selection for global or project-scoped Warp configurations.
  • Config creation and updates for MCP server entries in .warp/.mcp.json or the equivalent global config.
  • Transport handling for both command-based (stdio) and URL-based servers, with environment variable substitution.

Quick Start

Provide the server name and preferred transport (stdio or URL), and let this skill create or update the Warp MCP configuration accordingly.

Frequently Asked Questions about add-mcp-server

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure an MCP server in Warp?

Configuring an MCP server in Warp involves providing the server name and transport type so the skill can create or update entries in your .mcp.json file. It supports both global and project-scoped setups automatically.

Can I add both stdio and URL-based MCP servers to my Warp config?

Yes, Warp supports both stdio and URL-based MCP servers. The skill applies the correct configuration structure for each transport type, whether command-based or URL-based, directly in your file.

How do I safely add environment variables to my MCP server configuration?

Safely adding environment variables to your MCP server configuration uses the skill's environment variable substitution for sensitive values. This prevents hardcoding secrets directly in your .mcp.json files.

Will updating an MCP server entry overwrite my existing Warp configuration?

No, updating an MCP server entry will not overwrite your existing Warp configuration. The skill reads existing .mcp.json files, preserves current server entries, and only modifies the specific wrapper keys you target.

What is the difference between global and project-scoped MCP server setups in Warp?

Global setups apply MCP servers across all projects, while project-scoped setups use .warp/.mcp.json to restrict server availability to the current project directory. The skill offers guided selection for this scope.

What config file wrapper formats are supported for adding MCP servers?

Supported wrapper formats for adding MCP servers include mcpServers, mcp_servers, servers, mcp.servers, or a flat map. The skill detects and updates the appropriate wrapper key in your JSON or YAML config files.