Skip to main content
Glama

StudioSphere Pulse — Audio Intelligence

analyze_track

Run audio analysis on a public audio URL. Requires estimate_cost to be called first (job_estimate_id). Requires PULSE_API_KEY. Before calling, you MUST confirm with the user that they have a lawful basis to submit this audio for analysis. For a user-requested folder, project, playlist, or batch, one confirmation can cover every track in that scope. Returns job_id — poll get_job_status for results. If processing or payment returns estimate_pricing_changed, get a fresh free estimate with estimate_cost, present the new price, and wait for explicit user approval before processing or payment. Never silently retry analysis or purchase.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
toolsYesAnalysis tools to run. Available in v1.0: bpm, key, waveform. Coming soon: structure, chords.
audio_urlYesPublic URL of the audio file.
job_estimate_idYesThe job_estimate_id returned by estimate_cost. Must not have passed the returned expires_at timestamp.
attestation_confirmedYesSet to true ONLY after the user has confirmed they have rights, permission, lawful access, or another legal basis to submit this audio, or the current user-requested batch/folder/project containing it, for analysis.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
okNoTrue when analysis was accepted.
errorNoMachine-readable error code.
job_idNoPulse analysis job id.
statusNoCurrent job status.
detailsNoAdditional structured context from Pulse.
messageNoHuman-readable recovery guidance.
poll_urlNoRelative status polling URL.
retryableNoWhether the caller may retry after changing state or waiting.
cache_hitsNoTools served from cache.
stream_urlNoRelative SSE status URL.
account_typeNoAccount type used for the request.
upgrade_pathNo
conversion_noteNo
tokens_estimatedNoEstimated token charge.
cost_usd_estimatedNoEstimated USD value.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / job_estimate_id / description
      Previous value: -"The job_estimate_id returned by estimate_cost. Must not be expired (30 min TTL)."New value: +"The job_estimate_id returned by estimate_cost. Must not have passed the returned expires_at timestamp."
  2. Changed3 schema fields changed
    • addedOutput schema / anyOf
      Added value: +[
      +  {
      +    "required": [
      +      "ok",
      +      "job_id",
      +      "status",
      +      "cache_hits",
      +      "tokens_estimated",
      +      "cost_usd_estimated",
      +      "poll_url",
      +      "stream_url"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "error",
      +      "message"
      +    ]
      +  }
      +]
    • addedOutput schema / properties
      Added value: +{
      +  "account_type": {
      +    "description": "Account type used for the request.",
      +    "type": "string"
      +  },
      +  "cache_hits": {
      +    "description": "Tools served from cache.",
      +    "items": {
      +      "type": "string"
      +    },
      +    "type": "array"
      +  },
      +  "conversion_note": {
      +    "type": "string"
      +  },
      +  "cost_usd_estimated": {
      +    "description": "Estimated USD value.",
      +    "type": "number"
      +  },
      +  "details": {
      +    "additionalProperties": true,
      +    "description": "Additional structured context from Pulse.",
      +    "type": "object"
      +  },
      +  "error": {
      +    "description": "Machine-readable error code.",
      +    "type": "string"
      +  },
      +  "job_id": {
      +    "description": "Pulse analysis job id.",
      +    "type": "string"
      +  },
      +  "message": {
      +    "description": "Human-readable recovery guidance.",
      +    "type": "string"
      +  },
      +  "ok": {
      +    "description": "True when analysis was accepted.",
      +    "type": "boolean"
      +  },
      +  "poll_url": {
      +    "description": "Relative status polling URL.",
      +    "type": "string"
      +  },
      +  "retryable": {
      +    "description": "Whether the caller may retry after changing state or waiting.",
      +    "type": "boolean"
      +  },
      +  "status": {
      +    "description": "Current job status.",
      +    "type": "string"
      +  },
      +  "stream_url": {
      +    "description": "Relative SSE status URL.",
      +    "type": "string"
      +  },
      +  "tokens_estimated": {
      +    "description": "Estimated token charge.",
      +    "type": "number"
      +  },
      +  "upgrade_path": {
      +    "type": "string"
      +  }
      +}
    • addedOutput schema / required
      Added value: +[]
  3. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": true,
      +  "type": "object"
      +}
  4. Changed1 schema field changed
    • changedInput schema / properties / attestation_confirmed / description
      Previous value: -"Set to true ONLY after the user has confirmed they have rights, permission, lawful access, or another legal basis to submit this audio for analysis."New value: +"Set to true ONLY after the user has confirmed they have rights, permission, lawful access, or another legal basis to submit this audio, or the current user-requested batch/folder/project containing it, for analysis."
  5. Changed1 schema field changed
    • changedInput schema / properties / attestation_confirmed / description
      Previous value: -"Set to true ONLY after the user has confirmed they have the right to submit this audio."New value: +"Set to true ONLY after the user has confirmed they have rights, permission, lawful access, or another legal basis to submit this audio for analysis."
  6. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.