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,刪除資產會一併從儲存空間移除並使連結失效。帳務工具可讀取與更新帳務資訊。上傳及字幕、音訊流程需對預先簽署的網址發出後續 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。

  • 授權條款不適用

    託管服務按其提供方的條款使用,因此這裡不要求授權條款。此檢查項不計入百分比。