Agent interface · schema 1.14.0

WebMCP for the music catalog

AlexMercedMusic.com registers 33 read-only browser tools. Agents can find recordings and videos, inspect Suno albums and playlists, build and diagnose prompts, calculate scales and chords, translate Roman-numeral progressions, plan projects and navigate to canonical pages without scraping visual lists.

Available tools

music_overview: Current catalog counts, eras and primary destinations.
get_song: One exact recording by stable ID, slug or exact title.
search_songs: Full-text discovery with era, kind, album and source filters.
list_songs: Paginated catalog browsing without a search term.
get_recent_songs: The most recently published dated recordings.
list_videos: Every public YouTube Short and video, searchable and filterable by type or song connection.
get_video: One video with matching song records and other known versions.
compare_versions: An original recording and every known reimagined version.
list_suno_playlists: Every public Suno playlist with its direct URL, artwork, song count and runtime.
get_suno_playlist: One playlist and its ordered local song records.
list_suno_albums: Every official Suno album with its canonical page, artwork, track count and runtime.
get_suno_album: One official Suno album and its ordered tracks with connected catalog records.
get_catalog_updates_since: Dated recordings published after an ISO date for lightweight polling.
get_suno_prompting_guide: Structured prompt architecture, keys, chord progressions, time signatures, percussion, sound palettes, controls and troubleshooting.
get_suno_prompting_section: One focused guide section, such as harmony, rhythm, vocals, production, recipes or troubleshooting.
search_suno_prompting_guide: Search the guide for a key, chord progression, meter, percussion idea, musical problem, genre or instrument.
compose_suno_prompt: Assemble a focused Style prompt from separate musical choices without sending data to Suno.
transpose_chord_progression: Transpose a functional progression and return exact chords plus a prompt clause.
design_meter_prompt: Convert a meter and additive grouping into an accent map and rhythm clause.
diagnose_suno_result: Connect a common audible problem to one focused next experiment.
build_arrangement_blueprint: Return a section map, energy plan and prompt for a selected song form.
create_album_style_bible: Build a consistency brief for an EP or concept album.
get_music_theory_guide: Complete standalone music theory reference for songwriting and production.
get_music_theory_section: Focused theory sections for scales, modes, chords, harmony, progressions, melody and workflows.
build_scale: Calculate a scale in any chromatic root with formula and songwriting use.
build_chord: Calculate chord tones from a root and chord quality.
translate_roman_progression: Translate supported Roman numerals into chord symbols in a selected tonic.
suggest_theory_palette: Find scales, progressions and arrangement ideas associated with a musical tendency.
list_reimaginings: Every original/reimagined pair.
list_albums: Albums or one complete album track list.
where_to_listen: Verified hosting profiles and playlists by era.
get_ai_music_perspective: Alex’s first-person article about AI-assisted creativity, artistic skill, access and the effect on working artists.
navigate_catalog: Canonical human and machine-readable site destinations.

Example workflow

Call search_songs with {"query":"Solemn Thoughts"}.
Use the returned stable ID with compare_versions.
Open the returned canonical AlexMercedMusic.com page or a verified listening source.

Music theory workflow

Call get_music_theory_section for the relevant concept or use get_music_theory_guide for the complete reference.
Use build_scale, build_chord or translate_roman_progression for exact pitch calculations.
Use suggest_theory_palette for several scale, progression and arrangement starting points, then verify the result by ear.

Prompting workflow

Call search_suno_prompting_guide with a term such as {"query":"close-mic"}.
Call get_suno_prompting_section for the relevant reference section.
Pass the selected traits to compose_suno_prompt to receive a clean Style prompt and optional Exclude field.
Use transpose_chord_progression, design_meter_prompt or diagnose_suno_result when the question needs a focused musical calculation.

Video workflow

Call list_videos with a title fragment, videoType set to short or video, or use the linked filter.
Pass the returned YouTube ID to get_video.
Use the matching songs and other versions to move across every known piece of media for that work.

Direct machine access

Clients without WebMCP can use the catalog summary, versioned JSON catalog, JSON Schema, lightweight song index, concise LLM guide, full text catalog, JSON Feed, or RSS feed. All tools are read-only and have no login or side effects.

Open the song explorer Open the video catalog