home / mcp / musicmcp.ai mcp server

MusicMCP.AI MCP Server

Official MCP server for MusicMCP.AI - AI-powered music generation for Claude Desktop and other MCP clients

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "amcharlie-aimusic-mcp-tool": {
      "url": "https://www.musicmcp.ai/api",
      "headers": {
        "MUSICMCP_API_KEY": "sk_live_...",
        "MUSICMCP_API_URL": "https://www.musicmcp.ai/api",
        "TIME_OUT_SECONDS": "600"
      }
    }
  }
}

This MusicMCP.AI MCP Server enables you to generate AI music from natural language prompts via MCP clients. It supports inspiration and custom modes, provides direct download links, and lets you monitor credits and API health, making it easy to integrate AI music generation into your workflows.

How to use

You interact with the MusicMCP.AI MCP Server through an MCP client to generate music. Choose inspiration mode for prompt-based generation that yields two song variations, or choose custom mode to specify a title, lyrics, and style (or an instrumental track). Each generation consumes credits and runs asynchronously, with the server polling for completion and returning final download URLs and metadata once ready.

Key actions you can perform after you have configured your client include: - Generate Prompt Song in Inspiration Mode to create two songs from a text prompt - Generate Custom Song in Custom Mode to produce two songs with a specified title, lyrics, and style (or instrumental only) - Check your credit balance to ensure you have enough credits - Check API health to verify the MusicMCP.AI service is operational - Retrieve direct download URLs, cover images, duration, and style tags for each generated song.

How to install

Prerequisites: you need Python and a MCP client that can connect to HTTP endpoints or a local stdio MCP runner like uvx.

Install the MCP runner (recommended) and set up the MusicMCP.AI MCP Server configuration as shown in the example configurations.

uvx aimusic-mcp

Configuration examples

The server can be used via a standard HTTP API endpoint or as a local stdio MCP server. The following configurations reflect the explicit examples provided for interacting with MusicMCP.AI.

{
  "mcpServers": {
    "MusicMCP.AI": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "aimusic-mcp"
      ],
      "env": {
        "MUSICMCP_API_KEY": "<insert-your-api-key-here>",
        "MUSICMCP_API_URL": "https://www.musicmcp.ai/api",
        "TIME_OUT_SECONDS": "600"
      }
    }
  }
}

{
  "mcpServers": {
    "MusicMCP.AI": {
      "type": "http",
      "url": "https://www.musicmcp.ai/api",
      "args": []
    }
  }
}

Environment variables

Set these environment variables to configure your MCP client and provide your credentials.

MUSICMCP_API_KEY=<insert-your-api-key-here>
MUSICMCP_API_URL=https://www.musicmcp.ai/api
TIME_OUT_SECONDS=600

API endpoints you’ll interact with

The server communicates with MusicMCP.AI services through these RESTful endpoints. You will generally be issuing requests to generate music, check status, and query credits and health.

Available tools

Generate Prompt Song

Create AI music based on a text prompt; automatically generates a title, lyrics, and style for two song variations.

Generate Custom Song

Create AI music with a specified title, lyrics, and style, or generate instrumental music only; returns two song variations.

Check Credit Balance

Verify API key validity and view remaining credits for your MusicMCP.AI account.

Check API Health

Monitor the health status of the MusicMCP.AI API service.