MCP Server
Connect the Lotsofsounds sound effects API to Claude, Cursor, ChatGPT, and any AI agent with our free, open Model Context Protocol (MCP) server. Search, preview, and download royalty-free sounds from your AI assistant.
The sound effects MCP server for AI assistants
Lotsofsounds ships a hosted Model Context Protocol (MCP) server so AI assistants can search, inspect, and download thousands of royalty-free (CC0) sound effects without leaving the chat. Add one URL to Claude Desktop, Cursor, Windsurf, ChatGPT, or the OpenAI Agents SDK and your assistant can find the right sound for a game, app, video, or voice agent on demand.
- Endpoint:
https://api.lotsofsounds.com/mcp - Transport: Streamable HTTP (stateless)
- Auth: your Lotsofsounds API key in the
x-api-keyheader - Free tier:
browse_samplesworks with no key — try it before you subscribe
Free to connect, Pro to search the full catalog
Browsing free sample sounds needs no key. Searching and downloading the full catalog requires a Pro or Enterprise plan — get your key from the API Keys dashboard.
Tools exposed
| Tool | What it does | Auth |
|---|---|---|
browse_samples | Returns curated free CC0 sample sounds | None |
search_sounds | Searches the full catalog by natural language, tags, category, and duration | Pro / Enterprise |
get_sound | Full metadata for a single sound | Pro / Enterprise |
download_sound | Time-limited signed download URL (1 hour) | Pro / Enterprise |
Add it to Claude Desktop
Claude Desktop connects to remote MCP servers through the mcp-remote bridge. Add this to your claude_desktop_config.json (Settings → Developer → Edit Config), then restart Claude:
{
"mcpServers": {
"lotsofsounds": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.lotsofsounds.com/mcp",
"--header",
"x-api-key:${LOS_API_KEY}"
],
"env": { "LOS_API_KEY": "los_your_key" }
}
}
}Ask Claude "find me a short dramatic cinematic hit" and it will call search_sounds for you.
Add it to Cursor
In ~/.cursor/mcp.json (or Settings → MCP → Add new server):
{
"mcpServers": {
"lotsofsounds": {
"url": "https://api.lotsofsounds.com/mcp",
"headers": { "x-api-key": "los_your_key" }
}
}
}Windsurf, VS Code (Copilot MCP), and other Streamable-HTTP clients use the same url + headers shape.
Add it to Claude Code
claude mcp add lotsofsounds --transport http https://api.lotsofsounds.com/mcp \
--header "x-api-key: los_your_key"Use it with the OpenAI Agents SDK
The hosted MCP server works as a tool source for GPT agents:
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp
sounds = MCPServerStreamableHttp(
params={
"url": "https://api.lotsofsounds.com/mcp",
"headers": {"x-api-key": "los_your_key"},
}
)
agent = Agent(
name="Sound assistant",
instructions="Help the user find royalty-free sound effects.",
mcp_servers=[sounds],
)
result = await Runner.run(agent, "Find a gentle notification chime under 2 seconds")
print(result.final_output)Use it with ChatGPT
In ChatGPT (Settings → Connectors → Add), point a custom connector at
https://api.lotsofsounds.com/mcp and supply your x-api-key header. The
search_sounds and download_sound tools become available in chat.
How the paywall works
The MCP server is a thin client over the same REST API — it never widens access
beyond a caller's plan. Without a key, catalog tools return a friendly message
pointing to pricing; the free browse_samples tool always works. This
keeps the server safe to open-source and list in public MCP directories while the
catalog stays behind the Pro tier.
Related
- LLM & AI Agent Integration — function-calling without MCP
- Getting Started — get your API key
- Pricing — Pro and Enterprise plans
Ready to integrate?
Get your API key and start building with thousands of sound effects and music tracks.
Get your API key