Agent interface · schema 1.7.0

WebMCP for the music catalog

AlexMercedMusic.com registers seventeen read-only browser tools. Agents can find recordings, inspect ordered Suno playlists, poll for newer publications, search prompting guidance, assemble a Style prompt, compare versions 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.
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.
get_catalog_updates_since
Dated recordings published after an ISO date for lightweight polling.
get_suno_prompting_guide
Structured prompt architecture, sound palettes, recipes, controls, troubleshooting and evaluation guidance.
get_suno_prompting_section
One focused guide section, such as vocals, rhythm, production, recipes or troubleshooting.
search_suno_prompting_guide
Search the guide for a musical term, problem, genre, instrument or production idea.
compose_suno_prompt
Assemble a focused Style prompt from separate musical choices without sending data to Suno.
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.
navigate_catalog
Canonical human and machine-readable site destinations.

Example workflow

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

Prompting workflow

  1. Call search_suno_prompting_guide with a term such as {"query":"close-mic"}.
  2. Call get_suno_prompting_section for the relevant reference section.
  3. Pass the selected traits to compose_suno_prompt to receive a clean Style prompt and optional Exclude field.

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 human song explorer