gaana.com

{
  "name": "search_gaana",
  "kind": "act",
  "impl": "imperative",
  "description": "Search Gaana for songs by keyword, already ranked by relevance. Returns up to 10 matching tracks plus total_matches/has_more counts. When has_more is false, total_matches is the complete match count for this query — do not call this again with a reworded or narrower query for the same intent; use the results from the first call. Navigates to the real search results page so the user sees a clickable list, and returns a short list of tracks (with track_id) that play_track can use.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "The search keyword, e.g. a song, artist, or album name."
      }
    },
    "required": [
      "query"
    ]
  },
  "page": "/"
}

{
  "name": "play_track",
  "kind": "act",
  "impl": "imperative",
  "description": "Start playback of a Gaana track by its track_id. Works standalone with any valid track_id, and also with a track_id from a previous search_gaana result.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "track_id": {
        "type": [
          "string",
          "number"
        ],
        "description": "A Gaana track_id, e.g. one returned by search_gaana."
      }
    },
    "required": [
      "track_id"
    ]
  },
  "page": "/"
}

{
  "name": "get_current_context",
  "kind": "answer",
  "impl": "imperative",
  "description": "Reports the current Gaana session: whether the user is logged in, their subscription tier, and what's currently playing (if anything).",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/"
}

{
  "name": "player_control",
  "kind": "act",
  "impl": "imperative",
  "description": "Controls whatever is already loaded in the Gaana player: resume/pause, skip to next or previous track. Does not start a new track — use play_track for that.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "action": {
        "type": "string",
        "enum": [
          "play",
          "pause",
          "next",
          "previous"
        ],
        "description": "\"play\"/\"pause\" both toggle play/pause of the current track (there is no separate resume action); \"next\"/\"previous\" skip within the current queue."
      }
    },
    "required": [
      "action"
    ]
  },
  "page": "/"
}

{
  "name": "open_album",
  "kind": "act",
  "impl": "imperative",
  "description": "Navigate to an album page by its seokey. An album's seokey is NOT the same as a track's seokey — search_gaana only returns tracks, and a track's own seokey will not work here. Get an album seokey from get_track_details(track_id).albumSeokey (no need to play the track first), or from get_current_context's currentTrack.albumSeokey (reflects whatever is currently playing).",
  "inputSchema": {
    "type": "object",
    "properties": {
      "seokey": {
        "type": "string",
        "description": "The album's seokey (not a track's seokey)."
      }
    },
    "required": [
      "seokey"
    ]
  },
  "page": "/"
}

{
  "name": "get_track_details",
  "kind": "answer",
  "impl": "imperative",
  "description": "Look up a track's details by track_id — including its album seokey (albumSeokey), for chaining into open_album — without playing it. Works with a track_id from search_gaana or any valid Gaana track_id.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "track_id": {
        "type": [
          "string",
          "number"
        ],
        "description": "A Gaana track_id, e.g. one returned by search_gaana."
      }
    },
    "required": [
      "track_id"
    ]
  },
  "page": "/"
}