# Riverside MCP

> Riverside MCP is an open-source MCP server for content publishing. Unofficial MCP server and CLI for exporting and searching your own Riverside recordings. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Windows, Linux, CLI, self-hosted
- **Repository:** https://github.com/servosity/msp-skills/tree/HEAD/skills/riverside-fm
- **MCP Registry name:** io.github.Servosity/riverside-fm-mcp
- **Categories:** [content publishing](https://ai-powered.com/categories/content-publishing)
- **Listing updated:** 2026-11-18

## About

The README says this is an unofficial, community-built MCP server and CLI for the Riverside API, not affiliated with RiversideFM. It exposes Riverside's API surface as tools that AI clients can call, and it is aimed at podcasters and MSP owners who want to back up, search and reformat their own studio content.

A distinctive part of the design is a local SQLite mirror with full-text search. Data read from Riverside is stored on the user's machine, so aggregate questions such as searching transcripts across a long archive run as local queries rather than repeated live API calls. Compound commands join studios, projects, takes, transcripts and clip assets.

According to the README, it authenticates with the user's own browser session cookies, so it can be used on Pro, Live and Webinar accounts that cannot issue an official API key. The README states the read-oriented commands do not change anything in the Riverside account, and a read-only environment flag hides the few tools that write to the local store.

The server speaks stdio only. The README says ChatGPT on the web and Microsoft or Gemini hosted apps are not supported yet, and warns against placing it behind a stdio-to-HTTP bridge.

## Features

- **Bulk studio export:** Archives a whole studio or a date range to disk in a resumable way.
- **Transcript full-text search:** Searches across every transcript held in the local mirror.
- **Transcript format conversion:** Converts transcripts into WebVTT, SRT or Markdown caption files.
- **Speaker talktime stats:** Reports how much each speaker talked in a given session.
- **Clip and media link refresh:** Fetches Magic Clips for a project and refreshes expiring media download links.
- **Local data mirror:** Keeps a local SQLite copy of Riverside data that can be turned off with an environment setting.
- **Read-only mode:** An environment flag hides tools that write to the local store or compute stats.

## Good for

- Backing up a podcast archive before cancelling a Riverside plan
- Searching old episodes for a quote or customer story
- Generating SRT or WebVTT captions for a web player
- Reviewing which takes are ready to edit across a studio
- Pulling Magic Clips with fresh download URLs for a project

## Install

### Claude Code (Terminal)

```sh
claude mcp add riverside-fm-mcp --env RIVERSIDE_FM_MCP_HTTP_TOKEN='<RIVERSIDE_FM_MCP_HTTP_TOKEN>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/riverside-fm-v0.1.9/riverside-fm-mcp.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "riverside-fm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/riverside-fm-v0.1.9/riverside-fm-mcp.mcpb"
      ],
      "env": {
        "RIVERSIDE_FM_MCP_HTTP_TOKEN": "<RIVERSIDE_FM_MCP_HTTP_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "riverside-fm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/riverside-fm-v0.1.9/riverside-fm-mcp.mcpb"
      ],
      "env": {
        "RIVERSIDE_FM_MCP_HTTP_TOKEN": "<RIVERSIDE_FM_MCP_HTTP_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "riverside-fm-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/riverside-fm-v0.1.9/riverside-fm-mcp.mcpb"
      ],
      "env": {
        "RIVERSIDE_FM_MCP_HTTP_TOKEN": "<RIVERSIDE_FM_MCP_HTTP_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "riverside-fm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/riverside-fm-v0.1.9/riverside-fm-mcp.mcpb"
      ],
      "env": {
        "RIVERSIDE_FM_MCP_HTTP_TOKEN": "<RIVERSIDE_FM_MCP_HTTP_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "riverside-fm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/riverside-fm-v0.1.9/riverside-fm-mcp.mcpb"
      ],
      "env": {
        "RIVERSIDE_FM_MCP_HTTP_TOKEN": "<RIVERSIDE_FM_MCP_HTTP_TOKEN>"
      }
    }
  }
}
```

## FAQ

### Is this an official Riverside product?

No. The README says it is unofficial and community-built, and not affiliated with, endorsed by or sponsored by RiversideFM, Inc.

### Does it need a Riverside Business plan or API key?

The README says no. It reuses session cookies from a logged-in browser, so it is intended to work on Pro, Live and Webinar accounts.

### Does it change anything in my Riverside account?

The README says the commands read and download data and that no command writes to, deletes or publishes content in Riverside.

### Which AI clients can connect to it?

The README lists Claude Desktop, the ChatGPT desktop app, Codex, Claude Code, Claude Cowork and GitHub Copilot in VS Code, plus Gemini CLI. ChatGPT on the web is not supported.

### What does it cost and what license is it under?

The README says it is free and Apache-2.0 licensed. Users pay only for their AI agent provider.

### Is Riverside MCP free?

Yes. Riverside MCP is open source, so you can use and self-host it for free.

### How do I add Riverside MCP to Claude Code?

Run this command in your terminal: claude mcp add riverside-fm-mcp --env RIVERSIDE_FM_MCP_HTTP_TOKEN='<RIVERSIDE_FM_MCP_HTTP_TOKEN>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/riverside-fm-v0.1.9/riverside-fm-mcp.mcpb

### What are the best alternatives to Riverside MCP?

The closest alternatives to Riverside MCP are Riverside MCP Server and API by Cotlet, Caisy MCP by usefulapi and Drupal MCP by usefulapi.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Riverside MCP Server and API by Cotlet](https://ai-powered.com/mcp/riverside-mcp-server-and-api-by-cotlet): Riverside MCP Server and API by Cotlet is an MCP server for design and media.
- [Caisy MCP by usefulapi](https://ai-powered.com/mcp/caisy-mcp-by-usefulapi): Caisy MCP by usefulapi is a freemium MCP server for content publishing.
- [Drupal MCP by usefulapi](https://ai-powered.com/mcp/drupal-mcp-by-usefulapi): Drupal MCP by usefulapi is a freemium MCP server for content publishing.

---
Source: https://ai-powered.com/mcp/riverside-mcp
