insights_breakdown_data
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_id
io.github.gumlet由 GitHub 账号 gumlet 发布v2.3.7更新于 Nov 4, 2026
Manage Gumlet video, live streams, analytics, and workspaces from an MCP client.
通过 MCP 客户端使用 Gumlet API 密钥管理 Gumlet 的视频资产、播放列表、配置、Webhook 与观看数据分析。
Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。
把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。
阅读 https://sourceweft.com/mcp/io.github.gumlet%2Fmcp/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。把它添加到你客户端的 mcpServers 配置中。
{
"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.
无需输入参数。
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.
language必填An 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 个This 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 个This endpoint retrieves the details of an asset that has previously been created.
asset_id必填This endpoint removes an asset given its unique asset id. The asset will be removed from storage as well, associated URLs will be inaccessible.
asset_id必填This 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_id必填frame_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_ID必填Upload `.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_ID必填language_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_ID必填upload_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_ID必填language_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_ID必填upload_responsesThis endpoint will create/update video asset chapters.
asset_id必填chaptersThis 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_at必填start_at必填page_sizecollection_idUse this endpoint to retrieve a pre-signed upload URL for the given part number.
asset_id必填part_number必填Once you upload all parts to S3 bucket via pre-signed URL, use this endpoint to complete the multipart upload.
partsasset_id必填This 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 个This endpoint retrieves the details of a video profile that has previously been created.
profile_id必填Update an existing profile. Settings provided in body parameters will only be updated in the existing profile.
vcpadcropnametrimwidthformatheightaudio_onlyenable_drmmp4_accessprofile_id另有 11 个This 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_id必填Get all playlists for given workspace
collection_id必填Create new playlist inside video wprkspace
titledescriptioncollection_idThis operation adds a single asset or a list of assets to a playlist.
asset_listplaylist_id必填Removed an asset or list of assets from a given playlist.
delete_listplaylist_id必填This endpoint allows you to update playlist name, channel visibility, or playlist order on a channel page.
titlepositiondescriptionplaylist_id必填player_configchannel_visibilityDeletes a playlist by plalist ID.
playlist_id必填Get a list of all assets inside playlist. You can choose in which order are assets returned.
sort_bypage_sizesort_orderpage_numberplaylist_id必填Reorder videos inside a playlist either by moving a single asset to a position or by sorting the playlist by title or created date.
bodyplaylist_id必填List all webhooks.
无需输入参数。
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_id必填secret_tokenDelete webhook listener endpoint.
webhook_id必填This endpoint list image sources which are assigned to the user or token.
sizeoffsetThis endpoint allows users to create image source.
awsgcstypeazureproxylinodewasabibackblazedostoragenamespacewebfoldercloudflare另有 1 个Get all details about image source.
image_source_id必填Update settings on an image source that already exists. This does not create a source or purge cached images.
awsgcstypeazurecnameproxylinodewasabibackblazedostorageis_activewebfolder另有 12 个This endpoint removes a image source. All image delivery using this subdomain will be stopped.
image_source_id必填You can purge cache for any image by using our cache purge API.
pathssubdomain必填This 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_id必填This 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_id必填This 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_id必填This endpoint lists live assets on the basis of `status` for the given `live_source_id`.
sizeoffsetstatuslive_source_id必填Recovers a deleted asset from the recycle bin.
asset_idStart a live stream.
live_asset_id必填Generate 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 个This endpoint get all the data of video workspace that has previously been created.
workspace_id必填This endpoint allows users to update video workspace that has previously been created.
awsgcsnametypezoomazureproxylinodewasabibackblazedostoragewebfolder另有 9 个This 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_id必填List folders for a video workspace. Use `parent_id` to list only folders inside a specific parent folder.
parent_idworkspace_id必填Create a folder inside a video workspace. Optionally provide `parent_id` to create a nested folder.
nameparent_idworkspace_id必填Get a single folder by id.
folder_id必填workspace_id必填Rename a folder, move it to another parent folder, or move assets into the folder by sending `asset_ids`.
nameasset_idsfolder_id必填parent_idworkspace_id必填Delete a folder. Descendant folders and assets inside them are deleted by the backend workflow.
folder_id必填workspace_id必填Remove one or more assets from their current folder assignment inside the workspace.
asset_idsworkspace_id必填List 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 个Invite one or more viewers to a members-only channel.
users必填video_workspace_id必填Remove one or more viewers from a channel by email address.
emails必填video_workspace_id必填Invite viewers to a channel by uploading a CSV file.
viewers_csv必填video_workspace_id必填This endpoint retrieves the history of a live video asset that has previously been created.
live_asset_id必填This 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_id必填You can get organization data using this API.
无需输入参数。
This endpoint gives information about the user account.
无需输入参数。
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_id必填Delete 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_id必填group_bypage_sizedate_rangepage_numberList all channel subscribers.
page_sizepage_numberworkspace_id必填Get logs history for a given webhook.
webhook_id必填Liost all invoices that are generated so far.
无需输入参数。
Get billing details for this organization.
无需输入参数。
Update billing details
citypostalgst_numberstate_codeaddress_linecompany_namecountry_codeGet details about upcoming invoice.
无需输入参数。
List all live stream workspaces.
无需输入参数。
Create live stream workspace.
nameUpdate live stream workspace.
namevideo_source_idlive_workspace_id必填Delete the live stream workspace.
live_workspace_id必填Get usage analytics for your live streams.
metricsgroup_bydate_rangeSearch all video assets / playlists / folders etc across workspaces.
sizesearch_query必填assets_offsetcollection_idfolders_offsetchannels_offsetplaylists_offsetThis call aborts multi-part upload and deletes the already uploaded parts from the storage.
bodyasset_id必填Lists all parts uploaded so far.
bodyasset_id必填已满足适用检查项的 83%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
请声明包含 README 的 GitHub 仓库,或在 OAuth 受保护资源元数据中提供 resource_documentation。
托管服务按其提供方的条款使用,因此这里不要求许可证。此检查项不计入百分比。