Bandmate

Bandmate MCP Server exposes the Bandmate REST API through a dedicated MCP interface, enabling you to manage songs and lists with chord notation via an MCP client. Use this server to create, read, and organize your musical data in a scalable, scriptable way.

How to use

You connect an MCP client to the Bandmate MCP Server using the remote SSE transport. Once connected, you can fetch songs, lists, or specific items, create new entries, update existing ones, and search by title or tags. Use the client’s tools to retrieve public data or data scoped to a particular user, and leverage upsert operations to create or update songs and lists with the provided fields such as chordsText, bpm, key, and tags.

How to install

Prerequisites: ensure you have Node.js installed on your system.

Install and build the MCP server package locally.

Configuration and usage notes

The server relies on environment variables to connect to Bandmate and authorize requests.

Deployment can be done as a remote HTTP service via Google Cloud Run, or you can test locally using a compatible environment. The remote service exposes an SSE endpoint for MCP transport and provides a health check and service info endpoints.

Deployment and remote access

Remote deployment uses Server-Sent Events (SSE) transport and offers an HTTP URL you can connect to from your MCP client.

{
  "mcpServers": {
    "bandmate": {
      "type": "http",
      "name": "bandmate",
      "url": "https://bandmate-mcp-xxxxx-uc.a.run.app/sse",
      "args": []
    }
  },
  "envVars": []
}

Available tools

get_songs

Retrieve songs, either public or filtered by userId and/or specific IDs.

get_song

Fetch a single song by its ID.

get_songs_by_user

List all songs created by a specific user.

get_songs_in_list

Get all songs contained in a specific list.

upsert_song

Create a new song or update an existing one with full chord notation and metadata.

search_songs

Search songs by title or tags.

get_lists

Retrieve lists, either public or filtered by userId.

get_list

Fetch a single list by its ID.

upsert_list

Create or update a list, associating it with song IDs and ownership.