Freesound MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Freesound MCP Server search for rain sounds with filter duration:[10 TO 30]"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Freesound MCP Server
An MCP (Model Context Protocol) server that provides access to the Freesound API, enabling AI assistants to search, analyze, and retrieve information about audio samples from Freesound.org.
Prerequisites
Node.js 16 or higher
A Freesound API key (get one at https://freesound.org/apiv2/apply)
Related MCP server: Claud-Ear
Installation
Clone this repository:
git clone <repository-url>
cd freesound-mcp-serverInstall dependencies:
npm installBuild the project:
npm run buildQuick Start with Claude Code
Global Installation (All Projects)
Get your Freesound API key from https://freesound.org/apiv2/apply
Add to Claude Code:
# From the freesound-mcp-server directory (user scope for global access)
claude mcp add freesound -e FREESOUND_API_KEY=your-api-key-here -- node /path/to/freesound-mcp-server/dist/index.jsVerifying Installation
To check if the MCP server is properly configured and running, use the /mcp command in Claude Code:
claude
> /mcpThis will show the status of all configured MCP servers.
Usage with Claude Desktop
Add the following to your Claude Desktop configuration file:
macOS
~/Library/Application Support/Claude/claude_desktop_config.json
Windows
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"freesound": {
"command": "node",
"args": ["/path/to/freesound-mcp-server/dist/index.js"],
"env": {
"FREESOUND_API_KEY": "your-api-key-here"
}
}
}
}Available Tools
search_sounds
Search for sounds on Freesound using text queries.
Parameters:
query(required): Search query termsfilter: Filter using Solr syntax (e.g., "duration:[1 TO 5]")sort: Sort results by various criteriapage: Page number (default: 1)page_size: Results per page (default: 15, max: 150)
Example:
Search for: "piano jazz" with filter "duration:[5 TO 30]" sorted by "downloads_desc"get_sound
Get detailed information about a specific sound.
Parameters:
sound_id(required): The ID of the sounddescriptors: Comma-separated list of content descriptors to include
get_sound_analysis
Retrieve audio analysis data for a sound.
Parameters:
sound_id(required): The ID of the sounddescriptors: Specific analysis descriptors to retrievenormalized: Whether to normalize descriptor values
get_similar_sounds
Find sounds similar to a given sound.
Parameters:
sound_id(required): The ID of the reference sounddescriptors_filter: Filter by content descriptorspage: Page numberpage_size: Results per page
get_user
Get information about a Freesound user.
Parameters:
username(required): The username
get_user_sounds
Get sounds uploaded by a specific user.
Parameters:
username(required): The usernamepage: Page numberpage_size: Results per page
get_pack
Get information about a sound pack.
Parameters:
pack_id(required): The ID of the pack
get_pack_sounds
Get sounds from a specific pack.
Parameters:
pack_id(required): The ID of the packpage: Page numberpage_size: Results per page
Development
Run the server in development mode:
npm run devAPI Limitations
Token authentication is used for most endpoints
OAuth2 is required for downloading sounds and write operations (not implemented in this version)
Rate limits apply based on your Freesound API plan
Maximum page size is 150 results
License
MIT
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Support
For issues with the Freesound API, consult:
Freesound API Documentation: https://freesound.org/docs/api/
Freesound API Forum: https://freesound.org/forum/
For issues with this MCP server, please open an issue on GitHub.
Available Tools
8 toolsget_packC
Get information about a sound pack
Inputs: pack_id (required).
get_pack_soundsC
Get sounds from a specific pack
Inputs: pack_id (required), page, page_size.
get_similar_soundsC
Find sounds similar to a given sound
Inputs: sound_id (required), descriptors_filter, page, page_size.
get_soundC
Get detailed information about a specific sound
Inputs: sound_id (required), descriptors.
get_sound_analysisC
Get audio analysis data for a specific sound
Inputs: sound_id (required), descriptors, normalized.
get_userC
Get information about a Freesound user
Inputs: username (required).
get_user_soundsC
Get sounds uploaded by a specific user
Inputs: username (required), page, page_size.
search_soundsC
Search for sounds on Freesound using text queries
Inputs: query (required), filter, sort, page, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool has a clearly distinct purpose targeting different resources and operations. The tools cover packs, sounds, users, and search with no overlap in functionality, making it easy for an agent to select the right tool.
All tools follow a consistent verb_noun naming pattern with 'get_' or 'search_' prefixes. The naming is uniform and predictable throughout the set, using snake_case consistently.
With 8 tools, this server is well-scoped for a Freesound API interface. Each tool serves a specific purpose in retrieving or searching for audio-related data, and none appear redundant or unnecessary.
The toolset provides comprehensive read/search operations for sounds, packs, and users, covering core workflows. A minor gap exists in lacking upload or modification tools, but this is reasonable for a retrieval-focused server.
Maintenance
Related MCP Connectors
An MCP server that integrates with Discord to provide AI-powered features.
MCP server for Producer/Riffusion AI music generation
MCP server exposing the AceDataCloud Fish Audio API (text-to-speech with voice conditioning)
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
Related MCP Servers
- FlicenseCqualityCmaintenanceAn MCP server that exposes speech-to-text and text-to-speech capabilities using a local speaches instance, allowing AI assistants to transcribe audio and generate speech.2-
- AlicenseNot gradedqualityDmaintenanceAn MCP server that gives AI agents the ability to listen to and understand music/audio files, enabling semantic analysis, stem separation, lyrics transcription, and signal processing via tool calls.1MIT
- AlicenseAqualityCmaintenanceAn MCP server that enables AI assistants to search, discover, and run any model on Replicate.5MIT
- AlicenseAqualityBmaintenanceGenerate AI images, video, voiceovers and music from Claude, Cursor or VS Code through 50+ models (Veo 3.1, Kling 3, Seedance, Nano Banana, GPT Image, ElevenLabs). Upload photos for edits and image-to-video. Tools are annotated (read-only vs. credit-spending); failed generations are refunded. Local via npx or hosted with OAuth at fattly.app.651 npmMIT