# Freesound MCP > Freesound MCP connects your AI client to Freesound's massive library of Creative Commons audio samples. Search for sound effects by tag or duration, get detailed metadata on any asset, download high-quality originals, and even upload new recordings—all through natural conversation. ## Overview - **Category:** design-creative - **Price:** Free - **Tags:** audio-samples, sound-effects, creative-commons, music-production, audio-library ## Description Need a specific sound effect but hate leaving your creative environment? This MCP lets you search the world's largest database of audio samples directly through your agent. Instead of opening multiple tabs and sifting through file names, you just describe what you need. The AI handles the complex filtering, letting you narrow down searches based on tags, duration, or license type instantly. You can check if a sound pack is available using `get_pack`, verify details about any single sound with `get_sound`, and even upload your own recordings for later management via `upload_sound` and `describe_sound`. This puts professional-grade audio discovery right where you work. Connecting this tool through the Vinkius catalog means your AI client accesses all of Freesound's capabilities in one place, letting you manage assets without ever switching context. ## Tools ### describe_sound Adds descriptive metadata and tags to an audio file after you upload it. ### download_sound Triggers the download of a sound's original, high-quality source file. ### get_me Retrieves profile information for the user currently authenticated with your account. ### get_pack Gets detailed information about an entire collection or organized package of sounds. ### get_pending_uploads Checks the status and moderation queue for any audio files you've recently uploaded. ### get_sound Fetches all specific details, tags, and file info for a single identified sound asset. ### get_user_sounds Lists all the audio assets that a specific user has uploaded to the database. ### get_user Gets profile information about any other registered Freesound user. ### search_sounds Searches the entire Freesound library using advanced filters and text queries for sound effects. ### upload_sound Uploads a new audio file from your local machine into the Freesound database. ## Prompt Examples **Prompt:** ``` Search for high-quality cinematic impact sounds on Freesound. ``` **Response:** ``` I found several cinematic impact sounds. The top result is 'Heavy Cinematic Hit' (ID: 12345) with tags like 'impact', 'cinematic', and 'bass'. Would you like to see more details or download it? ``` **Prompt:** ``` Get the metadata and tags for sound ID 45678. ``` **Response:** ``` Sound 45678 is titled 'Electric Hum'. It is a 44.1kHz WAV file with tags: 'noise', 'electronic', 'loop'. It has been downloaded 1,200 times. ``` **Prompt:** ``` Show me the sounds uploaded by user 'audio_pro'. ``` **Response:** ``` User 'audio_pro' has uploaded 12 sounds, including 'Studio Kick' and 'Snare Hit'. Would you like the specific IDs or descriptions for these sounds? ``` ## Capabilities ### Search and Filter Sounds Find specific audio samples by running complex text queries or applying detailed Solr-style filters for tags, length, or license type. ### Retrieve Asset Details Fetch deep metadata, usage statistics, and analysis for any sound or organized collection of sounds in the database. ### Manage User Profiles View information about other Freesound users, including their public uploads and entire collections of work. ### Upload and Classify Assets Send in your own audio files for the database. You can also provide detailed metadata descriptions when you upload them. ### Monitor Upload Status Check the status of any sounds you've submitted, particularly those awaiting moderation approval. ### Download Files Trigger a direct download for the original, high-quality version of an audio file. ## Use Cases ### Finding niche SFX for a game level A developer needs the sound of an old, rusty door creaking open. Instead of vague searching, they ask their agent to `search_sounds` using filters: 'door', 'creak', and 'rusty'. The agent returns top results, and the developer uses `download_sound` on the best match. ### Categorizing a batch of new recordings A sound artist records 20 ambient sounds. They use `upload_sound` for all of them. Then, they call `describe_sound` in batches to apply consistent metadata and tags across the entire set before monitoring their status with `get_pending_uploads`. ### Researching a competitor's sound palette A marketing team wants to know what kind of sounds another creator uses. They ask their agent to look up the public uploads from that user using `get_user_sounds`, getting an overview without needing direct account access. ### Verifying asset rights and details Before committing a sound, you need to verify its source and license. You use `get_sound` on the ID provided by your agent. This returns all tags and details so you can confirm it's safe for commercial use. ## Benefits - You don't have to switch between asset management tools. The ability to search using `search_sounds` means you can find exactly what you need—whether it's a 'metallic clang' or an 'atmospheric hum'—without ever leaving your chat window. - Stop guessing about file quality or licensing. When you use `get_sound`, the MCP provides all necessary metadata, including usage counts and precise details on the original file format and bit depth. - Need to contribute? You can upload new sounds using `upload_sound` and then immediately describe them with context and tags using `describe_sound`. It’s a single workflow for contribution. - Project managers love that you don't have to manually check status. Using `get_pending_uploads` lets your agent monitor submissions, so you know when your new sound is ready for public use. - You can gather context on contributors by using the MCP to get user details via `get_user`, letting you see who uploaded a specific asset and reviewing their full portfolio with `get_user_sounds`. ## How It Works The bottom line is that you interact entirely through natural language; the MCP handles all the complex API calls behind the scenes. 1. Subscribe to this MCP and enter your Freesound API Key or OAuth Token. 2. Tell your AI client what you need. For example, 'Find a looping sci-fi hum with a CC0 license.' 3. The agent executes the search and returns results. You then ask it to download the file or check details for specific items. ## Frequently Asked Questions **How do I search for sounds using the search_sounds tool?** You describe your needs naturally, but remember that `search_sounds` supports Solr-style filters. You can specify minimum duration, required tags, or license types right in your prompt. **Does get_sound give me enough information to use the asset commercially?** It provides detailed metadata and usage information, but always verify the specific Creative Commons license attached to that sound before using it commercially. Check `get_sound` results carefully. **What is the difference between upload_sound and describe_sound?** `upload_sound` gets the file into the database. You then run `describe_sound` to add context, tags, and detailed notes about that specific recording. **Can I see what sounds a user uploaded with get_user_sounds?** Yes. `get_user_sounds` lists all the assets associated with a given contributor's profile ID. This lets you quickly gauge their style and expertise. **What information does the `get_me` tool provide after I authenticate my account?** It retrieves key details about your authenticated Freesound user profile. You get basic identifying data, confirming that your AI client has connected correctly to your personal account settings. **How do I check the status of sounds in moderation using `get_pending_uploads`?** This tool checks the backend queue for any uploads awaiting review. It shows you which files are pending approval and helps manage your submission workflow until they go live. **Can I get detailed metadata about a sound collection using `get_pack`?** Yes, `get_pack` fetches comprehensive information about an entire organized group of sounds. You can analyze the pack's contents and overall structure without having to query every individual asset. **What does running the `download_sound` tool actually do?** The tool triggers a direct download of the original, high-quality sound file. It handles the transfer process, making sure you get the full, uncompressed audio asset immediately. **How do I find specific sounds like 'ambient rain' with a short duration?** Use the `search_sounds` tool with `query: 'ambient rain'` and `filter: 'duration:[1 TO 10]'`. This uses Solr syntax to narrow down results precisely. **Can I download the original high-quality file directly?** Yes! Use the `download_sound` action with the specific Sound ID. Note that this requires a valid `FREESOUND_OAUTH_TOKEN` to authorize the download. **How can I check if my uploaded sounds are already public?** You can use `get_pending_uploads` to see sounds currently in the moderation queue, or `get_me` to see your profile status and total uploads.