@audiolabtools/mcp-server 0.5.0 → 0.5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -52,21 +52,22 @@ Every tool takes **one audio source**: a public `url` **or** a local `path`:
52
52
  | Tool | Returns |
53
53
  |---|---|
54
54
  | `analyze_loudness` | Integrated LUFS (EBU R128 / BS.1770-4), true-peak (dBTP), LRA, crest factor, stereo correlation, mono compatibility, tonal balance |
55
- | `check_target` | Pass/fail vs a delivery target (`spotify` / `apple-music` / `youtube` / `tidal` / `amazon-music` / `podcast` / `ebu-broadcast` / `atsc-broadcast`, or `target:"custom"` + `lufs`+`tp`), with per-metric deltas and an ffmpeg loudnorm fix command |
55
+ | `check_target` | Pass/fail vs a delivery target (`spotify` / `apple-music` / `youtube` / `tidal` / `amazon-music` / `podcast` / `ebu-broadcast` / `atsc-broadcast`, or `target:"custom"` + `lufs`+`tp`), with per-metric deltas; passes within ±0.5 LU of the target with true peak at most 0.5 dB above it. On a fail it adds a single-pass ffmpeg loudnorm command as a starting point: measure the output again, single-pass can miss the margin |
56
56
  | `analyze_timeseries` | Short-term LUFS over time + downsampled waveform peaks (`waveformPoints?`) |
57
57
  | `get_spectrum` | FFT magnitude data + 7-band energies |
58
58
  | `analyze_voice` | Voice QA: speech/silence ratio, speaking rate, SNR, noise floor, pause energy, sibilance & clipping risk |
59
59
  | `get_speech_segments` | Voiced regions with start/end + per-segment RMS (auto-trim, chapters) |
