`get_track`

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

Single track by Spotify ID. Returns artists, album, popularity, preview URL, duration.

Parameters

Name	Type	Required	Description
`track_id`	string	yes	Spotify track ID (base62)
`market`	string	no	Market for availability

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_track","arguments":{"track_id":"11dFghVXANMlKmJXsNCQvb"}}}'

TypeScript (@pipeworx/sdk)

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

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

More examples

{
  "track_id": "11dFghVXANMlKmJXsNCQvb",
  "market": "GB"
}

Response shape

Field	Type	Description
`id`	string	Track ID
`name`	string	Track name
`artists`	array
`album`	object
`duration_ms`	number	Duration in milliseconds
`popularity`	number	Popularity 0-100
`preview_url`	string \| null	30s preview URL or null
`explicit`	boolean	Explicit content flag
`is_playable`	boolean	Playable in market

Full JSON Schema

{
  "type": "object",
  "description": "Spotify track with artists, album, popularity, preview URL, duration",
  "properties": {
    "id": {
      "type": "string",
      "description": "Track ID"
    },
    "name": {
      "type": "string",
      "description": "Track name"
    },
    "artists": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Artist ID"
          },
          "name": {
            "type": "string",
            "description": "Artist name"
          },
          "genres": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Artist genres"
          }
        }
      }
    },
    "album": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Album ID"
        },
        "name": {
          "type": "string",
          "description": "Album name"
        },
        "release_date": {
          "type": "string",
          "description": "Release date (YYYY-MM-DD)"
        },
        "total_tracks": {
          "type": "number",
          "description": "Total tracks on album"
        },
        "images": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string",
                "description": "Image URL"
              },
              "height": {
                "type": "number",
                "description": "Image height pixels"
              },
              "width": {
                "type": "number",
                "description": "Image width pixels"
              }
            }
          }
        }
      }
    },
    "duration_ms": {
      "type": "number",
      "description": "Duration in milliseconds"
    },
    "popularity": {
      "type": "number",
      "description": "Popularity 0-100"
    },
    "preview_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "30s preview URL or null"
    },
    "explicit": {
      "type": "boolean",
      "description": "Explicit content flag"
    },
    "is_playable": {
      "type": "boolean",
      "description": "Playable in market"
    }
  }
}

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_track