Follow the arrangement
Section timings, labels, instrument changes, and arrangement notes help you navigate the report. Review the reported boundaries against the audio; timing and interpretation may be uncertain.
Melogen / MCP
Song Analysis — ChatGPT & MCP
Attach MP3, WAV, FLAC, OGG, or M4A audio directly. OAuth connects Melogen to your MCP host for structured analysis.
Connect with OAuthAttach audio and ask your AI to start the analysis.
MP3, WAV, FLAC, OGG, M4A12 structured views
Bring a song. Choose what to explore.
Connect Melogen in your MCP host, attach an audio file, and ask a musical question.
Connect with OAuth
Use a host that supports the Melogen MCP connection and file attachments. Follow the connection guide, sign in, and authorize access before asking it to analyze audio.
Attach the actual audio
Attach an MP3, WAV, FLAC, OGG, or M4A file. Your host supplies the file descriptor; a song title alone is not an audio attachment.
Choose your report language
Ask for the report in English or Simplified Chinese. The report_locale parameter controls the analysis language.
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.
Read the music from several angles.
Start with an overview, then explore the parts that matter to your question. Diagrams below are illustrative, not analysis results.
Explore harmony and groove
Inspect the estimated tonal center, section harmony, pulse, drum role, and bass role. These are analytical observations with confidence notes, not a note-for-note transcription.
Discuss mood and production
Explore the mood and energy arc alongside the sonic palette, dynamics, stereo image, and effects. Use the report as a listening guide and check its limitations.
Ask a focused question.
These are example requests you can adapt after attaching your own audio.
Map the song
Analyze this audio in English. Show the sections and explain where the arrangement changes.
Start the analysis, then retrieve the structure view when the task is ready.
Listen for the groove
Analyze this track. Explain how the bass and drums shape the groove, and flag uncertain observations.
Use the report’s rhythm and harmony observations; compare them with what you hear.
Ask a follow-up
Based on this completed analysis, what creates the strongest lift in energy? Refer to the report and mention its limitations.
Grounded follow-ups use ask_about_song and require a successfully completed, unlocked analysis.
Technical details and complete MCP example
Your host handles these calls. Keep the returned task identifier to check status and request specific views.
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 12 structured views
Parameters
file — host-provided file descriptorreport_locale — preferred report languageview + cursor + limit — select a structured view and page through its resultstask_uuid — identifier returned by the analysis task
MCP / JSON
// 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"
}
}Pick up where the workflow stopped.
Check the existing task before starting the same analysis again.
The host cannot connect
Return to the MCP connection guide and check the host’s OAuth connection to Melogen. Complete authorization in the same account you intend to use.
The audio is missing
Check that the file is attached in your host and that it uses a supported audio format. The start call needs the host-provided file descriptor.
The report is still pending
Keep the task_uuid returned by the start call and use get_song_analysis to check it. A pending response is not a finished report.
A follow-up is unavailable
Check that analysis completed successfully and the report is unlocked before using ask_about_song. Review the returned access information and task status instead of treating the missing answer as a result.
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.
Song Analysis — ChatGPT & MCP
Attach MP3, WAV, FLAC, OGG, or M4A audio directly. OAuth connects Melogen to your MCP host for structured analysis.