
Riverside MCP
Unofficial MCP server and CLI for exporting and searching your own Riverside recordings
- Pricing
- Open source
- Platforms
- macOS, Windows, Linux
- Runs
- Locally
- Version
- 0.1.9
- Listing updated
- today
Similar MCP servers
About Riverside MCP
Riverside MCP is an open-source MCP server for content publishing. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a 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.mcpbAdd to claude_desktop_config.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>"
}
}
}
}Add to ~/.cursor/mcp.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>"
}
}
}
}Add to .vscode/mcp.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>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.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>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"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>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
RIVERSIDE_FM_BASE_URLBase URL for the Riverside API. Optional; defaults to https://riverside.com.RIVERSIDE_FM_NO_CONFIG_WRITESet to 1 to keep credentials off disk. The rotated session cookie is kept in memory for the run and never written back to config.toml; an existing config file is read but not updated. Leave blank for the default cached behaviour.RIVERSIDE_FM_MCP_READ_ONLYSet to exactly 1 to hide compute_per_speaker_talktime_stats and every tool that writes the local learning store (teach, teach-pattern, teach-lookup, teach-playbook, playbook amend, learnings confirm, learnings forget and learnings reject). No tool changes anything in your Riverside account either way. Any other value, including true or yes, leaves every tool enabled. Leave blank for the full tool set.RIVERSIDE_FM_NO_LOCAL_DATAOptional. Set to exactly 1 to keep no local copy of Riverside data: reads go to the API, the response cache is off, and nothing new is written to the local store. Leave blank to keep the local copy.RIVERSIDE_FM_MCP_HTTP_TOKENRequired only when running the MCP server with --transport http. Callers must send a matching Authorization: Bearer header. Not needed for the default local stdio transport that Claude Desktop uses.RIVERSIDE_FM_SKIP_TLS_VERIFYOptional. Set to 1 only to reach a test server with a self-signed certificate. Leave blank to verify certificates.RIVERSIDE_FM_USER_AGENTOverrides the User-Agent the CLI sends. Leave blank to use the built-in one.PRINTING_PRESS_CLIENT_PROFILEHas no effect for this connector unless you saved a client profile. Leave blank.
What it does
- 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
Pricing
Open source
Free and Apache-2.0 licensed; you pay only for your AI agent provider.
Riverside MCP 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.