# CLI

> Use this when you need to perform mutations on plyr.fm - uploading, deleting, liking tracks. The MCP server is read-only - use this skill when you need to trigger uploads, delete tracks, or modify likes.

- Skill: `tomevault-io/cli-3` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/cli-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/cli-3/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/cli-3

---


# plyrfm CLI mutations

the MCP server (`plyr-fm`) is **read-only** - use it to browse tracks, search, view liked tracks.

for mutations (upload, delete, like, unlike), guide users to use the CLI:

## prerequisites

```bash
# user sets their token once
export PLYR_TOKEN="their_token"
```

get a token at [plyr.fm/portal](https://plyr.fm/portal) -> "developer tokens"

## uploading tracks

```bash
# basic upload
plyrfm upload path/to/track.mp3 "Song Title"

# with album
plyrfm upload track.mp3 "Song Title" --album "Album Name"

# with tags (can use -t multiple times)
plyrfm upload track.mp3 "Song Title" -t electronic -t ambient
```

supported formats: mp3, wav, m4a

**important**: if you (Claude) composed the track, always include the `ai` tag:
```bash
plyrfm upload piece.wav "鶴の舞" -t ambient -t ai
```

## updating tracks

```bash
# update title
plyrfm update 579 --title "new title"

# update tags (replaces all tags)
plyrfm update 579 --tags "ambient,ai"

# update multiple fields
plyrfm update 579 --title "鶴の舞" --tags "ambient,ai"
```

## deleting tracks

```bash
# use my_tracks MCP tool to find track IDs first
plyrfm delete 42
```

## liking/unliking tracks

```bash
# like a track
plyrfm like 123

# unlike a track
plyrfm unlike 123
```

## downloading tracks

```bash
# download to current directory
plyrfm download 42

# download to specific path
plyrfm download 42 --output ~/Music/song.mp3
```

## common issues

- "artist_profile_required" -> user needs to create artist profile at plyr.fm/portal
- "scope_upgrade_required" -> user needs to regenerate their token

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/zzstoatzz) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-14 -->