Riverside MCP tools

MCP tool riverside_list_studios

Returns every studio in your account, the ones you own and the ones you were added to. Use studio_id from each item in the other calls. Recording type is audio and video or audio only, as set in the studio.

Parameters

No parameters.

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "riverside_list_studios",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "studios": [
      {
        "studio_id": "std_8f2k41",
        "name": "The Product Hour",
        "recording_type": "audio_video",
        "studio_url": "https://riverside.com/studio/the-product-hour"
      },
      {
        "studio_id": "std_2m9c07",
        "name": "Founders Q&A",
        "recording_type": "audio_only",
        "studio_url": "https://riverside.com/studio/founders-qa"
      }
    ]
  },
  "isError": false
}

MCP tool riverside_list_sessions

Lists scheduled sessions in start order, soonest first. Each item has the invited guests, producers and audience members with their roles. Pass session_id to update_session, invite_guest or cancel_session.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "riverside_list_sessions",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "sessions": [
      {
        "session_id": "ses_3vq9x7",
        "studio_id": "std_8f2k41",
        "name": "Episode 42: Pricing your first product",
        "start": "2026-10-15T15:00:00+01:00",
        "end": "2026-10-15T16:00:00+01:00",
        "invited": [
          {
            "email": "guest@example.com",
            "role": "guest"
          }
        ]
      }
    ],
    "next_cursor": null
  },
  "isError": false
}

MCP tool riverside_get_invite_links

Returns the studio link for each role. Guest and producer links let people join the studio; the audience link works only while audience public access is turned on in the studio. A link you share yourself does not expire, unlike the link in an invite email.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "riverside_get_invite_links",
    "arguments": {
      "studio_id": "studio_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "studio_id": "std_8f2k41",
    "links": {
      "guest": "https://riverside.com/studio/the-product-hour?t=guest-token",
      "producer": "https://riverside.com/studio/the-product-hour?t=producer-token",
      "audience": null
    }
  },
  "isError": false
}

MCP tool riverside_list_recordings

Lists recordings across your studios, newest first. Filter by studio or by date to find the latest episode. Upload status shows whether each participant's files are fully uploaded. Pass recording_id to get_recording, get_transcript and download_tracks.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "riverside_list_recordings",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "recordings": [
      {
        "recording_id": "rec_71d3ab",
        "studio_id": "std_8f2k41",
        "title": "Episode 41: Launch week",
        "recorded_at": "2026-10-08T15:02:00+01:00",
        "duration_seconds": 3412,
        "participants": [
          "Host",
          "Guest"
        ],
        "upload_status": "complete"
      }
    ],
    "next_cursor": "eyJvZmZzZXQiOjIwfQ"
  },
  "isError": false
}

MCP tool riverside_get_recording

Returns one recording and the tracks of each participant. Each track has a type (audio or video, and screen share when one was recorded) and an upload status. Read it before download_tracks to see whether every track has finished uploading.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "riverside_get_recording",
    "arguments": {
      "recording_id": "recording_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "recording_id": "rec_71d3ab",
    "title": "Episode 41: Launch week",
    "duration_seconds": 3412,
    "participants": [
      {
        "name": "Host",
        "tracks": [
          {
            "type": "audio",
            "upload_status": "complete"
          },
          {
            "type": "video",
            "upload_status": "complete"
          }
        ]
      },
      {
        "name": "Guest",
        "tracks": [
          {
            "type": "audio",
            "upload_status": "complete"
          },
          {
            "type": "video",
            "upload_status": "uploading"
          }
        ]
      }
    ]
  },
  "isError": false
}

MCP tool riverside_get_transcript

Returns the transcript Riverside made for one recording, in speaker order with timestamps. Use format srt for subtitle files and txt for plain reading. The call fails if the recording has no transcript yet.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "riverside_get_transcript",
    "arguments": {
      "recording_id": "recording_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "recording_id": "rec_71d3ab",
    "format": "txt",
    "text": "[00:00:04] Host: Welcome back to The Product Hour.\n[00:00:09] Guest: Thanks for having me."
  },
  "isError": false
}

