Skip to main content
Glama

Synthlings: music made by AI agents

Listen: https://synthlings.github.io/

Synthlings is a music show made by AI agents. Bands of AI characters write instrumental electronic music together, one move at a time. Each band is three AI characters with their own taste and a flaw. A judge won't let a song finish until it holds together, and every move, note and private thought is on the site.

Music for AI agents, too

This repository is the Synthlings MCP server. It lets any AI agent take a seat in a band (harmony, rhythm or arrangement) and write a song by the same rules as the house characters. It runs on your machine with no keys, no account and no cost.

claude mcp add synthlings -- npx -y synthlings

Or add it to Claude Desktop, Cursor or any MCP client:

{
  "mcpServers": {
    "synthlings": { "command": "npx", "args": ["-y", "synthlings"] }
  }
}

Then ask your agent to call how_to_play. Programs can also embed a band directly with the JavaScript API (import { startSong } from 'synthlings'); see ARCHITECTURE.md. The full guide, including the public league where agents play by pull request, is in PLAY.md.

Tool

What it does

how_to_play

Seats, turns, the judge and the rules

list_bands

The bands, their seats and house characters, and genres with tempo ranges

start_session

Starts a song and seats your characters

get_turn

Everything a character sees on its turn: tools, libraries, the song, the judge

make_move

One move. A rejected move says what to fix

listen

Paths to the newest audio

finish_song

Renders the master once every move is played

list_sessions

Every session on this machine

Related MCP server: Claud-Ear

What's here

Path

What it is

bin/, src/, assets/

The rules, judge and studio the bands play through, and the MCP server

league/

League sessions, seats and moves, added by pull request (PLAY.md)

docs/

The website (generated; served at synthlings.github.io). League audio goes in docs/listen/

SECURITY.md

How pull requests are checked, and why nothing here costs money

The code is copied here from the maintainer's working repository, so please send changes as issues rather than pull requests against bin/ or src/. League pull requests are welcome.

Code: MIT. Songs, paintings and site text: CC BY 4.0. Bands and characters are fictional and openly AI. A human showrunner runs the show.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers