# Cincopa — how to use (mcp.ai)

Connect your Cincopa account and use 5 tools for video and audio straight from your AI agent. Connect with your own API key. Cincopa is a comprehensive media platform offering tools for uploading, managing, and customizing multimedia content, including videos, images, and audio, with robust APIs for seamless integration.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_cincopa?ms=1787293500000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `cincopa_asset_upload_from_url`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/cincopa`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/cincopa/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/cincopa/asset/upload/from/url` — Tool to upload a new asset directly from a provided external URL and receive a status ID for tracking. Use when you need to import media from a remote source and optionally specify a gallery or existi
  - body: { fid?: string, rid?: string, type?: string, input: string }
- `POST https://api.mcp.ai/api/cincopa/asset/upload/from/url/abort` — Tool to abort an ongoing asset upload-in-progress by providing its status ID. Use when an upload is no longer needed, was initiated by mistake, or is taking too long.
  - body: { status_id: string }
- `POST https://api.mcp.ai/api/cincopa/asset/upload/from/url/get/status` — Tool to check the status of an asset upload initiated via URL by its status ID. Use after calling 'Upload Asset From URL' to poll for completion.
  - body: { status_id: string }
- `POST https://api.mcp.ai/api/cincopa/get/upload/iframe` — Tool to get an upload iframe URL for embedding an upload widget. Use when you need to generate an HTML iframe for uploading media to a Cincopa gallery.
  - body: { fid?: string, rrid?: string }
- `POST https://api.mcp.ai/api/cincopa/ping` — Tool to validate API connection. Use after obtaining a valid api_token to confirm connectivity.

## Example prompts
- "What can I do in Cincopa?"
- "Show me a summary of my Cincopa account"

## More
- Page: https://mcp.ai/cincopa
- Agent spec (llms.txt): https://mcp.ai/cincopa/llms.txt
- Postman collection: https://mcp.ai/cincopa/postman.json