How to Use the Chord Substitution Finder MCP in CrewAI

Q: Can I use Chord Substitution Finder with CrewAI to find substitutions?

Yes, you can assign a 'Harmonic Specialist' role that uses findsubstitutions. It will automatically pass the results to another agent for review.

Run specialized music theory teams with Chord Substitution Finder using CrewAI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Chord Substitution Finder MCP to CrewAI

Create your Vinkius account to connect Chord Substitution Finder to CrewAI 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 Substitution Finder with CrewAI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Assess Harmonic Tension

You need to know if a section feels too flat or overly tense? The `analyze_progression_tension` tool calculates the full harmonic tension arc of any chord progression. This gives your crew clear data on structural pacing. It's perfect for setting up specialized roles: one agent analyzes tension, and another agent uses that finding to dictate necessary changes.

Identify Chord Swaps

When an agent needs a chord replacement, it calls `find_substitutions`. This finds all harmonically valid swaps for the given chord using established music theory rules. Your crew can then pass this list to another specialized agent who will evaluate which swap best fits the overall emotional goal of the piece.

Detail Substitution Theory

A moderator agent needs proof? `get_substitution_detail` provides deep, technical explanations for any given chord substitution. It breaks down voice leading and harmonic impact. This allows your CrewAI setup to maintain a shared memory of complex rules while making autonomous decisions.

Setup guide

Set up Chord Substitution Finder MCP in CrewAI

Prerequisites

Python 3.10+ installed
crewai package (pip install crewai)
Active Vinkius subscription with a valid endpoint token

1

Install CrewAI
Run pip install crewai to install the framework. MCP support is built-in via the mcps parameter.
2

Add the MCP URL to your agent
Pass your Vinkius endpoint directly to the mcps list. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. CrewAI handles tool discovery and caching automatically.
3

Kick off your crew
Create a Crew with your agent and tasks. Call crew.kickoff() — the agent will automatically invoke Chord Substitution Finder tools as needed.

crew.py

from crewai import Agent, Task, Crew

agent = Agent(
    role="Chord Substitution Finder Analyst",
    goal="Access and analyze Chord Substitution Finder data via MCP.",
    backstory="Expert analyst with direct Chord Substitution Finder access.",
    mcps=[
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ],
)

task = Task(
    description="List recent Chord Substitution Finder transactions",
    agent=agent,
    expected_output="A summary of recent activity",
)

crew = Crew(agents=[agent], tasks=[task])
result = crew.kickoff()
print(result)

Get your connection token →

Prerequisites

Python 3.10+ installed
crewai + crewai-tools packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install crewai crewai-tools. The MCPServerAdapter handles lifecycle management and tool conversion.
2

Connect with MCPServerAdapter
Use MCPServerAdapter as a context manager with SseServerParameters pointing to your Vinkius endpoint. The adapter automatically manages connection lifecycle.
3

Assign tools and run
Pass the returned mcp_tools to your agent's tools parameter. The adapter converts MCP tools to native BaseTool objects compatible with all CrewAI agents.

crew.py

from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter
from mcp import SseServerParameters

server_params = SseServerParameters(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

with MCPServerAdapter(server_params) as mcp_tools:
    agent = Agent(
        role="Chord Substitution Finder Analyst",
        goal="Access and analyze Chord Substitution Finder data via MCP.",
        backstory="Expert analyst with direct Chord Substitution Finder access.",
        tools=mcp_tools,
    )

    task = Task(
        description="List recent Chord Substitution Finder transactions",
        agent=agent,
        expected_output="A summary of recent activity",
    )

    crew = Crew(agents=[agent], tasks=[task])
    result = crew.kickoff()
    print(result)

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 Substitution Finder. 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 Substitution Finder 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 Substitution Finder MCP in CrewAI

The MCP lets specialized agents collaborate. One agent can use `analyze_progression_tension` to flag an issue, and another agent can then execute `find_substitutions` based on that finding.

It processes musical notation. The MCP only handles the structural relationships between chords (text strings) and their harmonic implications.

Yes, you can assign a 'Harmonic Specialist' role that uses `find_substitutions`. It will automatically pass the results to another agent for review.

It’s great. Using the three tools together lets your crew build sophisticated, multi-step operations that mimic human compositional thought processes.

The server works exclusively with musical notation and chord sequences. It generates detailed text reports on harmonic structure changes.

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