How to Use the Chord Constructor MCP in Windsurf

Q: Can I use Chord Constructor in Windsurf to manage different voicings?

Yep. You can tell your agent to run generatevoicings and then follow up by calculating inversions using getchordinversions. It handles both 'closed' and 'open' textures automatically.

Q: If I run Chord Constructor in Windsurf, what kind of input does it take?

It accepts standard chord name strings, which the parsechordstring tool breaks down into root notes and intervals. You'll get structured data defining the component parts.

Build complex musical theory models automatically. The Chord Constructor MCP Server works with your AI client.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Chord Constructor MCP to Windsurf

Create your Vinkius account to connect Chord Constructor 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 Chord Constructor with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Analyzing Theory in Windsurf

Windsurf's Cascade agent handles the hard parts of music theory for you. Start by running `parse_chord_string` to convert any chord notation into notes, intervals, and a normalized name. Once parsed, your agent can chain tools like `determine_harmonic_role` to figure out exactly where a chord fits in the key. It doesn't just read the data; it maps out the whole structural relationship.

Structuring Voicings for Windsurf

Need specific textures? Cascade can manage that. You tell your agent to generate voicings, and it uses `generate_voicings` to return both 'closed' and 'open' musical arrangements of the notes. It also figures out inversions using `get_chord_inversions`. This tool calculates all possible chord permutations based on which note you want in the bass. It makes sure your arrangement sounds professional.

Chaining Logic with Windsurf

The best part is combining these steps. Cascade can take a raw progression, run `parse_chord_string` on every chord, and then pass the structured data to check functional roles using `determine_harmonic_role`. It keeps track of everything. It’ll even optimize the output by calculating inversions with `get_chord_inversions`, giving you a complete picture in one go without needing multiple prompts.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "chord-constructor-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 Chord Constructor. 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 Chord Constructor 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 Chord Constructor MCP in Windsurf

The Chord Constructor MCP Server lets your agent parse complex chord strings and determine harmonic roles. It gives you the structural backbone of any piece, which is huge for compositional work.

Yep. You can tell your agent to run `generate_voicings` and then follow up by calculating inversions using `get_chord_inversions`. It handles both 'closed' and 'open' textures automatically.

While primarily an IDE tool, the structured data output from this MCP Server is perfect for any pipeline. You can use it to validate musical notation rulesets as part of your build process.

It accepts standard chord name strings, which the `parse_chord_string` tool breaks down into root notes and intervals. You'll get structured data defining the component parts.

This MCP Server only handles musical notation strings, which are plain text representations of chords. It doesn't access any personal or sensitive user information.

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