How to Use the JSON Merge Patch MCP in Windsurf

Q: How do I install the JSON Merge Patch MCP Server in Windsurf?

Open the MCP Servers UI under Settings or edit your mcpconfig.json directly. Add the server details and click Refresh in the panel. Cascade auto-discovers the tools immediately.

Stop losing data during massive file updates. Windsurf applies precise JSON delta patches without rewriting the whole object.

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 Windsurf

Create your Vinkius account to connect JSON Merge Patch to Windsurf 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 Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Update massive configurations in Windsurf

The `apply_patch` tool processes RFC 7396 merge rules directly against your target files. Windsurf reads the original state, computes the necessary delta, and executes the patch. You avoid the token limits that usually truncate large documents during a rewrite. Cascade handles the execution pipeline autonomously. You set the end goal for the data structure. The agent fetches the base file, generates the exact JSON strings needed for the modification, and runs the patch command. The MCP Server result is deterministic and atomic.

Prevent state corruption on deep merges

The `apply_patch` tool prevents full document rewrites from wiping out nested keys when an agent drops context. This MCP Server forces the client to only declare what changes. If a key is null, the engine deletes it. If an object is new, it merges it. You keep your existing data intact. The engine parses the original and patch strings, applying the standard algorithm. Cascade verifies the output structure matches your schema requirements before moving on to the next task.

Bypass token limits for large datasets

The `apply_patch` tool bypasses token limits by isolating the update mechanism to specific node changes. Sending a massive localization file back and forth to an LLM burns tokens and guarantees truncation. Windsurf plans the operation locally. It extracts the target section, formulates the exact patch string, and hands both to the MCP Server integration. You get a fully updated file without the network overhead or context window exhaustion.

Setup guide

Set up JSON Merge Patch MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
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

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my JSON Merge Patch payment history." If connected, Cascade will call the JSON Merge Patch tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "json-merge-patch-mcp": {
      "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 Windsurf

Open the MCP Servers UI under Settings or edit your mcp_config.json directly. Add the server details and click Refresh in the panel. Cascade auto-discovers the tools immediately.

Yes. Set the target key's value to null in your patch string. The RFC 7396 standard dictates that null values remove the key from the parent object.

File rewrites risk data loss when context windows max out. Patching forces the agent to only touch the specific nodes that need updates. You eliminate truncation errors completely.

The engine rejects invalid JSON strings before attempting the merge. Windsurf catches the error, corrects the syntax, and retries the operation autonomously.

The engine only processes the specific JSON strings passed to the tool. Execution happens entirely within the V8 Isolate Sandbox. Your raw configuration files never leave the local environment during the merge operation.

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