How to Use the JSON Diff Visualizer MCP in Windsurf

Let Windsurf's Cascade agent show you exactly what it changed. This adds a proper JSON diff tool to your autonomous workflows.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect JSON Diff Visualizer MCP to Windsurf

Create your Vinkius account to connect JSON Diff Visualizer 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 Diff Visualizer with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

See Changes Between Autonomous Steps

The `diff_json` tool compares two JSON strings and generates a visual, color-coded report. Additions are green, removals are red. It's like `git diff`, but it understands JSON structure. Now when Windsurf's Cascade agent refactors a config file or processes API data, it can show you the exact changes. You don't have to manually inspect the before and after. The agent runs the diff for you, proving its work in the execution log.

Verify API and Configuration Payloads

Use this to confirm that data is what you expect. Your Cascade plan can fetch a payload from an API, then use `diff_json` to compare it against a known-good schema or a previous version. This is perfect for catching unexpected changes in external services or validating that a deployment manifest matches the staging environment. Cascade can halt the plan if the diff isn't empty, preventing bad data from moving downstream.

Get Both Human and Machine Diffs

This MCP Server tool doesn't just give you one output. You get a human-readable visual diff for your logs and a structured JSON diff for your agent. Cascade can parse the structured output to make decisions. For example, it could check if the `version` key has changed, and if so, trigger a completely different tool chain. It gives your agent real intelligence about data changes.

Setup guide

Set up JSON Diff Visualizer 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 Diff Visualizer 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 Diff Visualizer payment history." If connected, Cascade will call the JSON Diff Visualizer tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "json-diff-visualizer-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-diff. 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 Diff Visualizer 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 Diff Visualizer MCP in Windsurf

In your Cascade plan, add a step after an API call to invoke `diff_json`. Pass the API response and a stored 'expected' JSON. Cascade can then read the diff's output to either show you the changes or automatically flag a problem.

Yes, it's smarter. A text diff gets confused by reordered keys or simple whitespace changes. This tool understands JSON structure, so it only shows you meaningful changes to the data itself, not formatting noise.

Absolutely. Your Cascade agent can read two local JSON files, pass their contents to the `diff_json` tool, and then print the resulting visual diff to the output panel. It's a great way to check configuration drift.

Find the JSON Diff Visualizer in Windsurf's built-in MCP Marketplace and click install. Cascade will automatically discover the `diff_json` tool and you can start using it in your plans right away.

It's processed and forgotten. The two JSON strings you provide are sent to a Vinkius sandbox, used to create the diff, and then wiped. The server is ephemeral and doesn't write your payload data to any 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