Cincopa MCP by usefulapi
List assets and galleries, edit their metadata, upload from URLs and delete media in Cincopa.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"cincopa": {
"url": "https://cincopa.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://cincopa.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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"
}Comunidad
Evidencia