io.github.gumletPublished by GitHub account gumletv2.3.7Updated Nov 4, 2026
Manage Gumlet video, live streams, analytics, and workspaces from an MCP client.
Manage Gumlet video assets, playlists, profiles, webhooks and viewer analytics from an MCP client using your Gumlet API key.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.gumlet%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"gumlet": {
"type": "http",
"url": "https://mcp.gumlet.com/mcp/v1",
"headers": {
"GUMLET_API_KEY": "<YOUR_API_KEY>"
}
}
}
}Read viewer metrics for one workspace, grouped by a breakdown field, for a date range of at most 60 days. This does not change assets or delivery.
filtersbreakdownsdate_rangeworkspace_idThis endpoint retrieves aggregated data of the given metrics.
filtersaggregatetimeframeworkspace_idList official Gumlet client SDKs so agents can discover them. Python: pip install gumlet (https://pypi.org/project/gumlet/). Node.js: npm install @gumlet/nodejs-sdk (https://www.npmjs.com/package/@gumlet/nodejs-sdk). Use this when the user wants to integrate Gumlet in application code. Do not use this to call the live Gumlet API; use the API tools instead.
Takes no parameters.
Get install commands and a usage snippet for an official Gumlet SDK. language=python returns pip install gumlet (https://pypi.org/project/gumlet/). language=nodejs returns npm install @gumlet/nodejs-sdk (https://www.npmjs.com/package/@gumlet/nodejs-sdk). Aliases: py, node, js, ts, javascript, typescript, npm, pypi.
languagerequiredAn asset refers to media content/video that is processed, stored, and delivered through Gumlet. This endpoint creates an asset allowing users to ingest media content into the Gumlet system for processing and delivery.
padtagcroptriminputtitlewidthfolderformatheightmetadataaudio_only+15 moreThis endpoint creates a video asset allowing upload of a video from the local file system and ingest media content into the Gumlet system for processing and delivery. Body parameters are the same as the Create Asset body parameters except for the `input` parameter, which this endpoint does not take. A successful response will be returned with `upload_url` field. You can make `PUT` request to that URL to upload video. To upload video using `upload_url` refer to [this](https://docs.gumlet.com/docs/direct-upload#2-use-the-url-to-upload-a-file).
padtagcroptrimtitlewidthfolderformatheightmetadataaudio_onlyenable_drm+14 moreThis endpoint retrieves the details of an asset that has previously been created.
asset_idrequiredThis endpoint removes an asset given its unique asset id. The asset will be removed from storage as well, associated URLs will be inaccessible.
asset_idrequiredThis endpoint allows users to update video asset that has previously been created.
taginputtitleasset_idmetadatareprocessdescriptioncall_to_actionsremove_subtitlesSelect frame from video to use as thumbnail.
asset_idrequiredframe_at_secondUse any image file to use as thumbnail. Once you use the API, you will get `upload_url` in the response, and that can be used to upload the image file. Here is the sample curl request. ```bash curl --location --request PUT '<upload_url>' \ --data '<YOUR_FILE_PATH>' ```
asset_IDrequiredUpload `.srt` or `.vtt` file to the video asset. The response of this API call gives `upload_url` for each language specified. You need to send a `PUT` request of the subtitle files to those URLs. Once that's done, you need to call the subtitle upload complete API. Only after that, Gumlet will add subtitles to asset.
asset_IDrequiredlanguage_codesThis API must be called after adding subtitles; the add subtitle call gives you URLs to upload, and you complete a `PUT` request to those URLs. Once that is done, calling this initiates the process to actually add the subtitle to the video.
asset_IDrequiredupload_responsesAdd any audio file to the video asset. The response of this API call gives `upload_url` for each language specified. You need to send a `PUT` request of the audio files to those URLs. Once that's done, you need to call the audio upload complete API. Only after that will Gumlet add audio to the asset.
asset_IDrequiredlanguage_codesFinish adding audio tracks to an existing video asset. Call this only after the audio files have been PUT to the upload URLs from the add-audio call. This attaches those tracks to the asset.
asset_IDrequiredupload_responsesThis endpoint will create/update video asset chapters.
asset_idrequiredchaptersThis endpoint gives usage analytics data of your videos. Ex - top assets, bandwidth consumption
filtersmetricsgroup_bydate_rangetop_assets_pagetop_assets_countThis endpoint lists top streamed assets in a video collection
pageend_atrequiredstart_atrequiredpage_sizecollection_idUse this endpoint to retrieve a pre-signed upload URL for the given part number.
asset_idrequiredpart_numberrequiredOnce you upload all parts to S3 bucket via pre-signed URL, use this endpoint to complete the multipart upload.
partsasset_idrequiredThis endpoint retrieves the details of all profiles that have previously been created.
sizeoffsetGumlet provides the functionality of creating multiple video assets using the same set of parameters. A Video profile is a set of parameters that can be referenced/used while creating a video as a single parameter.
padcropnametrimwidthformatheightaudio_onlyenable_drmmp4_accessresolutiontranscribe+6 moreThis endpoint retrieves the details of a video profile that has previously been created.
profile_idrequiredUpdate an existing profile. Settings provided in body parameters will only be updated in the existing profile.
vcpadcropnametrimwidthformatheightaudio_onlyenable_drmmp4_accessprofile_id+11 moreThis endpoint removes a profile given its unique `profile_id`. The profile will be removed but video assets created using the profile will remain as it is.
profile_idrequiredGet all playlists for given workspace
collection_idrequiredCreate new playlist inside video wprkspace
titledescriptioncollection_idThis operation adds a single asset or a list of assets to a playlist.
asset_listplaylist_idrequiredRemoved an asset or list of assets from a given playlist.
delete_listplaylist_idrequiredThis endpoint allows you to update playlist name, channel visibility, or playlist order on a channel page.
titlepositiondescriptionplaylist_idrequiredplayer_configchannel_visibilityDeletes a playlist by plalist ID.
playlist_idrequiredGet a list of all assets inside playlist. You can choose in which order are assets returned.
sort_bypage_sizesort_orderpage_numberplaylist_idrequiredReorder videos inside a playlist either by moving a single asset to a position or by sorting the playlist by title or created date.
bodyplaylist_idrequiredList all webhooks.
Takes no parameters.
Creates a new webhook listener. Gumlet POSTs JSON to `url` for each matching event and sends `secret_token` in the `x-gumlet-token` header. Payload schemas are documented in the webhooks section.
urlsourcestriggerssecret_tokenUpdate a webhook listener.
urlsourcestriggerswebhook_idrequiredsecret_tokenDelete webhook listener endpoint.
webhook_idrequiredThis endpoint list image sources which are assigned to the user or token.
sizeoffsetThis endpoint allows users to create image source.
awsgcstypeazureproxylinodewasabibackblazedostoragenamespacewebfoldercloudflare+1 moreGet all details about image source.
image_source_idrequiredUpdate settings on an image source that already exists. This does not create a source or purge cached images.
awsgcstypeazurecnameproxylinodewasabibackblazedostorageis_activewebfolder+12 moreThis endpoint removes a image source. All image delivery using this subdomain will be stopped.
image_source_idrequiredYou can purge cache for any image by using our cache purge API.
pathssubdomainrequiredThis endpoint helps you get image analytics data like bandwidth consumption, request count, CDN hit ratio, etc.
filtersmetricsgroup_bydate_rangeA live asset refers to media content/video that is live-streamed through Gumlet. This endpoint creates a live streaming asset allowing users to live stream a video that will be pushed to Gumlet.
titlestart_atmp4_accessresolutionorientationlive_source_idA live asset refers to media content/video that is live-streamed through Gumlet. This endpoint allows users to update a live streaming asset.
titlestart_atlive_asset_idThis endpoint retrieves the details of a live video asset that has previously been created.
live_asset_idrequiredThis endpoint removes a live asset given its unique live asset id. The live asset will be removed from storage as well, associated URLs will be inaccessible.
live_asset_idrequiredThis endpoint allows marking live assets complete. Once the live asset is marked complete, it can no longer be used to ingest the live stream on Gumlet.
live_asset_idrequiredThis endpoint lists live assets on the basis of `status` for the given `live_source_id`.
sizeoffsetstatuslive_source_idrequiredRecovers a deleted asset from the recycle bin.
asset_idStart a live stream.
live_asset_idrequiredGenerate presigned upload URLs for live stream thumbnails. Supported thumbnail states are `preparing`, `disconnected`, and `end`.
statuseslive_asset_idThis endpoint list video workspace which are assigned to the user or token.
sizeoffsetVideo workspaces are top-level entities in Gumlet. You can use them to organize videos for different teams/departments or use cases.
awsgcsnametypezoomazureproxylinodewasabibackblazedostoragecloudflare+5 moreThis endpoint get all the data of video workspace that has previously been created.
workspace_idrequiredThis endpoint allows users to update video workspace that has previously been created.
awsgcsnametypezoomazureproxylinodewasabibackblazedostoragewebfolder+9 moreThis endpoint removes a video workspace given its unique asset id. All the asset in workspace will be removed from storage as well, associated URLs will be inaccessible.
workspace_idrequiredList folders for a video workspace. Use `parent_id` to list only folders inside a specific parent folder.
parent_idworkspace_idrequiredCreate a folder inside a video workspace. Optionally provide `parent_id` to create a nested folder.
nameparent_idworkspace_idrequiredGet a single folder by id.
folder_idrequiredworkspace_idrequiredRename a folder, move it to another parent folder, or move assets into the folder by sending `asset_ids`.
nameasset_idsfolder_idrequiredparent_idworkspace_idrequiredDelete a folder. Descendant folders and assets inside them are deleted by the backend workflow.
folder_idrequiredworkspace_idrequiredRemove one or more assets from their current folder assignment inside the workspace.
asset_idsworkspace_idrequiredList folders and assets for a workspace in a single response. Use `parent_id` to browse a specific folder, or filters like `title`, `status`, and `playlist_id` to search assets.
tagsizetypetitleoffsetsortBystatusorderByend_dateparent_idstart_dateplaylist_id+5 moreInvite one or more viewers to a members-only channel.
usersrequiredvideo_workspace_idrequiredRemove one or more viewers from a channel by email address.
emailsrequiredvideo_workspace_idrequiredInvite viewers to a channel by uploading a CSV file.
viewers_csvrequiredvideo_workspace_idrequiredThis endpoint retrieves the history of a live video asset that has previously been created.
live_asset_idrequiredThis endpoint retrieves viewer analytics data. This endpoint is use for deep insights on the analytics data.
filtersmetricsdownloadgroup_bydate_rangeworkspace_idchart_dimensionRead viewer metrics for one workspace, grouped by a breakdown field, for a date range of at most 60 days. This does not change assets or delivery.
filtersbreakdownsdate_rangeworkspace_idThis endpoint retrieves aggregated data of the given metrics.
filtersaggregatetimeframeworkspace_idYou can purge the cache for any image path by using this cache purge API.
pathssource_idrequiredYou can get organization data using this API.
Takes no parameters.
This endpoint gives information about the user account.
Takes no parameters.
Get audit logs for the user activity in your organisation. Please note that this endpoint can only be accessed by `owner` and `admin` role users.
page_sizedate_rangeuser_emailpage_numberactivity_typeList all assets in a recycle bin for a given workspace. The deleted assets are available for 30 days. After that, assets are permanently deleted.
sizeoffsetworkspace_idrequiredDelete multiple VOD assets at once.
source_idasset_listAdd / remove tags from multiple assets at once.
add_tagssource_idasset_listremove_tagsGet video analytics for a single asset.
metricsasset_idrequiredgroup_bypage_sizedate_rangepage_numberList all channel subscribers.
page_sizepage_numberworkspace_idrequiredGet logs history for a given webhook.
webhook_idrequiredLiost all invoices that are generated so far.
Takes no parameters.
Get billing details for this organization.
Takes no parameters.
Update billing details
citypostalgst_numberstate_codeaddress_linecompany_namecountry_codeGet details about upcoming invoice.
Takes no parameters.
List all live stream workspaces.
Takes no parameters.
Create live stream workspace.
nameUpdate live stream workspace.
namevideo_source_idlive_workspace_idrequiredDelete the live stream workspace.
live_workspace_idrequiredGet usage analytics for your live streams.
metricsgroup_bydate_rangeSearch all video assets / playlists / folders etc across workspaces.
sizesearch_queryrequiredassets_offsetcollection_idfolders_offsetchannels_offsetplaylists_offsetThis call aborts multi-part upload and deletes the already uploaded parts from the storage.
bodyasset_idrequiredLists all parts uploaded so far.
bodyasset_idrequired83% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.
A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.