Analyze audio file for copyright clearance

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://docs.clearedmusic.io/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json
"Cleared API MCP server": {
  "url": "https://docs.clearedmusic.io/mcp"
}
Close
POST /clear

Analyzes an audio file from a publicly accessible URL to detect:

  • Released vs unreleased songs
  • Major label copyright risks
  • Content ID risks
  • Song metadata and listening links
application/json

Body Required

  • url string(uri) Required

    Publicly accessible URL of the audio file to analyze

Responses

  • 200 application/json

    Successful audio analysis

    Hide response attributes Show response attributes object
    • success boolean Required

      Indicates if the operation was successful

    • result object
      Hide result attributes Show result attributes object
      • release_status string Required

        Overall release status of detected songs

        Values are released or not_released.

      • released_songs array[object] Required

        List of songs that have been officially released

        Hide released_songs attributes Show released_songs attributes object
        • artist string Required

          Artist name

        • title string Required

          Song title

        • album string

          Album name

        • release_date string(date)

          Release date of the song

        • label string

          Record label

        • timecode string Required

          Time position in the audio where this song was detected

          Format should match the following pattern: ^\d{2}:\d{2}$.

        • isrc string

          International Standard Recording Code

        • upc string

          Universal Product Code

        • album_image_url string(uri)

          Album cover image URL

        • duration_ms integer

          Song duration in milliseconds

      • major_label_risk string Required

        Risk level for major label copyright claims

        Values are at_risk or no_risk.

      • major_label_songs array[object] Required

        Songs from major labels that pose copyright risk

        Hide major_label_songs attributes Show major_label_songs attributes object
        • artist string Required

          Artist name

        • title string Required

          Song title

        • album string

          Album name

        • release_date string(date)

          Release date of the song

        • label string

          Record label

        • timecode string Required

          Time position in the audio where this song was detected

          Format should match the following pattern: ^\d{2}:\d{2}$.

        • isrc string

          International Standard Recording Code

        • upc string

          Universal Product Code

        • album_image_url string(uri)

          Album cover image URL

        • duration_ms integer

          Song duration in milliseconds

      • content_id_risk string Required

        Risk level for Content ID claims

        Values are at_risk or no_risk.

      • content_id_songs array[object] Required

        Songs that may trigger Content ID claims

        Hide content_id_songs attributes Show content_id_songs attributes object
        • artist string Required

          Artist name

        • title string Required

          Song title

        • album string

          Album name

        • release_date string(date)

          Release date of the song

        • label string

          Record label

        • timecode string Required

          Time position in the audio where this song was detected

          Format should match the following pattern: ^\d{2}:\d{2}$.

        • isrc string

          International Standard Recording Code

        • upc string

          Universal Product Code

        • album_image_url string(uri)

          Album cover image URL

        • duration_ms integer

          Song duration in milliseconds

      • originalFileName string

        Original filename of the analyzed audio

    • resultId string(uuid)

      Unique identifier for this analysis result

    • error string

      Error type if the operation failed

    • message string

      Human-readable message about the operation result

  • 400 application/json

    Bad request - Invalid input

    Hide response attributes Show response attributes object
    • success boolean Required

      Always false for error responses

    • error string Required

      Error type or category

    • message string Required

      Human-readable error message

  • 401 application/json

    Unauthorized - Missing or invalid API key

    Hide response attributes Show response attributes object
    • success boolean Required

      Always false for error responses

    • error string Required

      Error type or category

    • message string Required

      Human-readable error message

  • 500 application/json

    Internal server error

    Hide response attributes Show response attributes object
    • success boolean Required

      Always false for error responses

    • error string Required

      Error type or category

    • message string Required

      Human-readable error message

POST /clear
curl \
 --request POST 'https://api.clearedmusic.io/clear' \
 --header "x-api-key: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{"url":"https://example.com/audio/sample.mp3"}'
Request example
{
  "url": "https://example.com/audio/sample.mp3"
}
Response examples (200)
{
  "success": true,
  "result": {
    "release_status": "released",
    "released_songs": [
      {
        "artist": "Example Artist",
        "title": "Example Song",
        "album": "Example Album",
        "release_date": "2023-01-15",
        "label": "Independent Label",
        "timecode": "00:30",
        "isrc": "USRC12345678",
        "upc": "123456789012",
        "album_image_url": "https://i.scdn.co/image/ab67616d0000b273abc123",
        "duration_ms": 180000,
        "listen_links": [
          {
            "service": "spotify",
            "url": "https://open.spotify.com/track/abc123"
          },
          {
            "service": "apple",
            "url": "https://music.apple.com/song/123"
          }
        ]
      }
    ],
    "major_label_risk": "no_risk",
    "major_label_songs": [],
    "content_id_risk": "no_risk",
    "content_id_songs": [],
    "originalFileName": "sample.mp3"
  },
  "resultId": "550e8400-e29b-41d4-a716-446655440000"
}
{
  "success": true,
  "result": {
    "release_status": "released",
    "released_songs": [
      {
        "artist": "Major Label Artist",
        "title": "Hit Song",
        "album": "Popular Album",
        "release_date": "2023-06-01",
        "label": "Universal Music Group",
        "timecode": "01:15",
        "isrc": "USUM71234567",
        "upc": "987654321098"
      }
    ],
    "major_label_risk": "at_risk",
    "major_label_songs": [
      {
        "artist": "Major Label Artist",
        "title": "Hit Song",
        "album": "Popular Album",
        "release_date": "2023-06-01",
        "label": "Universal Music Group",
        "timecode": "01:15"
      }
    ],
    "content_id_risk": "at_risk",
    "content_id_songs": [
      {
        "artist": "Major Label Artist",
        "title": "Hit Song",
        "album": "Popular Album",
        "release_date": "2023-06-01",
        "label": "Universal Music Group",
        "timecode": "01:15"
      }
    ]
  },
  "resultId": "550e8400-e29b-41d4-a716-446655440001"
}
Response examples (400)
{
  "success": false,
  "error": "Missing required parameter: url",
  "message": "The url parameter is required"
}
{
  "success": false,
  "error": "Invalid URL format",
  "message": "The provided URL is not valid"
}
{
  "success": false,
  "error": "Invalid JSON in request body",
  "message": "Request body must be valid JSON"
}
Response examples (401)
{
  "success": false,
  "error": "Missing authentication",
  "message": "The x-api-key header is required"
}
{
  "success": false,
  "error": "Invalid authentication",
  "message": "The provided API key is invalid"
}
Response examples (500)
{
  "success": false,
  "error": "Audio analysis failed",
  "message": "An error occurred while analyzing the audio file"
}