Skip to content

MCP Tools

reklawdbox exposes MCP tools for reading your library, enriching metadata, analyzing audio, building sets, discovering pools, and exporting changes. All tools accept and return JSON.

A typical workflow flows left to right through these tool groups:

Library & Data ──> Enrichment & Analysis ──> Classification & Staging ──> Export
| |
└──────── Mixing & Sequencing ─────────────────┘
|
Files & System (direct file ops, audit, cache management)

Library & Data

Search tracks, read playlists, resolve cached enrichment and analysis data. 11 tools

Enrichment & Analysis

Look up metadata on Discogs, Beatport, MusicBrainz, and Bandcamp. Analyze audio for BPM, key, and energy descriptors. 8 tools

Classification & Staging

Genre classification, auditing, metadata backfill, staging, and XML export. 11 tools

Mixing & Sequencing

Score transitions, build set sequences, and discover compatible track pools. 10 tools

Files & System

Read/write native file tags, manage cover art, audit collections, and clear caches. 11 tools

Many tools share a common set of search filter parameters. Used by search_tracks, get_play_stats, enrich_tracks, analyze_audio_batch, resolve_tracks_data, and cache_coverage.

ParameterTypeDescription
querystringFree-text search matching title or artist
artiststringFilter by artist (partial match)
genrestringFilter by genre (partial match)
rating_minintegerMinimum star rating (1-5)
bpm_minnumberMinimum BPM
bpm_maxnumberMaximum BPM
keystringFilter by musical key (e.g., "Am", "Cm")
has_genrebooleanFilter by whether track has a genre set
has_labelbooleanFilter by whether track has a label set
year_zerobooleanFilter to tracks with year = 0 (unset)
labelstringFilter by label (partial match)
pathstringFilter by file path/folder (substring match)
path_prefixstringFilter to tracks whose file path starts with this prefix
added_afterstringISO date — only tracks added on or after
added_beforestringISO date — only tracks added on or before
has_unknown_genrebooleanFilter to tracks with a non-canonical genre (not in taxonomy and no known alias). Tracks with empty genre are excluded. Only true is meaningful