fluncle.com

{
  "name": "list_findings",
  "kind": "answer",
  "impl": "imperative",
  "description": "List the most recent findings and mixtapes in Fluncle's drum & bass archive, newest first. Dates mark the day Fluncle found each finding or published each mixtape.",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "limit": {
        "description": "How many tracks to return (1 to 48, default 10).",
        "type": "integer",
        "minimum": 1,
        "maximum": 48
      }
    }
  },
  "page": "/"
}

{
  "name": "list_tracks",
  "kind": "answer",
  "impl": "imperative",
  "description": "List every track in Fluncle's drum & bass archive, newest RELEASE first, one page at a time. Ordered by when each track came OUT, not by when Fluncle found it, so do not say Fluncle found them. Set certified to true for only the certified findings (which carry a Log ID coordinate), false for only the quieter uncertified rows, or leave it off for both. Every row carries its trackId and, when it has a page, the url of that page on fluncle.com.",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "certified": {
        "description": "Filter by tier: true for only certified findings, false for only uncertified rows, omitted for both.",
        "type": "boolean"
      },
      "page": {
        "description": "Which page to return (1-based, default 1).",
        "type": "integer",
        "minimum": 1,
        "maximum": 9007199254740991
      }
    }
  },
  "page": "/"
}

{
  "name": "list_fresh",
  "kind": "answer",
  "impl": "imperative",
  "description": "List the newest drum & bass RELEASES across Fluncle's archive: every track that came OUT in the trailing 30-day window, freshest release first. These are ordered by RELEASE date (when a track landed), not by when Fluncle found it, so do not say Fluncle found them, only that they just came out. Certified findings carry a Log ID coordinate and cover art; the quieter uncertified rows carry neither.",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "limit": {
        "description": "How many releases to return (1 to 100).",
        "type": "integer",
        "minimum": 1,
        "maximum": 100
      },
      "view": {
        "description": "Which cut to return: 'tracks' for the individual releases, 'albums' for the records those releases sit on, or 'all' for both (the default).",
        "type": "string",
        "enum": [
          "albums",
          "all",
          "tracks"
        ]
      }
    }
  },
  "page": "/"
}

{
  "name": "get_track",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read one finding (or mixtape) in full by its Log ID coordinate or Spotify track id. Returns the same public record its /log page shows: artist, title, Found date, note, BPM, key, links, galaxy, and the recovered observation transcript. The resource form is fluncle://finding/<logId>.",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "idOrLogId": {
        "type": "string",
        "description": "A Log ID coordinate (e.g. 012.8.0A) or a Spotify track id / URL."
      }
    },
    "required": [
      "idOrLogId"
    ]
  },
  "page": "/"
}

{
  "name": "get_random_track",
  "kind": "answer",
  "impl": "imperative",
  "description": "Pull one random certified track from Fluncle's archive.",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {}
  },
  "page": "/"
}

{
  "name": "search_archive",
  "kind": "answer",
  "impl": "imperative",
  "description": "Search Fluncle's drum & bass archive. Handles a name, a label, a key or BPM ask, or 'sounds like <a real track>' (it anchors on a real finding and returns the sonically nearest). An empty result means nothing in the archive matched.",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "minLength": 2,
        "description": "What to dig for (a name, a label, a key/BPM, or 'sounds like <track>')."
      }
    },
    "required": [
      "query"
    ]
  },
  "page": "/"
}

{
  "name": "submit_track",
  "kind": "transact",
  "impl": "imperative",
  "description": "Submit a track to Fluncle for review, from a search_tracks result (candidateId and provider) or a Spotify track URL. Fluncle gives it a listen before anything publishes. Limited to 5 submissions per connection per hour.",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "candidateId": {
        "description": "Selected candidate id from search_tracks.",
        "type": "string"
      },
      "contact": {
        "description": "Optional: where to reach the submitter (max 120 characters).",
        "type": "string",
        "maxLength": 120
      },
      "note": {
        "description": "Optional: tell Fluncle why it's a banger (max 500 characters).",
        "type": "string",
        "maxLength": 500
      },
      "provider": {
        "description": "Provider of the selected search_tracks candidate.",
        "type": "string",
        "enum": [
          "catalogue",
          "deezer",
          "spotify"
        ]
      },
      "spotifyUrl": {
        "description": "Spotify track URL, e.g. https://open.spotify.com/track/...",
        "type": "string"
      }
    }
  },
  "page": "/"
}

{
  "name": "subscribe_newsletter",
  "kind": "transact",
  "impl": "imperative",
  "description": "Subscribe an email address to Fluncle's newsletter. Fresh bangers, every Friday, from Fluncle.",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "email": {
        "type": "string",
        "format": "email",
        "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
        "description": "The email address boarding the mothership."
      }
    },
    "required": [
      "email"
    ]
  },
  "page": "/"
}

{
  "name": "search_tracks",
  "kind": "answer",
  "impl": "imperative",
  "description": "Search for track candidates to submit, by artist and title or a Spotify track URL. Covers Fluncle's catalogue and other music sources such as Deezer. Pass a result's id and provider to submit_track.",
  "inputSchema": {
    "properties": {
      "query": {
        "description": "Artist and title, or a Spotify track URL, minimum 2 characters.",
        "minLength": 2,
        "type": "string"
      }
    },
    "required": [
      "query"
    ],
    "type": "object"
  },
  "page": "/"
}