Gumlet

io.github.gumlet由 GitHub 账号 gumlet 发布v2.3.7更新于 Nov 4, 2026

Manage Gumlet video, live streams, analytics, and workspaces from an MCP client.

已验证Streamable HTTP可网页运行开发者工具数据与分析媒体与设计

概览

AI 生成的概览

通过 MCP 客户端使用 Gumlet API 密钥管理 Gumlet 的视频资产、播放列表、配置、Webhook 与观看数据分析。

可以做什么
  • 创建、更新和删除视频资产,包括直传、缩略图、字幕、音轨与章节
  • 用播放列表、视频配置和图片来源整理内容
  • 读取观看与用量分析,包括分组数据、聚合指标和热门播放资产
  • 管理 Webhook 监听器,并查看组织的账单信息
  • 查询官方 Gumlet SDK 的安装命令与用法示例
适用场景
适合让助手直接操作已有的 Gumlet 媒体账号:导入和清理视频、整理播放列表、查看分发分析,或在对话中配置 Webhook,无需离开聊天界面。
运行要求
远程端点 mcp.gumlet.com,使用 streamable HTTP。需要 Gumlet API 密钥,通过 GUMLET_API_KEY 请求头(或 Authorization Bearer 令牌)传入,可在 Gumlet 后台 Developer、API keys 处创建。工作区相关工具还需工作区或集合 ID。
安装前请注意
该密钥具有账号写权限:工具可创建、更新和删除资产、播放列表、配置与 Webhook,删除资产会同时从存储中移除并使其链接失效。账单工具可读取和更新账单信息。上传及字幕、音频流程需要向预签名 URL 发起后续 PUT 请求。请妥善保管并限制 API 密钥权限。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Gumlet,将其添加到工作区。
  2. 连接 GUMLET_API_KEY 凭据。它们会被私密存储,绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.gumlet%2Fmcp/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "gumlet": {
      "type": "http",
      "url": "https://mcp.gumlet.com/mcp/v1",
      "headers": {
        "GUMLET_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

工具

94

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

insights_aggregated_data

This endpoint retrieves aggregated data of the given metrics.

输入参数filtersaggregatetimeframeworkspace_id

list_sdks

List 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_sdk

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必填

create_asset

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 个

create_asset_direct_upload

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 个

get_asset_details

This endpoint retrieves the details of an asset that has previously been created.

输入参数asset_id必填

delete_asset

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必填

update_asset

This endpoint allows users to update video asset that has previously been created.

输入参数taginputtitleasset_idmetadatareprocessdescriptioncall_to_actionsremove_subtitles

thumbnail_select

Select frame from video to use as thumbnail.

输入参数asset_id必填frame_at_second

thumbnail_upload

Use 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_subtitles

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_codes

complete_subtitle_upload

This 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_responses

asset_audio_upload

Add 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_codes

complete_audio_upload

Finish 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_responses

create_update_chapter

This endpoint will create/update video asset chapters.

输入参数asset_id必填chapters

retrieve_analytics

This endpoint gives usage analytics data of your videos. Ex - top assets, bandwidth consumption

输入参数filtersmetricsgroup_bydate_rangetop_assets_pagetop_assets_count

top_assets

This endpoint lists top streamed assets in a video collection

输入参数pageend_at必填start_at必填page_sizecollection_id

retrieve_part_url

Use this endpoint to retrieve a pre-signed upload URL for the given part number.

输入参数asset_id必填part_number必填

complete_multipart_upload

Once you upload all parts to S3 bucket via pre-signed URL, use this endpoint to complete the multipart upload.

输入参数partsasset_id必填

list_profiles

This endpoint retrieves the details of all profiles that have previously been created.

输入参数sizeoffset

create_profile

Gumlet 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 个

get_profile

This endpoint retrieves the details of a video profile that has previously been created.

输入参数profile_id必填

update_profile

Update an existing profile. Settings provided in body parameters will only be updated in the existing profile.

输入参数vcpadcropnametrimwidthformatheightaudio_onlyenable_drmmp4_accessprofile_id另有 11 个

delete_profile

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

Get all playlists for given workspace

输入参数collection_id必填

create_playlist

Create new playlist inside video wprkspace

输入参数titledescriptioncollection_id

add_asset_playlist

This operation adds a single asset or a list of assets to a playlist.

输入参数asset_listplaylist_id必填

remove_asset_playlist

Removed an asset or list of assets from a given playlist.

输入参数delete_listplaylist_id必填

update_playlist

This endpoint allows you to update playlist name, channel visibility, or playlist order on a channel page.

输入参数titlepositiondescriptionplaylist_id必填player_configchannel_visibility

delete_playlist

Deletes a playlist by plalist ID.

输入参数playlist_id必填

get_playlist_assets

Get a list of all assets inside playlist. You can choose in which order are assets returned.

输入参数sort_bypage_sizesort_orderpage_numberplaylist_id必填

reorder_asset_playlist

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_webhooks

List all webhooks.

无需输入参数。

create_webhook

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_token

update_webhook

Update a webhook listener.

输入参数urlsourcestriggerswebhook_id必填secret_token

delete_webhook

Delete webhook listener endpoint.

输入参数webhook_id必填

list_sources

This endpoint list image sources which are assigned to the user or token.

输入参数sizeoffset

create_image_source

This endpoint allows users to create image source.

输入参数awsgcstypeazureproxylinodewasabibackblazedostoragenamespacewebfoldercloudflare另有 1 个

get_image_sources_source_id

Get all details about image source.

输入参数image_source_id必填

update_image_source

Update settings on an image source that already exists. This does not create a source or purge cached images.

输入参数awsgcstypeazurecnameproxylinodewasabibackblazedostorageis_activewebfolder另有 12 个

delete_source

This endpoint removes a image source. All image delivery using this subdomain will be stopped.

输入参数image_source_id必填

purge_image_cache

You can purge cache for any image by using our cache purge API.

输入参数pathssubdomain必填

retrieve_image_analytics

This endpoint helps you get image analytics data like bandwidth consumption, request count, CDN hit ratio, etc.

输入参数filtersmetricsgroup_bydate_range

create_live_asset

A 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_id

update_live_asset

A 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_id

get_live_asset_status

This endpoint retrieves the details of a live video asset that has previously been created.

输入参数live_asset_id必填

delete_live_asset

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必填

complete_live_stream

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必填

filter_live_assets

This endpoint lists live assets on the basis of `status` for the given `live_source_id`.

输入参数sizeoffsetstatuslive_source_id必填

recover

Recovers a deleted asset from the recycle bin.

输入参数asset_id

start_live

Start a live stream.

输入参数live_asset_id必填

thumbnail_upload_live

Generate presigned upload URLs for live stream thumbnails. Supported thumbnail states are `preparing`, `disconnected`, and `end`.

输入参数statuseslive_asset_id

list_workspaces

This endpoint list video workspace which are assigned to the user or token.

输入参数sizeoffset

create_workspace

Video workspaces are top-level entities in Gumlet. You can use them to organize videos for different teams/departments or use cases.

输入参数awsgcsnametypezoomazureproxylinodewasabibackblazedostoragecloudflare另有 5 个

get_workspace

This endpoint get all the data of video workspace that has previously been created.

输入参数workspace_id必填

update_workspace

This endpoint allows users to update video workspace that has previously been created.

输入参数awsgcsnametypezoomazureproxylinodewasabibackblazedostoragewebfolder另有 9 个

delete_workspace

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

List folders for a video workspace. Use `parent_id` to list only folders inside a specific parent folder.

输入参数parent_idworkspace_id必填

create_folder

Create a folder inside a video workspace. Optionally provide `parent_id` to create a nested folder.

输入参数nameparent_idworkspace_id必填

get_folder

Get a single folder by id.

输入参数folder_id必填workspace_id必填

update_folder

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_folder

Delete a folder. Descendant folders and assets inside them are deleted by the backend workflow.

输入参数folder_id必填workspace_id必填

remove_assets_folder

Remove one or more assets from their current folder assignment inside the workspace.

输入参数asset_idsworkspace_id必填

list_assets

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_channel_viewers

Invite one or more viewers to a members-only channel.

输入参数users必填video_workspace_id必填

remove_channel_viewers

Remove one or more viewers from a channel by email address.

输入参数emails必填video_workspace_id必填

invite_channel_viewers_csv

Invite viewers to a channel by uploading a CSV file.

输入参数viewers_csv必填video_workspace_id必填

asset_status_history

This endpoint retrieves the history of a live video asset that has previously been created.

输入参数live_asset_id必填

viewer_analytics_data

This endpoint retrieves viewer analytics data. This endpoint is use for deep insights on the analytics data.

输入参数filtersmetricsdownloadgroup_bydate_rangeworkspace_idchart_dimension

analytics_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

analytics_aggregated_data

This endpoint retrieves aggregated data of the given metrics.

输入参数filtersaggregatetimeframeworkspace_id

image_purge

You can purge the cache for any image path by using this cache purge API.

输入参数pathssource_id必填

fetch_org

You can get organization data using this API.

无需输入参数。

fetch_user

This endpoint gives information about the user account.

无需输入参数。

fetch_audit_logs

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_type

list_recycle_bin

List 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必填

assets_delete_many

Delete multiple VOD assets at once.

输入参数source_idasset_list

assets_tag_many

Add / remove tags from multiple assets at once.

输入参数add_tagssource_idasset_listremove_tags

asset_analytics

Get video analytics for a single asset.

输入参数metricsasset_id必填group_bypage_sizedate_rangepage_number

list_channel_subscribers

List all channel subscribers.

输入参数page_sizepage_numberworkspace_id必填

webhook_history

Get logs history for a given webhook.

输入参数webhook_id必填

list_invoices

Liost all invoices that are generated so far.

无需输入参数。

fetch_billing_details

Get billing details for this organization.

无需输入参数。

update_billing_details

Update billing details

输入参数citypostalgst_numberstate_codeaddress_linecompany_namecountry_code

fetch_upcoming_invoice

Get details about upcoming invoice.

无需输入参数。

list_live_workspaces

List all live stream workspaces.

无需输入参数。

live_workspace_create

Create live stream workspace.

输入参数name

live_workspace_update

Update live stream workspace.

输入参数namevideo_source_idlive_workspace_id必填

live_workspace_delete

Delete the live stream workspace.

输入参数live_workspace_id必填

live_usage_analytics

Get usage analytics for your live streams.

输入参数metricsgroup_bydate_range

multipart_upload_abort

This call aborts multi-part upload and deletes the already uploaded parts from the storage.

输入参数bodyasset_id必填

multipart_upload_list

Lists all parts uploaded so far.

输入参数bodyasset_id必填

版本历史

1
  1. v2.3.7最新Nov 4, 2026

评分

已满足适用检查项的 83%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分

    请声明包含 README 的 GitHub 仓库,或在 OAuth 受保护资源元数据中提供 resource_documentation。

  • 许可证不适用

    托管服务按其提供方的条款使用,因此这里不要求许可证。此检查项不计入百分比。