dank-meme-sounds
by TanKucukhas
README.md
# dank-meme-sounds
**A meme soundboard for AI agents.** Give Claude, Cursor, Codex, ChatGPT or any MCP client instant access to **38,000+ meme sound effects** from [DankMachine](https://dankmachine.com): vine boom, bruh, sad violin, airhorn, Windows XP error, anime wow, and every reaction sound the internet runs on.
Your agent can **find the right sound for a moment** ("my code finally compiled", "awkward silence", "someone got roasted"), search by name, mood or use case, see what's trending right now, and **play it out loud** on your speakers.
[](https://www.npmjs.com/package/dank-meme-sounds)
[](https://dankmachine.com/developers/)
[](LICENSE)
- 🔊 38k+ sounds, each with an MP3 URL and a sound page; the most popular ones have their own pixel-art icon
- 🧠 Sounds come with AI-written metadata: what it is, **when to use it**, moods, use cases and alternate names
- 🎯 `find_reaction_sound`: describe the situation, get the fitting sounds
- 📈 Live trending from real plays on dankmachine.com (1h / 24h / 7d)
- ▶️ `play_sound` plays it locally (macOS, Windows, Linux) — great for coding-agent hooks
- 🌐 Zero setup remote server, or a tiny local npm package. No API key.
---
## Quick start
### Remote server (no install)
```bash
claude mcp add --transport http dank-meme-sounds https://dankmachine.com/mcp
```
Any client that supports Streamable HTTP:
```json
{
"mcpServers": {
"dank-meme-sounds": { "url": "https://dankmachine.com/mcp" }
}
}
```
### Local server (adds `play_sound` on your speakers)
**Claude Code**
```bash
claude mcp add dankmachine -- npx -y dank-meme-sounds
```
**Claude Desktop / Cursor / Windsurf / Cline / Zed** (`mcpServers` config)
```json
{
"mcpServers": {
"dankmachine": { "command": "npx", "args": ["-y", "dank-meme-sounds"] }
}
}
```
**VS Code** (`.vscode/mcp.json`)
```json
{
"servers": {
"dankmachine": { "type": "stdio", "command": "npx", "args": ["-y", "dank-meme-sounds"] }
}
}
```
**OpenAI Codex CLI** (`~/.codex/config.toml`)
```toml
[mcp_servers.dankmachine]
command = "npx"
args = ["-y", "dank-meme-sounds"]
```
Requires Node.js 20+.
---
## Tools
| Tool | What it does | Example |
| --- | --- | --- |
| `find_reaction_sound` | Describe a moment, get the best-fitting sounds with what each means and when to use it | "my build failed again" → sad trombone, bruh, windows error |
| `get_trending_sounds` | What people are playing on DankMachine right now (`1h`, `24h`, `7d`) | "what's trending today?" |
| `search_sounds` | Search by title, tags, category or vibe | "vine boom", "minecraft", "anime" |
| `random_sound` | Random sound, optionally by category or vibe (funny, hype, cursed, wholesome, scary, sad, epic, dramatic…) | "random cursed sound" |
| `get_sound` | One sound by slug or best match | `vine-boom-sound-70972` |
| `list_categories` | All categories with counts (memes, gaming, reactions, anime, brainrot, tiktok…) | |
| `play_sound` | **Local only.** Plays the sound on your speakers (afplay, Windows MediaPlayer, mpg123/ffplay/paplay) | "play an airhorn when tests pass" |
Every result includes the title, category, tags, an `audio` MP3 URL, a pixel-art `image` when available, and the `page` on dankmachine.com.
### Prompts to try
- *"Play vine boom when the tests pass and sad violin when they fail."*
- *"Find me a sound for a dramatic reveal in my video."*
- *"What are the top 5 trending meme sounds today?"*
- *"Give me three hype sounds for my stream intro, with links."*
- *"Pick a random cursed sound and play it."*
---
## Sound effects for your coding agent (Claude Code hooks)
`npx dank-meme-sounds play "<query>"` plays a sound from the terminal, so hooks can use it. Add to `~/.claude/settings.json`:
```json
{
"hooks": {
"Stop": [{ "hooks": [{ "type": "command", "command": "npx -y dank-meme-sounds play \"vine boom\"" }] }],
"Notification": [{ "hooks": [{ "type": "command", "command": "npx -y dank-meme-sounds play \"discord notification\"" }] }],
"SessionStart": [{ "hooks": [{ "type": "command", "command": "npx -y dank-meme-sounds play \"windows xp startup\"" }] }]
}
}
```
Sounds are cached in your temp folder after the first play, and the CLI never fails a hook (it exits 0 when offline).
---
## REST API
The same catalog is a free JSON API with CORS, no key:
```
GET https://dankmachine.com/api/v1/search?q=vine%20boom&limit=5
GET https://dankmachine.com/api/v1/reaction?situation=my%20code%20compiled
GET https://dankmachine.com/api/v1/trending?window=24h
GET https://dankmachine.com/api/v1/sounds/<slug>
GET https://dankmachine.com/api/v1/sounds.json (full catalog)
GET https://dankmachine.com/api/v1/categories.json
```
Docs: https://dankmachine.com/developers/
## Configuration
| Env var | Default | Purpose |
| --- | --- | --- |
| `DANKMACHINE_API` | `https://dankmachine.com/api/v1` | Point the local server at another catalog |
## More from DankMachine
- **Live sound chat**: https://dankmachine.com/rooms/ — IRC-style chat where every sound plays for everyone
- **OBS overlay** for streamers: https://dankmachine.com/obs/?r=lobby
- **Upload your own sounds**: https://dankmachine.com/upload/
## Content and rights
Sounds are user-contributed meme clips; `rights_status` is `unverified`. Removal requests: https://dankmachine.com/takedown/
## License
MIT for this server's code. Sounds belong to their respective owners.
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues