# ACE Studio MCP Server

{% hint style="warning" %}

### Experimental Status

The ACE Studio MCP Server is currently in **experimental phase**.

**Please note:**

* Some features and settings may not be fully implemented yet
* Features and functionality may change
* You may encounter bugs or performance issues during use
* Usage guidelines and rate limits will be published when the stable version is released

We are actively improving this feature. If you have any feedback or encounter issues, please contact us at [**support@acestudio.ai**](mailto:support@acestudio.ai).
{% endhint %}

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 ](https://modelcontextprotocol.io/docs/getting-started/intro)(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)
   * Visit [nodejs.org](https://nodejs.org) and download the LTS version
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:

```json
{
    "mcpServers": {
        "acestudio": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "http://localhost:21572/mcp"
            ]
        }
    }
}
```

4. 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](https://cursor.com/en-US/install-mcp?name=ACE-Studio\&config=eyJ1cmwiOiJodHRwOi8vbG9jYWxob3N0OjIxNTcyL21jcCJ9).

Or manually setup:

1. Open Cursor settings
2. Find the "Tools & MCP" section
3. Click "New MCP Server"
4. Fill in the following JSON:

   ```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](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%7B%22name%22%3A%22acestudio%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22http%3A%2F%2Flocalhost%3A21572%2Fmcp%22%7D).

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:

   ```json
   "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:

{% tabs %}
{% tab title="Cline" %}

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

{% endtab %}

{% tab title="Roo Code" %}

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

{% endtab %}
{% endtabs %}

***

#### **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:

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

{% hint style="info" %}
Note: ACE Studio requires streamable HTTP transport and does not support the legacy HTTP + SSE protocol or MCP version 2024-11-05.
{% endhint %}

## 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

<pre><code><strong>In ACE Studio, add a piano chord progression in bars 9-16:
</strong>C - Am - F - G, each chord lasting 2 bars
</code></pre>