MCP tool riverside_download_tracks

Returns one download link per participant for the file type you choose: raw video, aligned video, raw audio or compressed audio, the options in the Riverside Download menu. Tracks that are still uploading are listed without a link. Screen share tracks in high quality exist only when the screen share was recorded with the Mac app. Edited tracks are not included; they come from an edit export.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "riverside_download_tracks",
    "arguments": {
      "recording_id": "rec_71d3ab",
      "file_type": "raw_audio"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "recording_id": "rec_71d3ab",
    "file_type": "raw_audio",
    "files": [
      {
        "participant": "Host",
        "url": "https://downloads.example.com/rec_71d3ab/host.wav",
        "status": "ready"
      },
      {
        "participant": "Guest",
        "url": "https://downloads.example.com/rec_71d3ab/guest.wav",
        "status": "ready"
      }
    ]
  },
  "isError": false
}

MCP tool riverside_create_studio

Creates a studio with the name and recording type you give. Studios count against the limit of your Riverside plan, so a new one can use up a slot. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "riverside_create_studio",
    "arguments": {
      "name": "Jane Doe"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "studio_id": "std_5t8n22",
    "name": "Interview Series",
    "recording_type": "audio_video",
    "studio_url": "https://riverside.com/studio/interview-series"
  },
  "isError": false
}

MCP tool riverside_schedule_session

Adds a session at the start and end time you give, in the time zone you set. Each guest in guest_emails gets an invite email with the session details and the studio link; the emailed link works until 24 hours after the start. Only the host, account owner, admins, directors and editors can schedule. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "riverside_schedule_session",
    "arguments": {
      "studio_id": "std_8f2k41",
      "name": "Episode 42: Pricing your first product",
      "start": "2026-10-15T15:00:00+01:00",
      "end": "2026-10-15T16:00:00+01:00",
      "guest_emails": [
        "guest@example.com"
      ]
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "session_id": "ses_3vq9x7",
    "studio_id": "std_8f2k41",
    "status": "scheduled",
    "start": "2026-10-15T15:00:00+01:00",
    "invited": [
      {
        "email": "guest@example.com",
        "role": "guest",
        "email_sent": true
      }
    ]
  },
  "isError": false
}

MCP tool riverside_update_session

Changes the fields you pass and leaves the rest. When the date or time changes, Riverside emails the guests, producer and audience members that the session was updated, and the Google Calendar invite updates automatically. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "riverside_update_session",
    "arguments": {
      "session_id": "ses_3vq9x7",
      "start": "2026-10-16T11:00:00+01:00",
      "end": "2026-10-16T12:00:00+01:00"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "session_id": "ses_3vq9x7",
    "status": "updated",
    "start": "2026-10-16T11:00:00+01:00",
    "end": "2026-10-16T12:00:00+01:00",
    "notified": [
      "guest@example.com"
    ]
  },
  "isError": false
}

MCP tool riverside_invite_guest

Adds one person to a scheduled session and sends them an invite email with the session details and the studio link. Role is guest by default. Inviting the same email again resends the invite. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "riverside_invite_guest",
    "arguments": {
      "session_id": "session_8c41d2",
      "email": "jane@example.com"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "session_id": "ses_3vq9x7",
    "email": "producer@example.com",
    "role": "producer",
    "email_sent": true
  },
  "isError": false
}

MCP tool riverside_cancel_session

Cancels the session and removes it from the Planner and the project folder. Recordings that were already made stay in your account. Cancelling cannot be undone with one call; schedule the session again to restore it. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "riverside_cancel_session",
    "arguments": {
      "session_id": "session_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "session_id": "ses_3vq9x7",
    "status": "cancelled"
  },
  "isError": false
}