`get_audio_features`

Pack: spotify · Endpoint: https://gateway.pipeworx.io/spotify/mcp

Audio features for a track: tempo (BPM), key, mode (major/minor), time_signature, energy, danceability, valence, acousticness, instrumentalness, liveness, speechiness, loudness.

Parameters

Name	Type	Required	Description
`track_id`	string	yes	Spotify track ID

Example call

Arguments

{
  "track_id": "11dFghVXANMlKmJXsNCQvb"
}

curl

curl -X POST https://gateway.pipeworx.io/spotify/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_audio_features","arguments":{"track_id":"11dFghVXANMlKmJXsNCQvb"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_audio_features', {
  "track_id": "11dFghVXANMlKmJXsNCQvb"
});

Response shape

Field	Type	Description
`id`	string	Track ID
`uri`	string	Spotify URI
`track_href`	string	Track API endpoint
`analysis_url`	string	Detailed audio analysis endpoint
`tempo`	number	Tempo in BPM
`key`	number	Key 0-11 (C=0 to B=11)
`mode`	number	Mode: 1=major, 0=minor
`time_signature`	number	Time signature (4/4 = 4)
`energy`	number	Energy 0-1 (intensity/activity)
`danceability`	number	Danceability 0-1
`valence`	number	Valence 0-1 (musicality positivity)
`acousticness`	number	Acousticness 0-1
`instrumentalness`	number	Instrumentalness 0-1 (no vocals)
`liveness`	number	Liveness 0-1 (audience presence)
`speechiness`	number	Speechiness 0-1 (spoken words)
`loudness`	number	Loudness in dB

Full JSON Schema

{
  "type": "object",
  "description": "Audio features for a track: tempo, key, energy, danceability, valence, etc.",
  "properties": {
    "id": {
      "type": "string",
      "description": "Track ID"
    },
    "uri": {
      "type": "string",
      "description": "Spotify URI"
    },
    "track_href": {
      "type": "string",
      "description": "Track API endpoint"
    },
    "analysis_url": {
      "type": "string",
      "description": "Detailed audio analysis endpoint"
    },
    "tempo": {
      "type": "number",
      "description": "Tempo in BPM"
    },
    "key": {
      "type": "number",
      "description": "Key 0-11 (C=0 to B=11)"
    },
    "mode": {
      "type": "number",
      "description": "Mode: 1=major, 0=minor"
    },
    "time_signature": {
      "type": "number",
      "description": "Time signature (4/4 = 4)"
    },
    "energy": {
      "type": "number",
      "description": "Energy 0-1 (intensity/activity)"
    },
    "danceability": {
      "type": "number",
      "description": "Danceability 0-1"
    },
    "valence": {
      "type": "number",
      "description": "Valence 0-1 (musicality positivity)"
    },
    "acousticness": {
      "type": "number",
      "description": "Acousticness 0-1"
    },
    "instrumentalness": {
      "type": "number",
      "description": "Instrumentalness 0-1 (no vocals)"
    },
    "liveness": {
      "type": "number",
      "description": "Liveness 0-1 (audience presence)"
    },
    "speechiness": {
      "type": "number",
      "description": "Speechiness 0-1 (spoken words)"
    },
    "loudness": {
      "type": "number",
      "description": "Loudness in dB"
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "spotify": {
      "url": "https://gateway.pipeworx.io/spotify/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

get_audio_features