Cincopa MCP by usefulapi
List assets and galleries, edit their metadata, upload from URLs and delete media in Cincopa.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"cincopa": {
"url": "https://cincopa.usefulapi.io/mcp"
}
}
}Remote endpoints
https://cincopa.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (15)
🟢cincopa_check_connection
Check that the api_token works. Returns the account id, the user id and the permissions the token holds (for example asset.*, gallery.*). Cincopa API: GET /ping.json.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cincopa_list_assets(search, type, rid, reference_id, tag, ...)
List media assets (video, image, audio, other) in the account, with search and filters. Use rid for one exact asset. Cincopa API: GET /asset.list.json.
Input Schema
{
"type": "object",
"properties": {
"search": {
"description": "Text to search in asset names and metadata.",
"type": "string"
},
"type": {
"description": "Return only assets of this type. Default: all types.",
"type": "string",
"enum": [
"video",
"image",
"audio",
"other"
]
},
"rid": {
"description": "Exact asset id (rid). Partial matches do not work.",
"type": "string"
},
"reference_id": {
"description": "Find an asset by your own reference_id.",
"type": "string"
},
"tag": {
"description": "Find assets that carry this tag.",
"type": "string"
},
"page": {
"description": "Page number of the results (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"items_per_page": {
"description": "Items per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cincopa_get_asset_tags
List the tags used on the account's assets. Use the names with cincopa_list_assets (tag filter). Cincopa API: GET /asset.get_tags.json.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cincopa_get_upload_status(status_id)
Check the status of an upload started with cincopa_upload_asset_from_url, by its status_id. Cincopa API: GET /asset.upload_from_url_get_status.json.
Input Schema
{
"type": "object",
"properties": {
"status_id": {
"type": "string",
"minLength": 1,
"description": "The status_id that cincopa_upload_asset_from_url returned."
}
},
"required": [
"status_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cincopa_list_galleries(search, filter_tags, page, items_per_page)
List galleries (video collections) in the account, with search and tag filters. Use the fid of a gallery with cincopa_get_gallery_items. Cincopa API: GET /gallery.list.json.
Input Schema
{
"type": "object",
"properties": {
"search": {
"description": "Text to search in gallery names, descriptions and ids.",
"type": "string"
},
"filter_tags": {
"description": "Comma-separated tags. Return galleries with these tags.",
"type": "string"
},
"page": {
"description": "Page number of the results (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"items_per_page": {
"description": "Items per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cincopa_get_gallery_items(fid, details, page, items_per_page)
List the assets in one gallery, by its fid. Cincopa API: GET /gallery.get_items.json.
Input Schema
{
"type": "object",
"properties": {
"fid": {
"type": "string",
"minLength": 1,
"description": "The gallery id (fid) from cincopa_list_galleries."
},
"details": {
"description": "Extra metadata fields to return with each item, as the vendor lists them.",
"type": "string"
},
"page": {
"description": "Page number of the results (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"items_per_page": {
"description": "Items per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"fid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cincopa_list_live_streams
List the live streams in the account with their state. Cincopa API: GET /live.list.json.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡cincopa_set_asset_meta(rid, caption, description, long_description, reference_id, ...)
Change the caption, description, tags or reference_id of one asset. Only the fields you pass change. Cincopa API: POST /asset.set_meta.json.
Input Schema
{
"type": "object",
"properties": {
"rid": {
"type": "string",
"minLength": 1,
"description": "The asset id (rid) to change."
},
"caption": {
"description": "New caption (title shown on the player).",
"type": "string"
},
"description": {
"description": "New short description.",
"type": "string"
},
"long_description": {
"description": "New long description.",
"type": "string"
},
"reference_id": {
"description": "Your own reference id for the asset.",
"type": "string"
},
"tags": {
"description": "Comma-separated tags. Replaces the current tags.",
"type": "string"
},
"video_thumb_sec": {
"description": "Second of the video used as the thumbnail.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"rid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴cincopa_upload_asset_from_url(input, fid, rid, type)
Start an upload where Cincopa fetches a public file URL (image, video, audio or document). Returns a status_id; check it with cincopa_get_upload_status. Cincopa API: POST /asset.upload_from_url.json.
Input Schema
{
"type": "object",
"properties": {
"input": {
"type": "string",
"format": "uri",
"description": "The public URL of the file that Cincopa should fetch."
},
"fid": {
"description": "Gallery id (fid) to add the asset to.",
"type": "string"
},
"rid": {
"description": "Asset id (rid) to attach the file to, for example as a thumbnail.",
"type": "string"
},
"type": {
"description": "Type of the attached file, for example thumb.",
"type": "string"
}
},
"required": [
"input"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴cincopa_delete_asset(rid)
Permanently delete one asset by its rid. The asset is removed from every gallery. This cannot be undone. Cincopa API: POST /asset.delete.json.
Input Schema
{
"type": "object",
"properties": {
"rid": {
"type": "string",
"minLength": 1,
"description": "The asset id (rid) to delete."
}
},
"required": [
"rid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴cincopa_create_gallery(name, description)
Create an empty gallery with a name and an optional description. Cincopa API: POST /gallery.create.json.
Input Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "The gallery name."
},
"description": {
"description": "Short description of the gallery.",
"type": "string"
}
},
"required": [
"name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡cincopa_set_gallery_meta(fid, name, description, tags)
Change the name, description or tags of one gallery. Only the fields you pass change. Cincopa API: POST /gallery.set_meta.json.
Input Schema
{
"type": "object",
"properties": {
"fid": {
"type": "string",
"minLength": 1,
"description": "The gallery id (fid) to change."
},
"name": {
"description": "New gallery name.",
"type": "string",
"minLength": 1,
"maxLength": 255
},
"description": {
"description": "New description (up to 1,000 characters).",
"type": "string",
"maxLength": 1000
},
"tags": {
"description": "Comma-separated tags (up to 50). Replaces the current tags.",
"type": "string"
}
},
"required": [
"fid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴cincopa_add_gallery_items(fid, rid, insert_position)
Add one or more existing assets to a gallery, at the top or the bottom. Cincopa API: POST /gallery.add_item.json.
Input Schema
{
"type": "object",
"properties": {
"fid": {
"type": "string",
"minLength": 1,
"description": "The gallery id (fid)."
},
"rid": {
"type": "string",
"minLength": 1,
"description": "One asset id (rid), or several separated by commas."
},
"insert_position": {
"description": "Where to add the assets (default: vendor default).",
"type": "string",
"enum": [
"top",
"bottom"
]
}
},
"required": [
"fid",
"rid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴cincopa_remove_gallery_items(fid, rid)
Remove one or more assets from a gallery. The assets themselves are kept (delete_assets is always no). Cincopa API: POST /gallery.remove_item.json.
Input Schema
{
"type": "object",
"properties": {
"fid": {
"type": "string",
"minLength": 1,
"description": "The gallery id (fid)."
},
"rid": {
"type": "string",
"minLength": 1,
"description": "One asset id (rid), or several separated by commas."
}
},
"required": [
"fid",
"rid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴cincopa_delete_gallery(fid, delete_assets)
Delete one gallery. By default its assets are kept; set delete_assets to true to delete the assets too. Cincopa API: POST /gallery.delete.json.
Input Schema
{
"type": "object",
"properties": {
"fid": {
"type": "string",
"minLength": 1,
"description": "The gallery id (fid) to delete."
},
"delete_assets": {
"description": "Also delete the assets in the gallery (default false).",
"type": "boolean"
}
},
"required": [
"fid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence