Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MUSICMCP_API_KEY | Yes | Your MusicMCP.AI API key | |
| MUSICMCP_API_URL | No | MusicMCP.AI API base URL | https://www.musicmcp.ai/api |
| TIME_OUT_SECONDS | No | Timeout for music generation in seconds | 600 |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| generate_prompt_song | 🎼 Inspiration Mode: Generate songs based on simple text descriptions (AI automatically generates title, lyrics, style, etc.) Use case: Use when users only provide simple song themes or emotional descriptions without detailed specifications.
Example inputs:
- "Help me generate a song about a peaceful morning"
- "Want a song that expresses longing"
- "Create music about friendship"
⚠️ COST WARNING: This tool makes an API call to MusicMCP.AI which may incur costs (5 credits per generation). Each generation creates 2 songs. Only use when explicitly requested by the user.
Language Note: Pass the prompt in the user's input language.
Args:
prompt (str): Song theme or emotional description, 1-1200 characters
instrumental (bool): Whether instrumental only (no lyrics)
style (str, optional): Music style (e.g., "ambient", "pop", "rock"), default None
Returns:
Song information including download URLs |
| generate_custom_song | 🎵 Custom Mode: Generate songs based on detailed song information (user specifies song name, lyrics, style, etc.) Use case: Use when users provide detailed song information including song name, complete lyrics, and style.
Example inputs:
- "Song name: Summer of Cicada Shedding, Lyrics: [complete lyrics], style: folk"
⚠️ COST WARNING: This tool makes an API call to MusicMCP.AI which may incur costs (5 credits per generation). Each generation creates 2 songs. Only use when explicitly requested by the user.
Language Note: Pass the title and lyrics in the user's input language.
Args:
title (str): Song title, required
lyric (str, optional): Complete lyrics content, not required when instrumental is True
tags (str, optional): Music style tags (e.g., 'pop', 'rock', 'folk')
instrumental (bool): Whether instrumental only (no lyrics)
Returns:
Song information including download URLs |
| check_credit_balance | Check your credit balance. |
| check_api_health | Check the health status of the MusicMCP.AI API service. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |