# SFXMint — Full Site Text (llms-full.txt)

> SFXMint (https://sfxmint.com) is a copyright-clean sound effects library. Sounds are
> AI-generated (Stable Audio 3) or procedurally synthesized and carry provenance
> and file-QC metadata when available. Objective file checks and subjective
> content/listening evidence are separate; the entire catalog is dedicated to
> the public domain under CC0 1.0 Universal.

## Quick start for coding assistants

No installation is required. Read the API, select qualified files, download them into the project and wire them to its existing events. Keep the CC0 license, source URL, measured format properties and SHA256 in the project. Preview content in context; do not automatically trim or normalize.

- Human handoff: https://sfxmint.com/for-ai
- Dependency-free Node download example: https://sfxmint.com/examples/download-sounds.mjs
- Start with 3 results: GET https://sfxmint.com/api/v1/search?q=click&max_duration_ms=300&format=wav&response=structured&limit=3
- Sets accept ?format=wav|mp3. download_urls follows that format; legacy urls remains MP3. missing_roles explicitly lists incomplete events. Do not treat an incomplete set as complete.
- Main candidates meet known hard conditions. near_matches may fail or have unknown conditions and require an explicit change to the request before substitution. Subjective qualities and event fit may still be unverified.

## License (https://sfxmint.com/license)

Yes — every SFXMint sound is CC0 1.0 public domain: free for commercial and personal
use, no attribution required.

What you can do: use sounds in commercial and personal projects (games, videos, films,
podcasts, apps, music, products); modify, remix and combine them; redistribute them,
including in paid products; hotlink the audio URLs directly.

What you don't have to do: no attribution or credit (appreciated, never required);
no signup, no license fees, no usage reporting.

Sounds are provided "as is" without warranty. To the extent any rights exist in the
outputs, SFXMint waives them under CC0.

## About (https://sfxmint.com/about)

Every sound is created by open-source AI models or procedural synthesis — nothing is
scraped, re-hosted or copied from other sound libraries. Formats and measured file
properties are returned per resource when audited; loudness is not promised to a
universal target. Audio URLs are permanent, immutable and CORS-enabled; hotlinking
is allowed and encouraged.
Contact: hello@sfxmint.com

## AI Sound Generator (https://sfxmint.com/generate)

Free text-to-SFX tool: type a description, get a CC0 sound effect as MP3/WAV.
Browser flow is Turnstile-gated; programmatic generation goes through the MCP server
(3/day per client).

## Synth Tools (in-browser, client-side, CC0 WAV export)

### 8-Bit Sound Generator (sfxr-style) — https://sfxmint.com/synth/8-bit
Classic sfxr-style chiptune synthesis: square/saw/sine/noise oscillators, envelope,
pitch slide, vibrato, arpeggio, phaser, filters. Presets: coin, laser, explosion,
power-up, hit, jump, blip.

### Retro Game Sound Generator — https://sfxmint.com/synth/retro-game
Arcade-era feedback sounds: power-ups, pickups, victory jingles, damage hits, explosions.

### UI Sound Generator — https://sfxmint.com/synth/ui-sounds
Micro-interactions: clicks, pops, toggles, hovers, blips with full envelope control.

### Notification Sound Maker — https://sfxmint.com/synth/notification
Chimes, two-tone dings, alerts and success sounds for apps and messages.

## Sound Categories (https://sfxmint.com/#categories)

### UI & Notification Sounds
https://sfxmint.com/category/ui
Clicks, pops, chimes, alerts and interface feedback sounds for apps, games and videos.

### 8-bit & Retro Game Sounds
https://sfxmint.com/category/retro-game
Jumps, coins, power-ups, lasers and game-over jingles with a classic arcade character.

### Transitions & Whooshes
https://sfxmint.com/category/transition
Whooshes, swooshes, risers, braams and sweeps for edits, trailers and motion design.

### Impacts & Hits
https://sfxmint.com/category/impact
Thuds, punches, metal hits, slams and crashes for action scenes and game feedback.

### Ambience & Nature
https://sfxmint.com/category/ambience
Rain, forest, ocean, wind, fireplace and room tone loops for backgrounds and scenes.

### Water Sounds
https://sfxmint.com/category/water
Drips, splashes, pours, bubbles and streams — clean water foley for any project.

### Fire & Electricity
https://sfxmint.com/category/fire-electric
Crackles, sparks, zaps, hums and arcs for energy, danger and sci-fi moments.

### Footsteps
https://sfxmint.com/category/footsteps
Footsteps on wood, gravel, snow, concrete and more, walking and running.

### Door Sounds
https://sfxmint.com/category/door
Opens, closes, creaks, knocks, doorbells and locks for interiors and horror alike.

### Mechanical Sounds
https://sfxmint.com/category/mechanical
Gears, levers, switches, engines and clock ticks — machines big and small.

### Paper & Fabric
https://sfxmint.com/category/paper-fabric
Page turns, crumples, zippers, tears and cloth movement for close-up foley.

### Glass & Ceramic
https://sfxmint.com/category/glass
Clinks, shatters, taps and cracks for kitchens, breakage and delicate moments.

### Animal Sounds
https://sfxmint.com/category/animal
Dogs, cats, birds, insects, frogs and owls — synthetic animal vocalizations.

### Crowd Sounds
https://sfxmint.com/category/crowd
Applause, murmur, cheering and laughter with synthetic texture and no real voices.

### Cartoon Sounds
https://sfxmint.com/category/cartoon
Boings, slide whistles, pops, squeaks and bonks for comedy and animation.

### Magic & Sci-Fi
https://sfxmint.com/category/magic-scifi
Spells, teleports, lasers, shields, portals and alien drones for fantasy worlds.

### Horror & Suspense
https://sfxmint.com/category/horror
Dark drones, creaks, heartbeats and stingers to build dread and tension.

### Success & Feedback
https://sfxmint.com/category/feedback
Success chimes, error buzzes, level-ups and confirms for UX and game states.

### Instrument Hits
https://sfxmint.com/category/instrument
Bells, gongs, wood blocks, kalimbas and singing bowls — single musical hits.

### Office & Tech
https://sfxmint.com/category/office
Keyboards, mouse clicks, camera shutters, phone vibrations and desk foley.

## Sound roles (https://sfxmint.com/roles)

Roles name what a sound is for (button-click, purchase-success, dialogue-blip, rain-loop)
rather than what it sounds like, so an agent that cannot listen still gets a file-QC-eligible
default when the ready gate is enabled instead of a near miss. Every role maps to one or more sound families; GET
https://sfxmint.com/api/v1/roles/{role} returns the default pick plus alternates, and search treats a
recognised role phrase as match=role.

Five core platformer events (jump, land, coin, hit, win / level-up) expose content_check: verified, unverified or rejected, scoped to scene, role, format and exact file SHA256. Unknown previews are not accepted content. The platformer set is reviewed only when all five pass. Prefer downloading WAV files locally and retaining metadata and checksums; MP3 needs its own review. Do not automatically trim or normalize the files.

## Guides

### Add sound effects to a React app — https://sfxmint.com/guides/react-app-sounds
Fetch a sound set, paste its urls map into a 15-line play() module (or use-sound / Howler),
hotlink the permanent CC0 URLs; covers autoplay rules, a mute toggle and volume.

### Add sound effects to a Phaser web game — https://sfxmint.com/guides/phaser-web-game-sounds
Pick a game set, preload with this.load.audio, play with this.sound.play, loop ambience
with loop:true, handle the audio unlock, and why cross-origin hotlinking works (CORS *).

## API (https://sfxmint.com/api/docs)

Free JSON API, no key, no signup, 4,600+ sounds:
- GET https://sfxmint.com/api/v1/search?q={query}&category=&limit=20&max_duration_ms=&loop=&format=wav|mp3 — keyword + semantic search with hard constraints applied before the limit. The legacy response remains an array; response=structured adds a fresh request_id, parsed constraints, per-candidate checks, near matches and diagnostics. Empty results explain the failed or unknown requirement rather than filling the list with violations.
- Search returns slug, title, duration_ms, tags, license, mp3_url/wav_url, acoustics, loop metadata, recommendation/file-QC status, and legacy score/match ranking fields. score is a ranking signal, not a probability or listening confidence.
- GET https://sfxmint.com/api/v1/roles — every sound role as {role, label, aliases, families, audiences, loopable, url}
- GET https://sfxmint.com/api/v1/roles/{role}?style=balanced|crisp|soft|spacious&max_duration_ms=&loop=&format=wav|mp3 — one deterministic file-QC-eligible default sound for a role (id or alias: button-click, purchase-success, dialogue-blip, rain-loop): role, label, aliases, audiences, style, license, slug, title, duration_ms, loopable, acoustics, mp3_url/wav_url, page_url, alternates (same shape), family, family_url; style defaults to balanced (most typical variant of the family); unknown role → 404 {error:"not_found", message, roles_url}
- GET https://sfxmint.com/api/v1/sounds/{slug} — full metadata incl. generation prompt, acoustics, loopable and peaks URL
- GET https://sfxmint.com/api/v1/sets and https://sfxmint.com/api/v1/sets/{id} — sound sets: style kits (ui-crisp, ui-soft, ui-spacious, retro-game) and scenario kits (chat-app, saas-app, checkout, learning, puzzle-game, platformer, horror-game, video-editing, smart-device, wellness, ai-coding-tool); one sound per role + 2 alternates + role → hotlink URL map (urls)
- acoustics (measured per sound): attack_ms (onset→peak), tail_ms (peak→-40 dB), centroid_hz (spectral brightness), character labels (dark/balanced/bright · punchy/fast attack/gradual · tight/short decay/sustained)
- loopable (per sound): a legacy flag only. loop_status=prepared marks prepared loop metadata; keep seam listening evidence separate. MP3 loop requests remain unknown because codec padding cannot inherit WAV seam evidence; delivered duration is format-specific.
- POST https://sfxmint.com/api/v1/generate — text-to-SFX (browser flow, Turnstile token required); 429 body {error:"rate_limited", code, message} with code = quota_personal | quota_global | capacity
- GET https://sfxmint.com/api/v1/jobs/{job_id} — generation job status
- Direct audio: https://sfxmint.com/dl/{slug}.mp3 / .wav — CORS: *, Cache-Control: immutable; optional request_id and via=internal correlate technical checks; they do not change file bytes

MCP server (Streamable HTTP): https://sfxmint.com/mcp — tools: search_sounds, get_role_sound, get_sound,
get_sound_set, generate_sound (3/day/client; a rate_limited result may carry a note to relay
to the user), get_job. Official MCP registry: com.sfxmint/sounds.
Skill for coding agents (Claude Code, Cursor): npx skills add flreey/sfxmint-mcp -y