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

A
Description quality
100%
Schema completeness
85%
Naming quality
80%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~2,342Tokens (tool definitions)
~1.1 KBTypical response size
Moderate attention impact (1.83% of 128k context)

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-http

What it can do

Tool inventory

Tools (15)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded15 tools