sounds

Free-text search over the SFXMint library of free CC0 sound effects. Use it for sound descriptions, additional constraints or gaps left by another tool. Choose get_role_sound for a named event or get_sound_set for multiple events when that fits the task; these are task branches, not a fixed sequence. Exact keyword matches come first, then semantic nearest neighbours; hard constraints are applied before the result limit and a request may validly return no qualified candidate with near-match diagnostics. Returns direct, hotlinkable MP3/WAV URLs and verified OGG (Vorbis) URLs where available — no API key, no attribution required — plus measured acoustics (attack_ms, tail_ms, centroid_hz), character labels like 'bright · punchy · tight', loop/file-QC status, and score/match as ranking evidence only (role = known role default, exact = all words hit, partial = some words hit, semantic = nearest by meaning).

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Keywords or a natural-language description, e.g. 'door slam', 'soft UI confirmation chime', 'coin pickup'"
    },
    "category": {
      "type": "string",
      "description": "Optional category slug: ui, retro-game, transition, impact, ambience, water, fire-electric, footsteps, door, mechanical, paper-fabric, glass, animal, crowd, cartoon, magic-scifi, horror, feedback, instrument, office"
    },
    "limit": {
      "type": "number",
      "description": "Max results (default 20, max 50)"
    },
    "max_duration_ms": {
      "type": "number",
      "description": "Hard maximum delivered duration in milliseconds; format-specific measurement is required."
    },
    "loop": {
      "type": "boolean",
      "description": "Require (true) or exclude (false) a candidate marked with prepared loop metadata; seam evidence is returned separately."
    },
    "format": {
      "type": "string",
      "enum": [
        "wav",
        "mp3",
        "ogg"
      ],
      "description": "Delivery format (ogg = Ogg Vorbis); loop=true defaults to WAV when omitted."
    }
  },
  "required": [
    "query"
  ]
}

Choose this when the task calls for a sound for a named event or interaction — a button click, purchase success, error beep, level-up, dialogue blip, notification. Pass the role as plain words: role ids (click, success, purchase-success, dialogue-blip, notification…) and common aliases (button click, ka-ching, jump scare, text blip…) are all accepted. Returns a qualified candidate for that role when one satisfies the requested constraints, with MP3/WAV URLs, 2-3 alternates and the family page for browsing more. Five core game roles include content_check (verified/unverified/rejected), scoped to scene, role, format and exact file SHA256; unverified previews are not certified suitable. Download selected files locally and retain originals. Task-permitted processing requires a recipe, output SHA256, renewed file checks and a listening check; changed bytes do not inherit content review. Other task-permitted sources or local synthesis may be mixed in. Optional style: crisp (short, bright, dry), soft (darker, gentler), spacious (reverb, longer tail), balanced (default: most typical). For multiple events consider get_sound_set; use search_sounds for a description or a gap. These are task branches, not a fixed sequence. Unknown roles return not_found with the full role list; GET https://sfxmint.com/api/v1/roles lists roles with aliases.

{
  "type": "object",
  "properties": {
    "role": {
      "type": "string",
      "description": "Role id or alias, e.g. 'click', 'button click', 'purchase-success', 'ka-ching', 'error beep', 'level-up', 'dialogue blip', 'notification'"
    },
    "style": {
      "type": "string",
      "enum": [
        "balanced",
        "crisp",
        "soft",
        "spacious"
      ],
      "description": "Optional. balanced (default) = the family's most typical take; crisp = short, bright, dry; soft = darker, gentler; spacious = reverb, longer tail"
    },
    "max_duration_ms": {
      "type": "number",
      "description": "Hard maximum delivered duration in milliseconds."
    },
    "loop": {
      "type": "boolean",
      "description": "Require prepared loop metadata; seam evidence is returned separately."
    },
    "format": {
      "type": "string",
      "enum": [
        "wav",
        "mp3",
        "ogg"
      ]
    }
  },
  "required": [
    "role"
  ]
}

Get full metadata for one sound by slug, including download URLs, description and measured acoustics (attack/tail/brightness + character labels).

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Sound slug, e.g. 'impact-punch-01'"
    }
  },
  "required": [
    "slug"
  ]
}

Get a coherent set of sounds for an app or game in one call — one sound per role, with format metadata, hashes and stable download URLs. Use it when the task needs a whole kit; use get_role_sound for one event. Check content_check: verified/unverified/rejected is bound to the exact role, format and file SHA256; unverified files still require listening in context. Sets include UI styles, game and app scenarios, acoustic-drum-kit, animal-calls (15 isolated calls), and dungeon-traps (6 isolated mechanisms).

{
  "type": "object",
  "properties": {
    "format": {
      "type": "string",
      "enum": [
        "wav",
        "mp3",
        "ogg"
      ],
      "description": "File format for selection and checks (default WAV). Legacy urls remains MP3; download_urls follows this format."
    },
    "set": {
      "type": "string",
      "enum": [
        "ui-crisp",
        "ui-soft",
        "ui-spacious",
        "retro-game",
        "chat-app",
        "saas-app",
        "checkout",
        "learning",
        "puzzle-game",
        "platformer",
        "horror-game",
        "video-editing",
        "smart-device",
        "wellness",
        "ai-coding-tool",
        "acoustic-drum-kit",
        "animal-calls",
        "dungeon-traps"
      ],
      "description": "Set id (default ui-crisp). Includes acoustic-drum-kit, animal-calls and dungeon-traps alongside the UI and scenario sets listed in the enum."
    }
  }
}