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

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?

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?

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

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

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

Override song title

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

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

Auto-show music

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

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

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

Or manually add to ~/.claude.json:

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

Nanobot

Add to ~/.nanobot/config.json:

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

Antigravity

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

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

Hermes

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

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

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

OpenClaw

Add to OpenClaw's MCP servers config:

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

HTTP API (Alternative)

For HTTP API access, start GoodRP with both flags:

GoodRP.exe --mcp --api

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