60
- | `index_signal` | Content-type guess, tags, clipping/silence regions, brightness & dynamics buckets |
61
- | `analyze_profile` | One named question, `voice`, `master`, `provenance`, `dataset`, `environment`, `broadcast`, `loop`, `room` (reverberation from a clap, a pop, an impulse response or a sweep; pass `roomSource`), `chain` (lost packets) or `pitch` (where a voice sits and how clean it is), answered with only the lenses it needs. These ten need a paid plan; the free tier gets the `basic` profile, keyed by stable lens id. Add `series:true` for the curves, per-block lanes and per-phrase values. Carries a `note` when the profile’s voice lenses land on non-speech material. Full catalogue: <https://audiolab.tools/lenses> |
60
+ | `index_signal` | Content-type guess, tags, clipping/silence regions, brightness & dynamics buckets. Add `bandLimit:true` for `bandLimit.upsampled`: `yes`, `no` or `cannot-say`, with the reason in plain words (guide: <https://audiolab.tools/docs/start/is-my-audio-upsampled>) |
61
+ | `analyze_profile` | One named question, `voice`, `master`, `provenance`, `dataset`, `environment`, `broadcast`, `loop`, `room` (reverberation from a clap, a pop, an impulse response or a sweep; pass `roomSource`), `chain` (lost packets) or `pitch` (where a voice sits and how clean it is), answered with only the lenses it needs. These ten need a paid plan; the free tier gets the `basic` profile, keyed by stable lens id. Add `series:true` for the curves, per-block lanes and per-phrase values. Add `liveEvents:true` for `liveEvents`: the file read as a stream by the live monitor of /live, with every gap, clipping, level drop, dead air and hum it raised, all with status signals. Carries a `note` when the profile’s voice lenses land on non-speech material. Full catalogue: <https://audiolab.tools/lenses> |
62
62
  | `compare_loudness` | A/B on two sources (`urlA`/`pathA` + `urlB`/`pathB`), returns both results |
63
- | `analyze_batch` | One route over up to 20 sources in a single call (`urls` and/or `paths`), per-item ok/data/error. For folder QA, library indexing, or checking a whole release against a target. Each item meters as one call |
63
+ | `analyze_batch` | One route over up to 20 sources in a single call (`urls` and/or `paths`), per-item ok/data/error. For folder QA, library indexing, or checking a whole release against a target; with `endpoint:"signallab/index"` it takes `bandLimit:true` too. Each item meters as one call |
64
64
 
65
65
  Example asks to your AI:
66
66
 
67
67
  - *“Analyze the loudness of https://example.com/track.wav”* → `analyze_loudness` with `url`
68
68
  - *“Is this take usable?”* → `analyze_profile` with `profile:"voice"`
69
69
  - *“Has this file been re-encoded, and is it all one source?”* → `analyze_profile` with `profile:"provenance"`
70
+ - *“Which of these recordings were upsampled?”* → `analyze_batch` with `endpoint:"signallab/index"` and `bandLimit:true`
70
71
  - *“Run loudness on ./master.wav”* → `analyze_loudness` with `path`
71
72
  - *“Does ./mix.mp3 pass Spotify?”* → `check_target` with `path` + `target:"spotify"`
72
73
 
package/error-docs.mjs CHANGED
@@ -6,7 +6,7 @@
6
6
  export const DOCS_ERRORS_URL = 'https://audiolab.tools/docs/errors';
7
7
 
8
8
  export const KNOWN_CODES = [
9
- 'invalid_api_key', 'rate_limited', 'quota_exceeded', 'data_quota_exceeded', 'profile_requires_paid_plan', 'file_too_large', 'track_too_long', 'unsupported_format', 'room_not_measurable',
9
+ 'invalid_api_key', 'rate_limited', 'quota_exceeded', 'data_quota_exceeded', 'profile_requires_paid_plan', 'file_too_large', 'track_too_long', 'unsupported_format', 'room_not_measurable', 'incomplete_file',
10
10
  'url_not_allowed', 'url_fetch_failed', 'invalid_json', 'missing_input', 'invalid_parameter', 'batch_too_large', 'upload_not_found', 'unknown_endpoint', 'method_not_allowed',
11
11
  'storage_unavailable', 'analysis_error', 'missing_api_key', 'api_timeout', 'api_unreachable', 'voice_minutes_exhausted', 'service_paused', 'invalid_input',
12
12
  ];
package/hosted-server.mjs CHANGED
@@ -271,9 +271,12 @@ export function buildServer({ apiKey, local = false } = {}) {
271
271
 
272
272
  tool('index_signal', {
273
273
  title: 'Index a signal (SignalLab)',
274
- description: 'A metadata index for any audio file: content-type guess (voice/music/mixed/noise/silence) with confidence, brightness & dynamics buckets, a rough band label, clipping/silence regions, and tag suggestions. For triage or auto-tagging a library. Status: content type, regions and confidence come from a frame classifier that is a proxy, not validated on a labelled corpus of real recordings; the tags describe the signal only, never the speaker (https://audiolab.tools/lenses).' + srcDoc,
275
- inputSchema: src,
276
- }, wrap((i) => analyzeSource('signallab', i, {}, apiKey, local)));
274
+ description: 'A metadata index for any audio file: content-type guess (voice/music/mixed/noise/silence) with confidence, brightness & dynamics buckets, a rough band label, clipping/silence regions, and tag suggestions. For triage or auto-tagging a library. Status: content type, regions and confidence come from a frame classifier that is a proxy, not validated on a labelled corpus of real recordings; the tags describe the signal only, never the speaker (https://audiolab.tools/lenses). Set bandLimit:true to ask whether the audio was upsampled: bandLimit.upsampled is yes, no or cannot-say, with the reason in plain words. yes rests on a validated rule (study UP-1: the band stops under 5 kHz in a file of 16 kHz or more, as after a telephone call); no and the bandwidth ratio are proxies (study UP-2); cannot-say means look at the file, not that it is fine.' + srcDoc,
275
+ inputSchema: {
276
+ ...src,
277
+ bandLimit: z.boolean().optional().describe('Also return bandLimit: whether the audio was upsampled (yes, no or cannot-say), its status, reason and basis. Off by default.'),
278
+ },
279
+ }, wrap((i) => analyzeSource('signallab', i, { bandLimit: i.bandLimit }, apiKey, local)));
277
280
 
