Documentation Index
Fetch the complete documentation index at: https://docs.morphllm.com/llms.txt
Use this file to discover all available pages before exploring further.
Coding agents waste tokens on full-file rewrites and unfocused searches. Morph MCP gives your agent codebase_search (WarpGrep exploration subagent) and edit_file (10,500 tok/s partial edits) with zero code changes.
| Tool | Default | Description |
|---|
codebase_search | Enabled | WarpGrep exploration subagent for your local workspace. Takes a natural-language query (“How does auth work?”) and runs parallel grep + file reads over multiple turns to find relevant files and line ranges. Use first when exploring unfamiliar code. |
github_codebase_search | Enabled | WarpGrep exploration for public GitHub repositories — no clone required. Takes owner/repo plus a natural-language query. Use when debugging third-party dependencies or investigating upstream bugs. |
edit_file | Disabled | Morph Fast Apply: 10,500+ tok/s partial edits using // ... existing code ... placeholders. Off by default so it doesn’t collide with client-native editors — enable by setting DISABLED_TOOLS="" in the MCP env. |
npx -y @morphllm/morph-setup --morph-api-key YOUR_API_KEY
Logged in? Your API key auto-fills above. Otherwise, get it from your dashboard. | Tool | Default | Description |
|---|
codebase_search | Enabled | WarpGrep exploration subagent for your local workspace. Takes a natural-language query (“How does auth work?”) and runs parallel grep + file reads over multiple turns to find relevant files and line ranges. Use first when exploring unfamiliar code. |
github_codebase_search | Enabled | WarpGrep exploration for public GitHub repositories — no clone required. Takes owner/repo plus a natural-language query. Use when debugging third-party dependencies or investigating upstream bugs. |
edit_file | Disabled | Morph Fast Apply: 10,500+ tok/s partial edits using // ... existing code ... placeholders. Off by default so it doesn’t collide with client-native editors — enable by setting DISABLED_TOOLS="" in the MCP env. |
Installation (All Clients)
2. Configure Your MCP Client
Claude Code
Codex
Cursor
Claude Desktop
VS Code
Manual
One-liner Installation (Recommended):claude mcp add filesystem-with-morph --scope user -e MORPH_API_KEY=YOUR_API_KEY -- npx -y @morphllm/morphmcp
Configure Claude to prefer Morph: Add this to your global Claude config:mkdir -p ~/.claude && echo "Fast Apply: IMPORTANT: Use \`edit_file\` over \`str_replace\` or full file writes. It works with partial code snippets—no need for full file content.
Warp Grep: warp-grep is a subagent that takes in a search string and tries to find relevant context. Best practice is to use it at the beginning of codebase explorations to fast track finding relevant files/lines. Do not use it to pin point keywords, but use it for broader semantic queries. \"Find the XYZ flow\", \"How does XYZ work\", \"Where is XYZ handled?\", \"Where is <error message> coming from?\"" >> ~/.claude/CLAUDE.md
.claude.json in your workspace:{
"mcpServers": {
"filesystem-with-morph": {
"env": {
"MORPH_API_KEY": "YOUR_API_KEY"
},
"command": "npx -y @morphllm/morphmcp",
"args": []
}
}
}
CLI Installation (Recommended):# Add Morph MCP server to Codex
codex mcp add morph-mcp --env MORPH_API_KEY=YOUR_API_KEY -- npx -y @morphllm/morphmcp
~/.codex/config.toml:[mcp_servers.filesystem-with-morph]
env = { "MORPH_API_KEY" = "YOUR_API_KEY" }
command = "npx -y @morphllm/morphmcp"
args = []
# Optional: adjust timeouts
startup_timeout_sec = 10
tool_timeout_sec = 60
CLI Management: Use codex mcp list to see configured servers and codex mcp remove filesystem-with-morph to remove.
Add to your AGENTS.md:Fast Apply: IMPORTANT: Use `edit_file` over `str_replace` or full file writes. It works with partial code snippets—no need for full file content.
Warp Grep: warp-grep is a subagent that takes in a search string and tries to find relevant context. Best practice is to use it at the beginning of codebase explorations to fast track finding relevant files/lines. Do not use it to pin point keywords, but use it for broader semantic queries. "Find the XYZ flow", "How does XYZ work", "Where is XYZ handled?", "Where is <error message> coming from?"
Add to your Cursor MCP by clicking this button: 
OR add to your Cursor MCP config file:Location: ~/.cursor/mcp.json{
"mcpServers": {
"morph-mcp": {
"env": {
"MORPH_API_KEY": "YOUR_API_KEY"
},
"command": "npx -y @morphllm/morphmcp",
"args": []
}
}
}
Global Config: This configuration works across all your projects automatically. The MCP server detects workspace boundaries via .git, package.json, and other project indicators.
Make Cursor use Morph tools! Add this to your system prompt in Settings → Rules for AI:Fast Apply: IMPORTANT: Use `edit_file` over `str_replace` or full file writes. It works with partial code snippets—no need for full file content.
Warp Grep: warp-grep is a subagent that takes in a search string and tries to find relevant context. Best practice is to use it at the beginning of codebase explorations to fast track finding relevant files/lines. Do not use it to pin point keywords, but use it for broader semantic queries. "Find the XYZ flow", "How does XYZ work", "Where is XYZ handled?", "Where is <error message> coming from?"
Add to your Claude Desktop config file:macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json{
"mcpServers": {
"filesystem-with-morph": {
"env": {
"MORPH_API_KEY": "YOUR_API_KEY"
},
"command": "npx -y @morphllm/morphmcp",
"args": []
}
}
}
Restart Required: Completely quit and restart Claude Desktop to load the new configuration.
Add to your project instructions:Fast Apply: IMPORTANT: Use `edit_file` over `str_replace` or full file writes. It works with partial code snippets—no need for full file content.
Warp Grep: warp-grep is a subagent that takes in a search string and tries to find relevant context. Best practice is to use it at the beginning of codebase explorations to fast track finding relevant files/lines. Do not use it to pin point keywords, but use it for broader semantic queries. "Find the XYZ flow", "How does XYZ work", "Where is XYZ handled?", "Where is <error message> coming from?"
CLI Installation (Recommended):code --add-mcp '{"name":"morph-mcp","command":"npx","args":["-y","@morphllm/morphmcp"],"envVars":{"MORPH_API_KEY":"YOUR_API_KEY"}}'
MCP: Add Server, enter the server details, and select Global to save to your user profile.Manual Config File:Run MCP: Open User Configuration from the Command Palette, or add to your user-level mcp.json:{
"mcpServers": {
"filesystem-with-morph": {
"env": {
"MORPH_API_KEY": "YOUR_API_KEY"
},
"command": "npx -y @morphllm/morphmcp",
"args": []
}
}
}
Add to your .github/copilot-instructions.md:Fast Apply: IMPORTANT: Use `edit_file` over `str_replace` or full file writes. It works with partial code snippets—no need for full file content.
Warp Grep: warp-grep is a subagent that takes in a search string and tries to find relevant context. Best practice is to use it at the beginning of codebase explorations to fast track finding relevant files/lines. Do not use it to pin point keywords, but use it for broader semantic queries. "Find the XYZ flow", "How does XYZ work", "Where is XYZ handled?", "Where is <error message> coming from?"
Run the MCP server directly:export MORPH_API_KEY="YOUR_API_KEY"
npx -y @morphllm/morphmcp
3. Test Installation
Claude Code: Type /mcp and /tools to see Morph’s edit_file tool
Codex: Run codex mcp list to verify server is configured, then make edit requests
Cursor/VS Code: Make any code edit request - should use Morph automatically
Manual: Check server logs show “MCP Server started successfully”
Configuration
| Variable | Default | Description |
|---|
MORPH_API_KEY | Required | Your API key |
WORKSPACE_MODE | "true" | Auto workspace detection |
DEBUG | "false" | Debug logging |
Advanced Configuration
| Variable | Default | Description |
|---|
MORPH_API_URL | https://api.morphllm.com | Override the Morph API base URL (for proxies) |
MORPH_WARP_GREP_TIMEOUT | 30000 | Timeout for Warp Grep model calls in milliseconds |
{
"mcpServers": {
"morph-mcp": {
"env": {
"MORPH_API_KEY": "<user-jwt-token>",
"MORPH_API_URL": "https://your-proxy.example.com"
},
"command": "npx -y @morphllm/morphmcp",
"args": []
}
}
}
/v1/chat/completions with the token in the Authorization: Bearer header. Forward these to https://api.morphllm.com/v1/chat/completions after handling auth/billing.
Warp Grep timeout — Increase for large codebases or slow networks:
{
"mcpServers": {
"morph-mcp": {
"env": {
"MORPH_API_KEY": "sk-xxx",
"MORPH_WARP_GREP_TIMEOUT": "60000"
},
"command": "npx -y @morphllm/morphmcp",
"args": []
}
}
}
codebase_search and github_codebase_search are enabled out of the box. edit_file ships disabled to avoid conflicting with client-native editors — opt in by setting DISABLED_TOOLS="" (or any value that doesn’t include edit_file) in the MCP server env.
{
"mcpServers": {
"morph-mcp": {
"env": {
"MORPH_API_KEY": "YOUR_API_KEY",
"DISABLED_TOOLS": ""
},
"command": "npx -y @morphllm/morphmcp",
"args": []
}
}
}
Troubleshooting
Server won’t start: Check API key, Node.js 16+, run npm cache clean --force
Tools missing: Restart client, validate JSON config
Workspace issues: Add .git or package.json, or set WORKSPACE_MODE="false"
Slow performance: Use edit_file over write_file, check network to api.morphllm.com
Best Practices
- Use
edit_file for modifications: Much faster than reading + writing entire files
- Minimize edit scope: Include only the sections that need changes
- Batch related edits: Make multiple changes in a single
edit_file call
| Method | Speed | Use Case |
|---|
edit_file (Morph) | ~11 seconds | Code modifications, updates |
| Search & replace | ~20 seconds | Simple text substitutions |
| Traditional read/write | ~60 seconds | Full file rewrites |
