ACE Studio 2.0 is currently in beta testing, and some features may not be fully launched.

ACE Studio MCP Server

Experimental Status

The ACE Studio MCP server offers a rich toolkit enabling AI agents to autonomously navigate and execute creative edits. By giving AI agents comprehensive insight into every detail of your project, it empowers them to assist you in creating and editing songs with greater speed and creative freedom.

The Model Context Protocol (MCP) is an open standard that enables AI assistants to seamlessly connect with external applications and data sources. The ACE Studio MCP server implements this protocol to give AI agents direct access to your creative workspace.

Quick Start

Launch the ACE Studio MCP Server

  1. Open the ACE Studio 2.0

  2. From the preferences, check the General → MCP Server

Server Address: http://localhost:21572/mcp

Technical Note: The ACE Studio MCP Server uses the Streamable HTTP transport protocol. Keep this address for the next configuration step.

Connect the MCP Server to Your AI Client

Choose the appropriate configuration method based on your AI client:

Claude Desktop

Setting up the ACE Studio MCP Server in Claude Desktop requires editing a JSON configuration file. If you're not comfortable with technical configuration, we recommend trying more user-friendly clients.

Configuration Steps:

  1. Install Node.js (if not already installed)

  2. Locate the Claude Desktop configuration file

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

  3. Edit the configuration file and add the following:

{
    "mcpServers": {
        "acestudio": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "http://localhost:21572/mcp"
            ]
        }
    }
}
  1. Save the file and restart Claude Desktop

Verify Connection: Type in Claude:

Please check the current ACE Studio project information

If Claude returns project details, the connection is successful!


Cursor

You can directly add MCP server to Cursor by clicking here.

Or manually setup:

  1. Open Cursor settings

  2. Find the "Tools & MCP" section

  3. Click "New MCP Server"

  4. Fill in the following JSON:

    {
      "mcpServers": {
        "ACE-Studio": {
          "url": "http://localhost:21572/mcp",
          "headers": {}
        }
      }
    }
  5. Click "Save"

  6. Restart Cursor

Verify Connection: Type in Cursor Chat:

@acestudio What tracks are in the current project?

VS Code (via Native MCP support)

You can directly add MCP server to VS Code by clicking here.

Or manually setup:

  1. Install the Cline or Roo Cline extension

  2. Open extension settings

  3. Find the MCP Servers configuration section

  4. Add a new server:

    "mcp": {
        "servers": {
            "ACE-Studio": {
                "type": "http",
                "url": "http://localhost:21572/mcp",
                "headers": {}
            }
        }
    }

VS Code (via Cline / Roo Code)

  1. Install the Cline or Roo Code extension

  2. Open extension settings

  3. Find the MCP Servers configuration section

  4. Add a new server:

{
  "mcpServers": {
    "ACE-Studio": {
      "url": "http://localhost:21572/mcp",
      "type": "streamableHttp",
      "headers": {}
    }
  }
}

Other Clients / AI Chat bot

For most clients, use these configuration settings:

  • Transport type: Streamable HTTP (some clients may call this "Remote")

  • Server URL: http://localhost:21572/mcp

Or import MCP server by the following JSON:

{
  "mcpServers": {
    "ACE-Studio": {
      "url": "http://localhost:21572/mcp",
      "headers": {}
    }
  }
}

Note: ACE Studio requires streamable HTTP transport and does not support the legacy HTTP + SSE protocol or MCP version 2024-11-05.

Usage Examples

Once connected, you can try the following prompts to collaborate with your AI assistant:

Create a New Project

Help me create a new pop-style project with BPM 120 in ACE Studio, 
in C major, add a lead vocal track and a violin accompaniment track

Generate Lyrics and Melody

Based on the theme "Summer memories by the sea," 
write an 8-bar chorus section in ACE Studio. 
The melody should be light and lively, using a pentatonic scale

Edit MIDI

In ACE Studio, add a piano chord progression in bars 9-16:
C - Am - F - G, each chord lasting 2 bars

Last updated