Myinstants MCP

1<h1 align="center">🔴 myinstants-mcp</h1>
2 
3<p align="center">
4  <strong>give your AI agent a soundboard. no cap.</strong><br/>
5  <sub>millions of sound buttons · zero config · just vibes ✨</sub>
6</p>
7 
8<p align="center">
9  <a href="https://www.npmjs.com/package/myinstants-mcp"><img src="https://img.shields.io/npm/v/myinstants-mcp?style=flat-square&color=red" alt="npm version" /></a>
10  <a href="https://www.npmjs.com/package/myinstants-mcp"><img src="https://img.shields.io/npm/dm/myinstants-mcp?style=flat-square&color=orange" alt="npm downloads" /></a>
11  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="license" /></a>
12</p>
13 
14---
15 
16<img src="images/robot.png" width="100%" />
17 
18## fr fr what is this
19 
20an [MCP](https://modelcontextprotocol.io) server that connects AI agents to [myinstants.com](https://www.myinstants.com) — the internet's largest soundboard. millions of meme sounds, vine booms, fart noises, anime clips, gaming sfx, whatever you need bestie.
21 
22your AI agent can now:
23 
24- 🔍 **search** any sound on myinstants
25- 🔴 **smash that button** and play it through your speakers
26- 📂 **browse categories** — memes, games, movies, reactions, tiktok trends
27- 📈 **check what's trending** — stay current fr fr
28- ⏳ **wait or don't** — block until sound finishes or let it play in the background
29 
30this is not a notification beep. this is the entire internet soundboard. your agent has rizz now.
31 
32## the setup is bussin
33 
34```bash
35npx myinstants-mcp
36```
37 
38that's it. that's the setup. no cap.
39 
40### VS Code / GitHub Copilot
41 
42Add to your VS Code MCP config (User or `.vscode/mcp.json`):
43 
44```json
45{
46  "servers": {
47    "myinstants": {
48      "command": "npx",
49      "args": ["-y", "myinstants-mcp@latest"]
50    }
51  }
52}
53```
54 
55### Claude Desktop
56 
57`~/Library/Application Support/Claude/claude_desktop_config.json`:
58 
59```json
60{
61  "mcpServers": {
62    "myinstants": {
63      "command": "npx",
64      "args": ["-y", "myinstants-mcp@latest"]
65    }
66  }
67}
68```
69 
70### Cursor
71 
72`.cursor/mcp.json`:
73 
74```json
75{
76  "mcpServers": {
77    "myinstants": {
78      "command": "npx",
79      "args": ["-y", "myinstants-mcp@latest"]
80    }
81  }
82}
83```
84 
85> [!TIP]
86> works on **macOS** out of the box (uses native `afplay`) — no extra installs needed. on linux just `sudo apt install ffmpeg`. that's it bestie.
87 
88---
89 
90<img src="images/banner.png" width="100%" />
91 
92## what can it do tho 🤔
93 
94### 🔧 Tools
95 
96| Tool | What it does | It's giving |
97|------|-------------|---------|
98| `search_sounds` | search myinstants for sounds | `"bruh"` → 20 results with slugs |
99| `browse_category` | browse by category | `"memes"` `"games"` `"reactions"` |
100| `play_sound` | play a sound (by slug, url, or quick search) | `{ query: "sad trombone" }` plays instantly |
101 
102#### `play_sound` options
103 
104| Parameter | Type | Default | The tea ☕ |
105|-----------|------|---------|-----------|
106| `query` | string | — | quick search, plays first result. the goat option. |
107| `slug` | string | — | exact slug from search results |
108| `url` | string | — | direct MP3 URL if you're built different |
109| `wait` | boolean | `false` | `false` = plays in background while agent keeps cooking (default 💨). `true` = blocks until done (for dramatic effect 🎭) |
110 
111### 📚 Resources
112 
113| Resource | The vibe |
114|----------|-------------|
115| `myinstants://trending` | what's bussin rn in the US 🔥 |
116| `myinstants://categories` | all 14 categories no cap |
117| `myinstants://best` | hall of fame. the GOATs. the legends. 🐐 |
118 
119### Categories
120 
121`anime & manga` · `games` · `memes` · `movies` · `music` · `politics` · `pranks` · `reactions` · `sound effects` · `sports` · `television` · `tiktok trends` · `viral` · `whatsapp audios`
122 
123## how it works (for the sigma devs)
124 
125```
126agent calls play_sound({ query: "vine boom", wait: false })
127  → searches myinstants.com
128  → finds the MP3 URL
129  → streams it through afplay/ffplay/mpv
130  → sound plays through your speakers
131  → agent keeps cooking while you hear the boom 🍳
132```
133 
134sounds queue up automatically. no overlap. your agent can fire multiple sounds and they play one after another. sheesh.
135 
136## teach your agent to troll you 💀
137 
138drop a `.github/copilot-instructions.md` in your repo and your agent will play sounds **while it works**. imagine: vine boom when it finds a bug. sad trombone when your tests fail. rick roll mid-code-review for absolutely no reason.
139 
140```markdown
141# in your .github/copilot-instructions.md
142 
143Play sounds using the myinstants MCP server while you work:
144- Play `play_sound(query: "vine boom sound")` when you find cursed code
145- Play `play_sound(query: "sad trombone")` when the user's code doesn't work
146- Play `play_sound(query: "minecraft level up sound")` when you fix something
147```
148 
149check our [copilot-instructions.md](.github/copilot-instructions.md) for the full unhinged setup. your agent will never be an NPC again. 🏆
150 
151## config
152 
153### env vars
154 
155| Variable | Default | The tea ☕ |
156|----------|---------|------|
157| `MYINSTANTS_VOLUME` | `0.5` | how loud (0-1). crank it bestie. |
158| `MYINSTANTS_WAIT` | `false` | `"true"` = sounds block until finished. dramatic effect mode 🎭 |
159 
160```json
161{
162  "servers": {
163    "myinstants": {
164      "command": "npx",
165      "args": ["-y", "myinstants-mcp@latest"],
166      "env": {
167        "MYINSTANTS_VOLUME": "0.8"
168      }
169    }
170  }
171}
172```
173 
174### audio player support
175 
176| Player | Platform | Install | Vibe |
177|--------|----------|---------|------|
178| `afplay` | macOS | pre-installed 💅 | just works. zero effort. slay. |
179| `ffplay` | everywhere | `brew install ffmpeg` / `apt install ffmpeg` | the reliable bestie |
180| `mpv` | everywhere | `brew install mpv` / `apt install mpv` | also valid no cap |
181 
182auto-detects what you have. tries `afplay` first on mac, then `ffplay`, then `mpv`. fallback chain is bussin.
183 
184## why tho 💀
185 
186because your AI agent should be able to hit you with a vine boom when the code compiles. because sad trombone when tests fail is objectively correct. because the bruh button exists and your agent deserves to press it. this is not delulu — this is the future.
187 
188every other MCP sound server plays one notification beep. **one beep.** that's giving NPC energy. we have millions of sounds. the entire internet soundboard. main character behavior only.
189 
190## it's giving... open source 💅
191 
192made by [@austenstone](https://github.com/austenstone) 🏷️
193 
194powered by [myinstants.com](https://www.myinstants.com) · built with [MCP](https://modelcontextprotocol.io)
195 
196no cap this might be the most unhinged MCP server ever and we're lowkey proud of it 💀🔥
197