MCP server for controlling Roam FM radio app via AI assistants like Claude
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"roam-fm-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Roam FM MCP Server MCP (Model Context Protocol) server for controlling [Roam FM](https://fm.houjoe.me) radio app via AI assistants like Claude. ## Prerequisites - macOS - Roam FM app installed and running - MCP remote control enabled in Roam FM: Settings > Labs > AI Remote Control - Python 3.10+ ## Installation ```bash cd mcp-server pip install -e . ``` ## Configuration ### Claude Code Add to your Claude Code MCP settings (`~/.claude/claude_desktop_config.json`): ```json { "mcpServers": { "roam-fm": { "command": "roam-fm-mcp" } } } ``` Or if using a virtual environment: ```json { "mcpServers": { "roam-fm": { "command": "/path/to/venv/bin/roam-fm-mcp" } } } ``` ## Available Tools | Tool | Description | |------|-------------| | `roam_play` | Start playing radio. Optionally filter by country code. | | `roam_pause` | Pause the current station. | | `roam_resume` | Resume playback. | | `roam_next` | Skip to next random station. | | `roam_stop` | Stop playback completely. | | `roam_status` | Get current playback status and station info. | | `roam_get_stats` | Get listening statistics. | ### Country Codes Use ISO 3166-1 alpha-2 country codes for filtering: - `JP` - Japan - `US` - United States - `FR` - France - `DE` - Germany - `GB` - United Kingdom - `CN` - China - etc. ## Example Usage Ask your AI assistant: - "Play Japanese radio stations" - "Pause the radio" - "What's currently playing?" - "Skip to the next station" - "How long have I been listening?" ## How It Works ``` AI Assistant ──MCP──> roam-fm-mcp ──URL Scheme──> Roam FM App <──status.json── ``` 1. AI sends commands via MCP protocol 2. MCP server triggers URL Scheme (`roam-fm://play`, etc.) 3. Roam FM app executes the command 4. App writes status to `~/.roam-fm/status.json` 5. MCP server reads status and returns result ## Troubleshooting ### "Status file not found" Make sure MCP remote control is enabled in Roam FM: …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.