home / mcp / myinstants mcp server

Myinstants MCP Server

Provides access to myinstants soundboard data and actions via MCP: search, play, browse categories, and manage playback.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "austenstone-myinstants-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "myinstants-mcp@latest"
      ],
      "env": {
        "MYINSTANTS_WAIT": "false",
        "MYINSTANTS_VOLUME": "0.5"
      }
    }
  }
}

You can empower your AI agent with a vast, internet-wide soundboard by running a lightweight MCP server that connects to myinstants. This server lets your agent search for sounds, play them through your speakers, browse categories, see what's trending, and control playback behavior, turning sound effects into practical, ambient responses for testing, automation, or just for fun.

How to use

Connect to the MCP server from your MCP client or integration. Once connected, you can use the following capabilities:

- Search for sounds using search_sounds to locate MP3 assets on myinstants.

- Play a sound immediately with play_sound by slug, URL, or quick search. The sound streams to your output device and can block or run in the background depending on your choice.

- Browse categories to locate memes, games, reactions, and other sound clips.

- Check what’s trending to stay up to date with popular sounds.

- Control blocking behavior with the wait option so sounds play in the foreground or background as you prefer.

How to install

Prerequisites: ensure Node.js and npm are installed on your system.

Option A — run directly with npx (quick start):

npx myinstants-mcp

Option B — configure a client to launch the MCP server via a standard MCP config (example for an editor or Copilot integration):

{
  "servers": {
    "myinstants": {
      "command": "npx",
      "args": ["-y", "myinstants-mcp@latest"]
    }
  }
}

Additional setup notes

You can place the server in your workspace configuration to auto-launch with your editor or automation tooling. The provided configuration works with VS Code Copilot setup, Claude Desktop, and Cursor configurations shown in examples.

Additional content and options

The server supports environment variables to tune playback behavior and how the agent interacts with sounds.

Configuration and environment variables

Set processing and playback options through environment variables when launching the MCP server.

Troubleshooting and notes

If playback fails to start, verify your audio player is installed and accessible. The server auto-detects available players, preferring afplay on macOS, then ffplay, then mpv.

Examples and quick references

Common command to start the server via npx is shown above. You can also adapt startup for your editor or automation pipeline using the Copilot/JSON examples.

Available tools

search_sounds

Search myinstants for sounds and return matching results with slugs

browse_category

Browse sounds by category such as memes, games, reactions, etc.

play_sound

Play a sound by slug, URL, or through a quick search; supports optional blocking with wait