Skip to main content
Glama

@cassette.diy/mcp

MCP server for Cassette (music releases) and Cassette for Creators (short-form clips). Lets AI assistants in Cursor, Claude Desktop, and other MCP clients manage your Cassette account via personal access tokens.

npm: https://www.npmjs.com/package/@cassette.diy/mcp
Docs: https://cassette.diy/docs/mcp

Install

Published on npm. No separate install step when using Cursor — npx downloads the package on first run:

npx -y @cassette.diy/mcp
  1. A Cassette or Creator account with Google Drive linked (required for uploads).

  2. A personal access token from the web app:

    • Music app: Settings → API / AI access

    • Creator app: Settings → API / AI access

Related MCP server: vcon-mcp

Cursor setup

Add to your Cursor MCP config (~/.cursor/mcp.json or project .cursor/mcp.json):

{
  "mcpServers": {
    "cassette": {
      "command": "npx",
      "args": ["-y", "@cassette.diy/mcp"],
      "env": {
        "CASSETTE_API_URL": "https://api.cassette.diy",
        "CASSETTE_API_TOKEN": "ct_live_YOUR_TOKEN_HERE",
        "CASSETTE_PRODUCT": "both"
      }
    }
  }
}

You can copy a ready-made snippet from Settings after creating a token.

Environment variables

Variable

Required

Description

CASSETTE_API_URL

No

