Goodrp

Detect what media the user is playing on Windows (Spotify, VLC, Chrome, etc.) via SMTC, and optionally display it on Discord via Rich Presence. Query current song/video details, set activity type (watching/listening), override media info, and manage Discord presence.

GoodRP — Media Detection & Discord Rich Presence

Detect what the user is playing on their PC (music, video, etc.) and optionally show it on Discord.

When to Use This Skill

Use this skill when the user asks to:

• Query media — "What am I listening to?", "What song is this?", "What video is playing?", "What's on right now?"
• Show on Discord — "Show my music on Discord", "Put this on my Discord status"
• Hide from Discord — "Hide my Discord status", "Remove my presence"
• Change display — "Show as watching instead of listening"
• Check status — "What's my Discord status?", "Is my music showing on Discord?"
• Auto/manual mode — "Auto-show my music on Discord"
• Override details — "Change the title to something else on Discord"
• Anything related to detecting the user's current media or Discord Rich Presence

How It Works

GoodRP detects media playback on Windows via SMTC (Spotify, VLC, Chrome, etc.) and exposes it as an MCP server (stdio) or HTTP API.

MCP Tools

Tool	Description
get_current_media	Get full details of what's playing (title, artist, album, estimated type)
set_presence	Show media on Discord (requires type: "watching" or "listening"; optional overrides)
clear_presence	Hide media from Discord
set_auto_show	Enable/disable auto-show when media plays
get_status	Check Discord connection and presence state
get_config	Read current GoodRP configuration

Key Rules

1. When calling set_presence, the type parameter is REQUIRED. You must explicitly choose "watching" or "listening" — GoodRP will not auto-detect for agents.
2. Content overrides (title, artist, album, app_name) are optional. If omitted, the detected media is used as-is.
3. estimated_type in get_current_media is computed from the app name: apps containing "video", "movie", "vlc", or "mpv" → "watching", otherwise → "listening".

Example Interactions

What am I listening to?

text

User: "What am I listening to?"
Agent:
  1. get_current_media() → returns title, artist, album, progress, estimated_type
  2. Reports: "You're listening to Bohemian Rhapsody by Queen — 3:15 of 5:54"

What video is playing?

text

User: "What video is playing right now?"
Agent:
  1. get_current_media() → returns title, app_name="VLC", estimated_type="watching"
  2. Reports: "You're watching Big Buck Bunny in VLC — 12:30 of 30:00"

Show music on Discord

text

User: "Show my music on Discord"
Agent:
  1. get_current_media() → verify media is playing, check estimated_type
  2. set_presence(type="listening") → show on Discord
  3. Confirms: "Now showing Bohemian Rhapsody on Discord"

Show as watching

text

User: "Show as watching instead"
Agent:
  1. set_presence(type="watching")
  2. Confirms: "Now showing as Watching"

Override song title

text

User: "Show my music but call it 'Custom Title'"
Agent:
  1. set_presence(type="listening", title="Custom Title")
  2. Confirms: "Now showing as Listening to Custom Title"

Hide Discord status

text

User: "Hide my Discord status"
Agent:
  1. clear_presence()
  2. Confirms: "Discord presence hidden"

Auto-show music

text

User: "Auto-show my music when it plays"
Agent:
  1. set_auto_show(true)
  2. Confirms: "Auto-show enabled. Media will appear on Discord automatically."

Check status

text

User: "What's my Discord status?"
Agent:
  1. get_status() → returns connection, presence, media state
  2. Reports connection and what's showing

Setup Requirements

1. GoodRP installed — Download from https://github.com/isam-ahmed0/GoodRP/releases
2. Discord Application ID — Create at https://discord.com/developers/applications
3. GoodRP running — Either:
   • GUI mode with auto-show enabled, OR
   • Headless mode with --mcp flag (or --mcp --api for HTTP access)

Platform Setup

GoodRP ships with a bundled MCP skill. Install it from: https://github.com/isam-ahmed0/GoodRP/tree/main/skills/goodrp

Claude Code

bash

claude mcp add-json goodrp '{"command":"C:\\path\\to\\GoodRP.exe","args":["--mcp"]}'

Or manually add to ~/.claude.json:

json

{
  "mcpServers": {
    "goodrp": {
      "command": "C:\\path\\to\\GoodRP.exe",
      "args": ["--mcp"]
    }
  }
}

Nanobot

Add to ~/.nanobot/config.json:

json

{
  "mcpServers": {
    "goodrp": {
      "command": "C:\\path\\to\\GoodRP.exe",
      "args": ["--mcp"]
    }
  }
}

Antigravity

Add to ~/.gemini/config/mcp_config.json:

json

{
  "mcpServers": {
    "goodrp": {
      "command": "C:\\path\\to\\GoodRP.exe",
      "args": ["--mcp"]
    }
  }
}

Hermes

bash

hermes mcp add goodrp --command "C:\\path\\to\\GoodRP.exe" --args "--mcp"

Or add to ~/.hermes/config.yaml:

yaml

mcp_servers:
  goodrp:
    command: "C:\\path\\to\\GoodRP.exe"
    args: ["--mcp"]

OpenClaw

Add to OpenClaw's MCP servers config:

json

{
  "mcpServers": {
    "goodrp": {
      "command": "C:\\path\\to\\GoodRP.exe",
      "args": ["--mcp"]
    }
  }
}

HTTP API (Alternative)

For HTTP API access, start GoodRP with both flags:

bash

GoodRP.exe --mcp --api

The API will be available at http://127.0.0.1:9876.