How to Use the JSON Merge Patch MCP in Claude Code

Q: How do I configure the JSON Merge Patch MCP Server in Claude Code?

Run claude mcp add --transport http json-merge-patch-mcp -- . Place all flags before the server name. The configuration saves automatically to your /.claude.json file.

Pipe massive JSON files through Claude Code and apply RFC 7396 delta patches right from your terminal.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect JSON Merge Patch MCP to Claude Code

Create your Vinkius account to connect JSON Merge Patch to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup JSON Merge Patch with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run delta updates in headless pipelines

The `apply_patch` tool accepts your source JSON and target modifications as plain strings. Claude Code executes the merge operation directly in your shell environment. You script the entire sequence without opening an editor. You define the patch requirements in your deployment script. The CLI client reads the current state, computes the difference, and hits the MCP Server endpoint. The deterministic engine returns the exact merged output required for the next pipeline step.

Prevent state drift in infrastructure

The `apply_patch` tool on this MCP Server enforces strict RFC 7396 compliance to avoid data corruption. Forcing a full file rewrite on a massive Terraform state or Kubernetes manifest is a massive risk. You pass only the delta. If you need to drop a deprecated configuration block, you set the key to null. The engine processes the string and strips the node out entirely. The output remains structurally sound.

Integrate with existing shell workflows

The `apply_patch` tool operates on standard input and output streams. You pipe your existing JSON artifacts straight into the agent. The client handles the context parsing. It constructs the required patch object and executes the remote MCP Server call. You grab the resulting stdout and pipe it directly into jq or write it back to disk.

Setup guide

Set up JSON Merge Patch MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see json-merge-patch-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest JSON Merge Patch transactions." It will automatically discover and invoke the available JSON Merge Patch tools.

Terminal

claude mcp add --transport http json-merge-patch-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the JSON Merge Patch MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "json-merge-patch-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by JSON Merge Patch. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect JSON Merge Patch now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about JSON Merge Patch MCP in Claude Code

Run `claude mcp add --transport http json-merge-patch-mcp -- `. Place all flags before the server name. The configuration saves automatically to your ~/.claude.json file.

Yes. The CLI client runs headlessly. You pass the instructions and the patch file via standard input during the build step.

Standard command-line tools require hardcoded paths for every update. The agent figures out the required structural changes dynamically and generates the correct patch string on the fly.

The RFC standard dictates that arrays are replaced entirely, not merged by index. The client generates a full replacement array in the patch string if you need to modify list items.

This MCP Server only requires the specific JSON string payloads necessary for the merge operation. Vinkius isolates the execution in a sandboxed V8 environment, ensuring your sensitive deployment manifests are never written to persistent storage.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript