Sound Effects API

Direct file URLs

Every sound has permanent download URLs in each format, free to hotlink from a web page or game with no key. Put one straight into an <audio> tag or new Audio(), or download it with curl:

https://sfxmint.com/dl/ui-click-30.mp3
https://sfxmint.com/dl/ui-click-30.wav
curl -O https://sfxmint.com/dl/ui-click-30.wav

Search, roles and sets return these URLs for each sound, with its measured length, format and SHA-256. To find the role for an event (click, success, purchase-success, level-up), see the sound roles reference.

Generating sounds with an API key

Quick start

curl "https://sfxmint.com/api/v1/search?q=door+slam&limit=5"
curl "https://sfxmint.com/api/v1/roles/button-click"

Guides

Step by step: Add sound effects to a React app · Add sound effects to a Phaser web game. Using Claude Code, Cursor or another coding agent? Install the skill and the agent learns the role → set → search workflow below:

npx skills add flreey/sfxmint-mcp -y

Endpoints

Rate limits

MCP server (for AI agents)

SFXMint exposes the same capabilities as a remote MCP server (Streamable HTTP), so Claude, Cursor and other agents can look up, search and download existing sounds, and with an API key generate new ones.

Claude Code

claude mcp add --transport http sfxmint https://sfxmint.com/mcp \
  --header "Authorization: Bearer $SFXMINT_API_KEY"  # the key only for generating and Game kits

Cursor / other clients (mcpServers JSON)

{
  "mcpServers": {
    "sfxmint": {
      "url": "https://sfxmint.com/mcp",
      "headers": { "Authorization": "Bearer sfx_live_…" }
    }
  }
}

Tools: search_sounds · get_role_sound · get_sound · get_sound_set · generate_sound · get_generation · start_game_kit · get_game_kit · list_kit_sounds · make_kit_sounds · pick_kit_take · change_kit_take · export_game_kit

Sounds for a whole game: start_game_kit plans a Game kit from a description of the game, the same project the user opens on the website. Its scenes are checked and listed for free (list_kit_sounds), each sound gets up to four takes (make_kit_sounds), a close take is changed as it is for free (change_kit_take), the user picks (pick_kit_take) and export_game_kit gives the files with an event map. Pricing: describe a game and get its list of sounds for free; each sound made is one of the account's 3 free tries on the website, or comes from a 24-hour pass ($3.90, 50 sounds) or a plan (from $9.90 for 30 days, 50 to 200 a day) on the account; 4 takes per generation and no cumulative generation cap. Nothing is charged; with a key and no planmake_kit_sounds answers payment_required with buy_url, the page where the user chooses a plan. Use the library first and the kit for what it lacks.

Choose get_role_sound(role, style?) for a named event or interaction; get_sound_set for multiple events; search_sounds for a description or a gap. These are task branches, not a fixed sequence. When nothing fits, generate_sound makes new sounds with an API key (see Generating sounds with an API key) and get_generation follows one up; the other tools never need a key.

In Claude and ChatGPT

In Claude and ChatGPT, SFXMint answers with a card: play each sound, download it as WAV or MP3, or open its page. It searches the free library only, with no account or API key. Every sound is AI-generated and CC0.

Claude

Customize → Connectors → + Add → Add custom connector. Name it SFXMint, enter the URL below and choose No sign in.

https://sfxmint.com/mcp/claude

ChatGPT

At chatgpt.com/plugins, select + → Add custom MCP server. Enter the URL below and choose no authentication.

https://sfxmint.com/mcp/chatgpt

Ask in your own words: “find a glass shattering sound”, “I need a button click for my app”, “give me a set of sounds for a platformer”. Tools: search_sounds (a description, with an optional maximum length) · get_role_sound (the usual sound for an app or game event, with alternatives) · get_sound_set (one sound for each event of an app or game) · get_sound (one sound by its id). All four only read the library. What their requests store is on the privacy page; questions go to the contact page.

Changelog

Audio URLs and sound slugs never change. Response fields may be added at any time; removed fields and changed behavior are listed here by date.

2026-10-12

• MCP 1.7.0: making sounds with a key needs a pass or plan on the account (a 24-hour pass, the 30-day plan or Pro); the free tries are for the website and AI Studio only. A pass whose sounds are used answers 402 pass_used. Without one, POST /api/v1/orders and generate_sound answer 402 payment_required with buy_url and plans, and make_kit_sounds answers payment_required (was 429 daily_free_used and plan_required). Search hints carry needs_plan and buy_url; free_generations_per_day became free_tries_on_website. Searching and downloading are unchanged and need no key.

2026-10-10

• MCP 1.6.0: kits for apps as well as games. add_kit_sounds takes the user's own list (names, keys, order and lengths kept) or a set, fill_kit_from_library uses free library sounds first, find_kit_sound_candidates and use_library_sound choose one by hand. Making the gaps is unchanged.

2026-10-09

• MCP 1.5.0: plans belong to the account. A plan (from $9.90 for 30 days) raises the account's generations a day everywhere; free carries plan while one runs. The used-up answers give plans_url (was kit_url), a plan's used-up day is 429 plan_day_used, and make_kit_sounds answers plan_required with plans_url (was unlock_requiredwith unlock_url). No included-sound limit.
• MCP 1.4.0: no more credits. Generating is free: 3 generations a day per account, on the website, REST and MCP together. Once they are used, POST /api/v1/orders and generate_sound answer 429 daily_free_used(was 402 insufficient_credits); orders no longer carry credits, credits_returned or unlock_cost, and generate_sound no longer returns cost. Game kit tools drop use_credits and confirm_credits: a kit uses the free generations or its plan.
• MCP 1.3.0: Game kit tools for a whole game's sounds (start_game_kit and five more, with an API key). Search's generate_available carries the length limit and unmet_requirements; a request for a real-world recording is marked constraints.recorded.

2026-10-08

• MCP no longer refuses a request with a wrong, revoked or suspended key (it answered HTTP 401, which clients read as signed out): the library tools answer as without a key, and the generation tools report the key with isError. POST /api/v1/generate (still 410) now points to POST /api/v1/orders.

2026-10-07

• Generation with an API key: POST /api/v1/orders and the MCP tools generate_sound and get_generation, one credit per generation. Searching and downloading still need no key.

2026-09-26

• Removed prompt and generation_intent from sound metadata, search results and MCP results, and model and two internal bookkeeping fields from sound metadata. description (sound metadata and get_sound) is now a short standard description — what the sound is, how bright it is, the length of continuous sounds and typical uses — or null when none is available.
• Removed the internal source and processing fields from sets (REST and get_sound_set) and from the set ZIP manifest.
• Removed the 13 *-loop roles (they now return 404) and loopable from the items of GET /api/v1/roles. The per-sound loopable flag is unchanged.
• Merged 20 small sound families into their larger duplicates. The old family pages redirect (301) and family_url points at the merged page; sound slugs and /dl URLs are unchanged.
• Search recognizes family names and common synonyms: swish finds swooshes and crowd cheer finds crowd cheering.

License & hotlinking

SFXMint library files are CC0 1.0 — commercial use, no attribution. External providers' output uses their own licenses. Hotlinking is allowed and encouraged: audio URLs never change and are served from edge cache. Please don't mirror-scrape the whole catalog in one burst; the API is friendlier.