MCP-Suno

MCP (Model Context Protocol) server for Suno music generation API.

Features

• Generate Lyrics: Create lyrics based on a description or theme

• Generate Music: Create custom songs with lyrics, style tags, and model selection

• Automatic Polling: Built-in polling mechanism for async task completion

Related MCP server: Suno Autopilot MCP

Installation

1. Clone or download this repository

2. Install dependencies:

npm install

3. Set up your API key by creating a .env file:

cp .env.example .env

Edit .env and add your Suno API key:

SUNO_API_KEY=your_actual_api_key_here

Building

npm run build

Running

npm start

Or for development:

npm run dev

MCP Configuration

Add this server to your MCP client configuration:

{
  "mcpServers": {
    "suno": {
      "type": "stdio",
      "command": "node",
      "args": ["E:\\xxx\\xxx\\xxx\\suno-mcp-1313api\\dist\\index.js"],
      "env": {
        "SUNO_API_KEY": "your_api_key_here"
      }
      "timeout": 600,
    }
  }
}

Available Tools

generate_lyrics

Generate lyrics based on a description or theme.

Parameters:

• prompt (required): Description or theme for lyrics (e.g., "dance", "love song", "epic battle")

Returns:

• task_id: The task ID for tracking

• title: Generated song title

• lyrics: Full lyrics text

• status: Task completion status

Example:

{
  "prompt": "a romantic sunset song about two lovers meeting"
}

generate_music

Generate music with custom lyrics.

Parameters:

• prompt (required): The lyrics for the song in Suno format (with [Verse], [Chorus], [Bridge] tags)

• title (required): Title of the song

• tags (optional): Music style tags (e.g., "pop, upbeat, female vocals", "rock, energetic")

• mv (optional): Model version (default: "chirp-v4")

Returns:

• task_id: The task ID for tracking

• songs: Array of generated songs with:

  • id: Song ID

  • title: Song title

  • tags: Style tags

  • audio_url: MP3 audio file URL

  • video_url: MP4 video file URL

  • image_url: Cover image URL

  • image_large_url: Large cover image URL

  • duration: Song duration in seconds

  • model_name: Model used

  • status: Generation status

  • lyrics: Full lyrics text

Example:

{
  "prompt": "[Verse]\nWalking down the street\nFeeling the beat\nMusic in my soul\nTaking control\n\n[Chorus]\nThis is my song\nSinging all night long\nFeel the rhythm\nMoving along",
  "title": "My Song",
  "tags": "pop, upbeat, electronic",
  "mv": "chirp-v4"
}

API Endpoints

This MCP server uses the following API endpoints:

• Submit Lyrics: POST https://1313api.top/suno/submit/lyrics

• Submit Music: POST https://1313api.top/suno/submit/music

• Fetch Task: GET https://1313api.top/suno/fetch/{task_id}

Polling Behavior

The server automatically polls for task completion with the following settings:

• Max Attempts: 60

• Polling Interval: 3 seconds

• Total Timeout: ~3 minutes

Tasks are polled until they reach SUCCESS or FAILED status, or timeout is reached.

Error Handling

The server returns error messages in the following format:

{
  "error": "Error message description"
}

Common errors:

• SUNO_API_KEY environment variable is not set: API key not configured

• Failed to submit lyrics generation: API request failed

• Task failed: Generation failed on the server

• Task timeout: Generation took too long

License

MIT