Backend URL (default: http://localhost:8080)

CASSETTE_API_TOKEN

Yes

Personal access token (ct_live_…)

CASSETTE_PRODUCT

No

music, creator, or both (default: both) — controls which tools are registered

Local development

From the monorepo:

cd cassette-mcp
npm install
npm run build

Point Cursor at the local package:

{
  "mcpServers": {
    "cassette": {
      "command": "node",
      "args": ["/absolute/path/to/Cassette/cassette-mcp/dist/index.js"],
      "env": {
        "CASSETTE_API_URL": "http://localhost:8080",
        "CASSETTE_API_TOKEN": "ct_live_...",
        "CASSETTE_PRODUCT": "both"
      }
    }
  }
}

Tool catalog

Set CASSETTE_PRODUCT to music, creator, or both (default: both).

Shared

Tool

Description

cassette_get_account

Profile, Drive link status, tiers

cassette_start_gdrive_link

OAuth URL to link Google Drive

cassette_search_users

Find users for invites (creator mode only)

Music — track creation workflow

Focused tools for musicians: create a release end-to-end (no delete, collaboration, or Drive sync).

Tool

Description

cassette_create_track

Create track (name, artist, release date)

cassette_upload_track_file

Upload artwork, audio, promo, footages, vertical videos

cassette_update_track_metadata

Metadata, Spotify pitch, notes

cassette_list_track_files

List uploaded files by category

cassette_get_track

Get full track after creation

Creators

Full clip workflow (unchanged):

Tool

Description

cassette_get_creator_billing

Tier, limits, clip count

cassette_list_clips

List clips

cassette_get_clip / create_clip / update_clip / delete_clip

Clip CRUD

cassette_update_scenario

Scenario time blocks

cassette_update_clip_notes

Freeform notes

cassette_list_trends / create_trend / delete_trend

Trend library

cassette_start_clip_from_trend

New clip from trend

cassette_list_footages / upload_footage / review_footage / delete_footage

Footages

cassette_get_final / upload_final / update_post_links

Final video & links

cassette_manage_clip_shares

Collaboration

Uploads

Upload tools read files from local_path on the machine running the MCP server (your computer when using stdio in Cursor).

  • < 10 MB — direct multipart upload

  • 10–20 MB — async upload + task polling

  • > 20 MB (tracks) — chunked upload + task polling

If Drive is not linked, upload tools fail; use cassette_start_gdrive_link first.

Token scopes

Scope

Access

music:read

GET on /tracks/*

music:write

Mutations on /tracks/*

creator:read

GET on /creator/*

creator:write

Mutations on /creator/*

Tokens cannot access admin, Stripe checkout, analytics, or token management endpoints.

Publish checklist

  • Deploy backend with api_tokens collection and routes

  • Verify token create/list/revoke in staging Settings UI

  • Smoke-test MCP tools against staging API

  • Publish @cassette.diy/mcp to npm (v0.1.0)

  • Set production CASSETTE_API_URL in docs

  • Optional: track mcp_token_created analytics event

License

UNLICENSED — internal Cassette package.

Available Tools

28 tools
cassette_create_clipC

Create a new creator clip.

Inputs: name (required).

cassette_create_trackB

Create a new music track/release. First step of the track creation workflow.

Inputs: name (required), artist (required), releaseDate, release, +2 more.

cassette_create_trendD

Save a trend video URL.

Inputs: url (required), title, notes.

cassette_delete_clipC

Delete a creator clip.

Inputs: clipId (required).

cassette_delete_footageC

Delete a footage file from a clip.

Inputs: clipId (required), fileId (required).

cassette_delete_trendB

Delete a trend from the library.

Inputs: trendId (required).

cassette_get_accountA

Get Cassette account status: profile, Google Drive link, music/creator tiers, and readiness for uploads.

Inputs: no named parameters.

cassette_get_clipC

Get a creator clip by ID.

Inputs: clipId (required).

cassette_get_creator_billingA

Get Creator subscription tier, limits, and clip count.

Inputs: no named parameters.

cassette_get_finalC

Get final video metadata and post links for a clip.

Inputs: clipId (required).

cassette_get_trackA

Get a track by ID with full metadata and file references. Use after creation to verify the workflow.

Inputs: trackId (required).

cassette_list_clipsC

List creator clips.

Inputs: scope.

cassette_list_footagesB

List footages uploaded for a clip.

Inputs: clipId (required).

cassette_list_track_filesB

List uploaded files on a track (audio, promo, footages, verticalVideos, video) to verify uploads.

Inputs: trackId (required), fileType (required).

cassette_manage_clip_sharesC

Manage clip collaboration: list, create, invite, accept, revoke, or change role.

Inputs: action (required), clipId (required), collaboratorUserId, role, +1 more.

cassette_review_footageC

Update footage review metadata (selected, rating 0-5, note).

Inputs: clipId (required), fileId (required), selected, rating, +1 more.

cassette_search_usersA

Search Cassette users by email (for creator clip collaboration invites).

Inputs: query (required).

cassette_start_clip_from_trendC

Create a new clip from a trend with default scenario template.

Inputs: trendId (required).

cassette_update_clipA

Update clip fields (name, status, progress, etc.).

Inputs: clipId (required), updates (required).

cassette_update_clip_notesB

Update freeform notes on a clip.

Inputs: clipId (required), notes (required).

cassette_update_post_linksC

Update social post links on the final video.

Inputs: clipId (required), tiktok, instagramReels, youtubeShorts, +1 more.

cassette_update_scenarioC

Update scenario time blocks for a clip.

Inputs: clipId (required), scenario (required).

cassette_update_track_metadataA

Update track fields via PATCH /metadata (same fields as the Cassette app): pitchEn, pitchNative, notes, status, progress, multilink, name, artist, release, releaseDate, isSingle.

Inputs: trackId (required), pitchEn, pitchNative, notes, +8 more.

cassette_upload_finalC

Upload final video for a clip from a local path.

Inputs: clipId (required), localPath (required), replace.

cassette_upload_footageC

Upload a footage file to a clip from a local path.

Inputs: clipId (required), localPath (required).

cassette_upload_track_fileC

Upload artwork, audio, promo images, footages, or vertical videos from a local path. Requires Google Drive linked.

Inputs: trackId (required), fileType (required), localPath (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 28 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action (e.g., clips, tracks, footages, trends). Overlaps like cassette_create_clip vs cassette_start_clip_from_trend are clearly differentiated by context. All tools have clear, non-overlapping purposes.

    Naming Consistency5/5

    All tools follow a consistent 'cassette_verb_noun' pattern in snake_case. Verbs like create, delete, get, list, update are used predictably. No mixing of conventions or vague names.

    Tool Count3/5

    28 tools is slightly above the recommended range for a typical server. While each tool earns its place given the domain's complexity, the count feels heavy and could potentially be consolidated (e.g., merging manage_clip_shares into separate tools).

    Completeness4/5

    The tool surface covers core workflows for clips, tracks, footages, trends, and account management. Minor gaps exist, such as missing delete_track and list_tracks tools, but these are not critical and can be worked around.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      An MCP server that enables AI assistants to read, create, and manage issues, repositories, and releases on Gitea, Forgejo, or Codeberg instances via personal access tokens.
      21
      117 PyPI
      2
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      A lightweight MCP server that enables AI assistants like Cursor and Claude to control Spotify playback, playlists, and manage tokens via OAuth.
      15
      2
      -