/morph-apply

name: morph-apply
description: Fast file editing via Morph Apply API (10,500 tokens/sec, 98% accuracy)
allowed-tools: [Bash, Read]

Morph Fast Apply

Fast, AI-powered file editing using the Morph Apply API. Edit files without reading them first. Processes at 10,500 tokens/sec with 98% accuracy.

When to Use

• Fast file edits without reading entire file first
• Batch edits to a file (multiple changes in one operation)
• When you know what to change but file is large
• Large files where reading would consume too many tokens

Key Pattern: Code Markers

Use `// ... existing code ...` (or language-appropriate comments) to mark where edits go:

# ... existing code ...
try:
    result = process()
except Exception as e:
    log.error(e)
# ... existing code ...

The API intelligently places your edit in the right location.

Usage

Add error handling

uv run python -m runtime.harness scripts/mcp/morph_apply.py \
    --file "src/auth.py" \
    --instruction "Add error handling to login function" \
    --code_edit "# ... existing code ...
try:
    user = authenticate(credentials)
except AuthError as e:
    log.error(f'Auth failed: {e}')
    raise
# ... existing code ..."

Add logging

uv run python -m runtime.harness scripts/mcp/morph_apply.py \
    --file "src/api.py" \
    --instruction "Add debug logging" \
    --code_edit "# ... existing code ...
logger.debug(f'Processing request: {request.id}')
# ... existing code ..."

TypeScript example

uv run python -m runtime.harness scripts/mcp/morph_apply.py \
    --file "src/types.ts" \
    --instruction "Add user validation" \
    --code_edit "// ... existing code ...
if (!user) throw new Error('User not found');
if (!user.isActive) throw new Error('User inactive');
// ... existing code ..."

Parameters

| Parameter | Description | |-----------|-------------| | `--file` | File path to edit (required) | | `--instruction` | Human description of the change (required) | | `--code_edit` | Code snippet with markers showing where to place edit (required) |

vs Claude's Edit Tool

| Tool | Best For | |------|----------| | **morph-apply** | Fast edits, don't need to read file first, large files, batch edits | | **Claude Edit** | Small precise edits when file is already in context |

**Use morph-apply when:**

• File is not in context and reading it would be expensive
• File is very large (>500 lines)
• Making multiple related edits at once
• You know the context of the change (function name, class, etc.)

**Use Claude Edit when:**

• File is already in context from prior Read
• Very precise edits requiring exact old/new string matching
• Small files (<200 lines)

MCP Server Required

Requires `morph` server in mcp_config.json with `MORPH_API_KEY`.

Performance

• **Speed**: 10,500 tokens/sec
• **Accuracy**: 98% correct placement
• **Token savings**: Don't need to read entire file first