Skip to main content
Glama

SFXMint MCP Server

Free CC0 sound effects — describe a sound to find it, preview, and download WAV or MP3. Search with no signup or API key; no attribution. Agents can ask by role, take one of 26 sets, or search the library, and get permanent hotlinkable URLs. When nothing in the library fits, the agent tells the user which sound is missing; SFXMint no longer makes new sounds, and new ones join the library from what people search for.

Free use has a daily allowance: without a key, 20 lookups and tool calls a day per network and no downloads; a free account's API key (no card) gives 100 calls and 3 different sound downloads a day, the website and the API together (a second format or a retry of the same sound is not counted again). Download credits, one a sound in every format and never expiring, go past the limits, and file URLs returned to their keyed requests carry a signed g= good for 48 hours. Past a limit the answer is 429 download_limit or call_limit with a message to pass on to the user word for word; an agent never pays. Listening to an MP3 in a browser is never counted; a WAV fetched to listen is a download. Keep page_url in SOUNDS.md, never a URL with g=.

Sounds are AI-generated or procedurally synthesized and offered under CC0. Audio URLs are immutable, CORS-enabled and free to hotlink. Download files into the project when offline playback is required; preview suitability in the actual app or game.

Quick start

Claude Code, as a plugin (the MCP server plus the skill below):

/plugin install sfxmint --marketplace sfxmint/sfxmint-mcp

On Claude Code before 2.1.275, run /plugin marketplace add sfxmint/sfxmint-mcp, then /plugin install sfxmint@sfxmint. Or add only the MCP server:

claude mcp add --transport http sfxmint "https://sfxmint.com/mcp?ref=github-readme"

Gemini CLI, as an extension (the MCP server, a context file and the skill):

gemini extensions install https://github.com/sfxmint/sfxmint-mcp

Codex CLI, as a plugin (the MCP server plus the skill):

codex plugin marketplace add sfxmint/sfxmint-mcp
codex plugin add sfxmint@sfxmint

Cursor / generic mcpServers config:

{ "mcpServers": { "sfxmint": { "url": "https://sfxmint.com/mcp?ref=github-readme" } } }

With a free account's API key (needed to download files; download credits lift the limits for the key's account):

claude mcp add --transport http sfxmint "https://sfxmint.com/mcp?ref=github-readme" --header "Authorization: Bearer $SFXMINT_API_KEY"
{ "mcpServers": { "sfxmint": { "url": "https://sfxmint.com/mcp?ref=github-readme", "headers": { "Authorization": "Bearer sfx_live_…" } } } }

Prefer a skill over a server? This repo also ships an Agent Skill that uses the plain HTTP API — no MCP server required:

npx skills add sfxmint/sfxmint-mcp -y

The agent chooses a role for one event, a set for several events, or structured search for a description or gap. These are task branches, not a required sequence. Library files, other permitted sources and local synthesis can be mixed. The skill includes React / Phaser / plain-HTML integration examples. Source: skills/sfxmint/SKILL.md.

No agent involved? The sfxmint CLI puts the same files in a project directly:

npx sfxmint add coin jump hit

It writes the audio plus a sounds.json manifest recording each file's source URL, SHA-256 and license, and a SOUNDS.md table linking each sound's page, and ships a small Web Audio runtime (createSoundboard) for first-gesture unlock, overlapping cues and a persisted mute. Source: sfxmint/sfxmint-npm.

Related MCP server: strongerfx

Tutorials

Tools

Tool

What it does

get_role_sound

Ask by event — button-click, purchase-success, error, coin, notification. Returns a file-checked candidate plus alternates; plain-English aliases work

get_sound_set

Candidates grouped by event and style (26 sets: ui-crisp, retro-game, checkout, platformer, fantasy-rpg, ai-coding-tool, …)

search_sounds

Free-text retrieval with explicit duration, loop and format requirements; hard constraints can produce no candidates. When nothing fits, user_message is one line for the user saying which sound the library lacks

get_sound

Full metadata for one sound (incl. a short description, measured acoustics with a 16-point level envelope and low/mid/high energy, license)

create_listen_page

For several events of one project: a page where the user plays about three candidates an event (MP3, never counted), keeps one each, adds a note and presses Done. Returns listen_url and a code good for 24 hours

get_picks

The user's picks from a listening page, with notes, and which ones fit today's free downloads and which take credits; only the key that made the page reads them

For a whole app or game, give the user the listening page first and download what they picked; if they say "you decide", download your picks directly. When nothing fits, pass user_message on to the user and list the sound under a Missing heading in SOUNDS.md. The library tools above are all there is for new users: SFXMint no longer makes new sounds. An account that already has credits or a plan still sees generate_sound and get_generation with its API key. Game kits (projects of many sounds) closed on 2026-10-20; their tools answer tool_retired. get_job and POST /api/v1/generate stay retired.

Requirements, processing and acceptance

Use REST structured search (response=structured&limit=3) or the matching MCP parameters to pass required duration, loop and format explicitly. Check returned requirements; do not substitute near_matches. When nothing matches every word, closest lists the nearest sounds that meet every hard requirement, each with missing_terms, and library_fit says how well the library covers the request. Scores and match types describe ranking, not listening confidence. Legacy loopable does not prove a seamless loop.

Sets accept format=wav|mp3: download_urls follows the requested format, legacy urls stays MP3, and missing_roles identifies incomplete sets. File decoding and hashes do not certify scene suitability.

Task-permitted trimming, filtering and level changes are allowed. Retain originals, source URLs, license, processing recipes and new file hashes; re-measure requirements and preview the result. Changed bytes and new scenes do not inherit the original acceptance. Other sources and local synthesis remain separate, task-authorized choices.

Use URLs returned by the live API, without inventing or rewriting them. See the API docs, Phaser guide, React guide, and download example.

Rate limits & fair use

  • Without a key: 20 lookups and tool calls a day per network, no downloads; a free account's API key: 100 calls and 3 sound downloads a day, the website and the API together

  • Hotlinking is allowed and encouraged; files are served with long-lived immutable caching

Contact

hello@sfxmint.com · https://sfxmint.com

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables searching and downloading audio samples from Freesound using keywords, filters, and sound IDs. It provides detailed sound metadata including duration, license information, and preview URLs.
      2
      2
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides local MCP tools to search and retrieve CC0 sound effects by keyword, category, duration, or ID, along with metadata, previews, and WAV/MP3 download URLs.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to search, rank, and retrieve 330 synthesized sound effects, themes, and spoken lines, and to generate ready-to-paste playback code or whole-app sound kits through a zero-dependency stdio MCP interface.
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants and code to search a large library of free sound effects, music, and ambience by keywords and filters such as type, length, tempo, key, mood, and use case. It also exposes full metadata for individual sounds and themed packs, plus download links with ready-to-run curl commands for pulling the full-quality files.
      1
      MIT