Song Analysis — ChatGPT & MCP

Attach MP3, WAV, FLAC, OGG, or M4A audio directly. OAuth connects Melogen to your MCP host for structured analysis.

Attach audio and ask your AI to start the analysis.

Connect with OAuth

MCP: start_song_analysis + get_song_analysis

Attach MP3, WAV, FLAC, OGG, or M4A audio directly. OAuth connects Melogen to your MCP host for structured analysis.

MP3, WAV, FLAC, OGG, M4A

MP3WAVFLACOGGM4A

12 structured views

summarystructureharmony

Parameters

file — host-provided file descriptor

report_locale — preferred report language

view + cursor + limit — select a structured view and page through its results

task_uuid — identifier returned by the analysis task

How It Works

Attach MP3, WAV, FLAC, OGG, or M4A audio directly. OAuth connects Melogen to your MCP host for structured analysis.

Configure MCP

Connect with OAuth

Ask Your AI

Attach audio and ask your AI to start the analysis. start_song_analysis.

Get Analysis

get_song_analysis — Check task status and collect the result. After successful unlocked analysis, use ask_about_song for grounded follow-ups.

Usage Example

Your AI starts the task and checks its asynchronous status.

Example prompt to your AI agent:

“start_song_analysis → get_song_analysis → ask_about_song”

// MCP Tool Call (handled automatically by your AI agent)
{
  "tool": "start_song_analysis",
  "arguments": {
    "file": {
      "file_id": "host_uploaded_song_123",
      "download_url": "https://host.example/files/song.mp3",
      "file_name": "song.mp3",
      "mime_type": "audio/mpeg"
    },
    "client_request_id": "chatgpt-song-0001",
    "report_locale": "en"
  }
}

// Poll until analysis is complete
{
  "tool": "get_song_analysis",
  "arguments": {
    "task_uuid": "00000000-0000-0000-0000-000000000123",
    "view": "structure"
  }
}

// After completion, ask grounded follow-up questions
{
  "tool": "ask_about_song",
  "arguments": {
    "task_uuid": "00000000-0000-0000-0000-000000000123",
    "question": "Why does the chorus feel more energetic?",
    "client_request_id": "chatgpt-followup-0001"
  }
}

Why Use This MCP Tool?

Keep the music workflow inside the same AI conversation.

12 structured views

Report languages

Follow-up tool

Deep Musicological Analysis

The analysis provides 12 structured views covering overview, structure, harmony, rhythm, mood, production, and related musical details.

Multiple Input Types

Attach MP3, WAV, FLAC, OGG, or M4A audio directly in your MCP host.

Multilingual Output

report_locale currently supports English and Simplified Chinese.

Discuss with AI

Only analyses that finish successfully and are unlocked can use ask_about_song for grounded follow-up questions.

Frequently Asked Questions

Common questions about this MCP workflow.

The analysis provides 12 structured views covering overview, structure, harmony, rhythm, mood, production, and related musical details.

report_locale currently supports English and Simplified Chinese.

Attach MP3, WAV, FLAC, OGG, or M4A audio directly in your MCP host.

Only analyses that finish successfully and are unlocked can use ask_about_song for grounded follow-up questions.