Lots of Sounds MCP server

Free Sound Effects API

A public, no-key API for searching and previewing curated free sound effects. Built for apps, games, videos, automation, and AI agents by Lots of Sounds.

• No API key for the sample list and sample streams
• Structured JSON with IDs, descriptions, tags, and durations
• CC0 sound effects in the sample collection
• No audio binaries stored in this repository

Looking for a maintained Freesound API alternative? Start with the free sample endpoint below, then use the full Lots of Sounds API when you need catalog search, filters, and downloads.

Quick start

curl -G "https://api.lotsofsounds.com/api/v1/sounds/sample" \
  --data-urlencode "q=door knock" \
  --data-urlencode "limit=6"

No account or API key is required. The response contains up to 12 curated samples:

{
  "data": [
    {
      "id": "fs-133889",
      "name": "Large Wood Door Knocking",
      "description": "Knocking on a door to a large entry",
      "tags": ["door", "knocking", "wood"],
      "duration": 2.86766,
      "stream_url": "/api/v1/sounds/sample/fs-133889/stream"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 6,
    "total": 6,
    "totalPages": 1
  }
}

The example is abbreviated; fields and matching results can change as the curated sample set improves.

Free endpoints

Search samples

Use q for a text query or tags for comma-separated tags. limit accepts 1 through 12.

curl -G "https://api.lotsofsounds.com/api/v1/sounds/sample" \
  --data-urlencode "tags=door,knock" \
  --data-urlencode "limit=6"

Stream a sample

Use the relative stream_url returned with a sound:

curl "https://api.lotsofsounds.com/api/v1/sounds/sample/fs-133889/stream"

This returns JSON containing a time-limited stream_url; it does not put an MP3 in this repository.

JavaScript

Requires Node.js 18 or newer.

const params = new URLSearchParams({ q: "notification", limit: "6" });
const response = await fetch(
  `https://api.lotsofsounds.com/api/v1/sounds/sample?${params}`,
);

if (!response.ok) {
  throw new Error(`Lots of Sounds returned HTTP ${response.status}`);
}

const { data } = await response.json();
console.log(data);

Run the complete dependency-free example:

node examples/javascript.mjs "notification"

For a typed client that also supports authenticated search, metadata, and downloads, see lotsofsounds/sound-effects-api-js.

Python

The included example uses only the Python standard library:

git clone https://github.com/lotsofsounds/free-sound-effects-api.git
cd free-sound-effects-api
python3 examples/python.py "notification"

Or use requests directly:

import requests

response = requests.get(
    "https://api.lotsofsounds.com/api/v1/sounds/sample",
    params={"q": "notification", "limit": 6},
    timeout=20,
)
response.raise_for_status()
print(response.json()["data"])

AI agents

Agent skill

This repository includes a dependency-free find-free-sound-effects skill. Copy that directory into your agent's skills directory, or point your agent at the checked-out repository.

Example request:

Find a short, calm notification sound for an AI assistant.

The skill searches the free endpoint, compares metadata, and requests a temporary stream URL for the selected sample.

MCP server

Lots of Sounds also provides a hosted Model Context Protocol server:

claude mcp add lotsofsounds --transport http https://api.lotsofsounds.com/mcp

Shortened. The full README is on GitHub.