# Tuisic MCP server

> Lets an AI client search, play, and manage online music streaming from a terminal TUI via MCP.

- Repository: https://github.com/Dark-Kernel/tuisic
- Page: https://hostedmcp.org/servers/dark-kernel/tuisic
- Transport: —
- Stars: 76
- License: GPL-3.0

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `BREW_PREFIX` | no | no |  |
| `CMAKE_PREFIX_PATH` | no | no |  |
| `HOMEBREW_PREFIX` | no | no |  |
| `PKG_CONFIG_PATH` | no | no |  |

## FAQ

### How do I configure the Tuisic MCP server in my AI client?

Run the tuisic binary with the --mcp-server flag and add it as a local command in your client config.

### Which music sources can Tuisic search?

Tuisic fetches songs from JioSaavn, SoundCloud, LastFM, ForestFM, and YouTube, with YouTube Music planned.

### Does Tuisic support playing local music files?

Yes, selecting Local Music scans the configured local_music.path recursively and plays files through mpv.

### How do I install Tuisic on Arch Linux?

Install the tuisic-git package from the AUR with yay, or build from source with the listed dependencies.

### What keyboard shortcuts does Tuisic have?

It uses vim-style motions: q quits, w toggles daemon mode, space plays or pauses, and > and < skip tracks.