278
281
  // analyze_profile: the lens registry as one tool. A model that knows what it
279
282
  // is looking for names the question, not forty field names; a model that does
@@ -295,7 +298,10 @@ export function buildServer({ apiKey, local = false } = {}) {
295
298
  + 'basic is the free tier; the other ten need a paid plan. '
296
299
  + 'Results are keyed by stable lens id. Only the analysis passes the profile needs are run. '
297
300
  + 'Set series:true to also get the curves, the per-block lanes and the per-phrase values,'
298
- + 'a much larger payload, so leave it off unless you are going to read them.'
301
+ + 'a much larger payload, so leave it off unless you are going to read them. '
302
+ + 'Set liveEvents:true to also get liveEvents: the file read as a stream by the live monitor, with every dropout, clipping, level drop, dead air '
303
+ + 'and hum event, its times and its reason. Status signals: none of these detectors has been validated on live streams yet, so say "a signal", '
304
+ + 'never "detected". A dropout or clipping event names the file measure with its own rule (chain.dropoutCount, signal.clipping) and why the two can differ.'
299
305
  + srcDoc,
300
306
  inputSchema: {
301
307
  ...src,
@@ -305,8 +311,10 @@ export function buildServer({ apiKey, local = false } = {}) {
305
311
  .describe('Include time series, per-block lanes and per-phrase arrays. Off by default.'),
306
312
  roomSource: z.enum(['clap', 'balloon', 'impulse', 'sweep']).optional()
307
313
  .describe('For the room profile: how the recording was made. clap (default): one clap; balloon: one pop; impulse: the file is an impulse response; sweep: the file holds the sweep of the engine as the room returned it.'),
314
+ liveEvents: z.boolean().optional()
315
+ .describe('Also return liveEvents: the events of the live monitor over the whole file, status signals. Off by default.'),
308
316
  },
309
- }, wrap((i) => analyzeSource('analyze/profile', i, { profile: i.profile, series: i.series === true, ...(i.roomSource ? { roomSource: i.roomSource } : {}) }, apiKey, local)));
317
+ }, wrap((i) => analyzeSource('analyze/profile', i, { profile: i.profile, series: i.series === true, ...(i.roomSource ? { roomSource: i.roomSource } : {}), ...(i.liveEvents ? { liveEvents: true } : {}) }, apiKey, local)));
310
318
 
311
319
  // compare_loudness: two independent sources, each a url or (local only) a path.
312
320
  const cmp = local
@@ -348,8 +356,9 @@ export function buildServer({ apiKey, local = false } = {}) {
348
356
  target: z.string().optional().describe('For mixlab/check-target: preset id (spotify, ebu-broadcast, podcast, …) or "custom".'),
349
357
  lufs: z.number().optional().describe('For target="custom": integrated LUFS target.'),
350
358
  tp: z.number().optional().describe('For target="custom": max true-peak (dBTP).'),
359
+ bandLimit: z.boolean().optional().describe('For signallab/index: also return bandLimit per file, with upsampled yes, no or cannot-say (see index_signal).'),
351
360
  },
352
- }, wrap((i) => batchSources({ urls: i.urls || [], paths: i.paths || [] }, i.endpoint || 'mixlab/analyze', { target: i.target, lufs: i.lufs, tp: i.tp }, apiKey, local)));
361
+ }, wrap((i) => batchSources({ urls: i.urls || [], paths: i.paths || [] }, i.endpoint || 'mixlab/analyze', { target: i.target, lufs: i.lufs, tp: i.tp, bandLimit: i.bandLimit }, apiKey, local)));
353
362
 
354
363
  return { server, toolNames };
355
364
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@audiolabtools/mcp-server",
3
- "version": "0.5.0",
3
+ "version": "0.5.2",
4
4
  "mcpName": "tools.audiolab/audiolab",
5
5
  "description": "MCP server for AudioLab, loudness (EBU R128 / BS.1770-4), true-peak, voice-quality, and signal analysis for AI agents (Claude, Cursor, any MCP client), via the AudioLab hosted API. No local audio engine required.",
6
6
  "type": "module",