How to Use the Voice Leading Checker MCP in Windsurf

Validate classical harmonic movement and counterpoint rules automatically with Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Voice Leading Checker MCP to Windsurf

Create your Vinkius account to connect Voice Leading Checker 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 Voice Leading Checker with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run Multi-Step Voice Leading Checks on the MCP Server

Need to check if a sequence of chord voicings follows strict counterpoint rules? Your agent handles that. It starts by running `analyze_voice_conduction` to map note movements between adjacent chords, assessing the technical plausibility of the transition. After conduction analysis, it runs two more checks: one validates the proper ascending order of voices in a given voicing, and the second evaluates the overall smoothness score for the passage. Windsurf's Cascade figures out the full sequence without you prompting every step.

Analyze Voicings with Your AI Client

This MCP lets your agent check if the notes are structured correctly according to classical rules. The `check_voice_hierarchy` tool verifies that all voices maintain their correct ascending order within a single chord voicing, which is key for harmonic clarity. It's perfect when you're composing or transcribing and need instant feedback on structure. You just give it the voicings, and your agent handles the rest of the analysis.

Evaluate Musical Transitions with Windsurf

Composition requires more than just correct notes; transitions must sound good. The MCP provides a direct measure of that quality using `evaluate_smoothness`. This tool grades the transition between chords, giving you a measurable score for how well the music flows. When your goal is to refine a piece's emotional impact or polish a section for publication, knowing the exact smoothness metric helps you know exactly what needs fixing.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "voice-leading-checker-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 Voice Leading Checker. 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 Voice Leading Checker 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 Voice Leading Checker MCP in Windsurf

Windsurf's agent automatically chains the necessary tools. It first maps note conduction, then checks for correct voice hierarchy, and finally assigns a smoothness score. This gives you a full structural report in one go.

Yes. Because the MCP runs within Vinkius's secure sandbox, it can process complex inputs derived from various sources. The tool is designed to handle multiple chords and voicings in a single analysis run.

Absolutely. Since the MCP is built on classical harmonic principles, it's ideal for academic work. You can test specific theoretical constraints by running multiple analyses and comparing results across different sections of your piece.

You can set the goal to analyze an entire movement's worth of data. The agent will then break it down into smaller, manageable chord transitions and report on each one's adherence to voice-leading rules.

This MCP primarily handles structured musical notation data, including chord voicings (pitch classes) and sequential relationships. It processes the notes themselves, not personal user identifiers.

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