MCP server documentation

Claude on the web, desktop and mobile apps — a custom connector with OAuth sign-in. No key needed.

1. “Settings” → “Connectors” → “Add custom connector”. On Team and Enterprise plans the organization owner adds the connector in “Organization settings”.
2. Name — CG, URL — the server address (below). Leave OAuth Client ID and Secret empty: Claude registers itself.
3. “Connect” → the CG site opens: sign in, choose a workspace, toolsets and a daily limit → “Allow”.
4. In the chat, turn on the CG connector in the tools menu.

https://mcp.getcg.ai/mcp

To disconnect — “Disconnect” in the Claude connector or under “Connected apps” on the “Connections and MCP” page: access and all tokens stop working at once.

core — models, generations, assets, projects, balance. Always included.

• approvals_confirmПодтвердить трату
  FreeWindow only — the model doesn’t see itShows the estimate window

  Confirms a spending approval with the one-time key the quote window received in _meta. Called only by the quote window when the person presses Confirm; the model never sees it. Use when the window confirms an approval made before D175 (paid calls no longer ask). Don't use when you are the model — ask the user to confirm in the window or at the approval link.

• approvals_declineОтклонить трату
  FreeWindow only — the model doesn’t see itShows the estimate window

  Declines a spending approval with the one-time key the quote window received in _meta: the paid call will not run and nothing is charged. Called only by the quote window when the person presses Decline; the model never sees it. Use when the window declines an approval made before D175 (paid calls no longer ask). Don't use when you are the model — the user declines in the window or at the approval link.

• approvals_getСтатус подтверждения траты
  FreeRead onlyShows the estimate window

  Returns an approval: what it is for, its price, the link, expiry and whether a person confirmed it. Free. Paid tools no longer ask for spending approvals (they run at once, D175); this is for an approval link made before that, or the studio plan's approval. Use when the user asks about such a link. Don't use when you want to confirm it yourself — only a person can confirm, in the window or on the site.

• assets_download_urlСсылка на скачивание
  FreeRead only

  Returns a presigned download link for an asset (served as an attachment). Use when the user wants to download or keep a file. Don't use when you only need to show a preview (assets_get already has an inline link).

• assets_getАссет
  FreeRead only

  Returns one asset with its metadata, where it is used and a signed inline link. Use when you need details or a preview of a known asset. Don't use when the user wants to download the file (assets_download_url).

• assets_listБиблиотека
  FreeRead only

  Lists assets of the workspace library, newest first, filtered by project, kind, source, favourites or the trash; each ready asset has a signed inline link. Use when the user asks for their files or you need an asset id as an input. Don't use when you know the asset id (assets_get).

• billing_balance_getБаланс
  FreeRead only

  Returns the spendable USD balance with the breakdown by source and the held and frozen amounts. Use when the user asks how much money is left or before a large run. Don't use when you need the history of charges (billing_ledger_list).

• catalog_models_getМодель
  FreeRead onlyShows the models window

  Returns one model with its full capabilities: modes, slots (start, end, images, video, audio), parameter ranges and draft profile. Use when you are about to quote or run a model and need its exact parameters. Don't use when you are still browsing which model to take (catalog_models_list).

• catalog_models_listСписок моделей
  FreeRead onlyShows the models window

  Lists CG's generation models for the user's workspace — video (Seedance, Kling, Veo, Wan, Hailuo…), image (Nano Banana, FLUX, GPT Image, Imagen…), audio — one line each: id, name, kind, vendor, from-price; the window shows them as cards. Use when the user wants an image, video or sound made in CG (call it first), to choose a model or find a model's id by its name. Don't use when you already know the model id and need its full spec (catalog_models_get).

• catalog_pricing_publicПрайс-лист
  FreeRead only

  Returns the public price list: reference configurations of every visible model and their USD price, computed by the same rule as quotes. Use when the user asks how much things cost in general or to compare models by price. Don't use when you need the exact price of a concrete request (quotes_create).

• elements_getДуша
  FreeRead only

  Returns one element with the profile data and references of a version. Use when you need a character's look, references or handle before writing prompts or a scene plan. Don't use when you need a text card for an LLM prompt (elements_describe_for_llm).

• elements_searchНайти душу
  FreeRead only

  Searches the workspace's elements (characters, places, products, styles) by handle, alias or name prefix. Use when the user mentions a character or @handle and you need its id, or wants to reuse one in a generation. Don't use when you know the element id (elements_get).

• generate_mediaСгенерировать картинку, видео или звук
  Paid · estimate, runs right awayShows the job window

  Makes one image, video clip or sound in CG from a prompt and a model name ("Wan 2.2 Turbo", "Kling 3.0", "Nano Banana") with a few plain settings (aspect ratio, duration, resolution, sound, a start frame, reference pictures). CG prices it, runs it at once (no confirmation step; it is charged to the user's balance) and waits up to 45 s for the files. Use when the user asks for a picture, clip, animation or sound — the quick way: first with priceOnly true (free, nothing runs) to tell the user the price, then the same call without it. Don't use when making a film of several scenes (canvas_compose) or when a model needs inputs this tool lacks (jobs_create with the model's full params).

• jobs_cancelОтменить генерацию
  FreeDeletes or stops

  Cancels a job that a provider has not accepted yet; its hold returns in full (D8). Optional onlyIfStatusIn guards the cancel. Use when the user changed their mind or the job was started by mistake. Don't use when the job already succeeded — hide the asset instead (assets_delete) — or for a whole run (runs_cancel).

• jobs_createЗапустить генерацию
  Paid · estimate, runs right awayShows the job window

  Generates one image, video clip, sound or LLM answer in CG from modelId (a catalog id; a model name like "Wan 2.2" is matched to it) and params; CG prices it first and runs it at once (no confirmation step). Returns the held job at once; jobs_wait returns the files. Use when the user asked for a single picture, clip or sound and agreed to the price (quotes_create). Don't use when building a multi-shot film (canvas_compose, canvas_run) or running a template (templates_recreate).

• jobs_getГенерация
  FreeRead onlyShows the job window

  Returns one job: status, price, failure reason and signed links to its output files. Use when you need the current state or the files of a job you know. Don't use when you want to block until it finishes (jobs_wait) or list recent jobs (jobs_list).

• jobs_listИстория генераций
  FreeRead only

  Lists the workspace's jobs, newest first, with status and price. Use when the user asks about recent generations or you lost a job id. Don't use when you need the files of one known job (jobs_get) or the assets library (assets_list).

• jobs_waitДождаться генерации
  FreeRead onlyShows the job window

  Waits up to 50 seconds for a job to reach a terminal status and returns it with signed links to its files; sends progress notifications when the client gave a progress token. Free. Use when you started a job (jobs_create) and need the result before answering. Don't use when you only need the current status right now (jobs_get) or the job belongs to a long run (runs_get).

• projects_createСоздать проект
  Free

  Creates a project that groups canvases, timelines and generated assets. Use when the user starts a new piece of work and none of the existing projects fits. Don't use when canvas_compose or studio_start will create the project for you.

• projects_listПроекты
  FreeRead only

  Lists the workspace's projects, newest first, with keyset pagination. Use when you need a project id for a canvas, a timeline or a generation, or the user asks for their projects. Don't use when you know the id (projects_get).

• quotes_createСмета генерации
  FreeRead onlyShows the estimate window

  Prices one generation request (model, params, presets, elements) and returns a quote valid for 10 minutes with the USD total and breakdown. Nothing is charged. Use when the user wants to know the price before generating or you want a quoteId for jobs_create. Don't use when pricing a plan of many items (quotes_graph, canvas_quote).

• quotes_getСмета
  FreeRead onlyShows the estimate window

  Returns a single quote (qt_) or a graph quote (qg_) of the workspace with its items, totals and whether a run already used it. Use when you need to re-read a quote you or the user created earlier. Don't use when you need a fresh price — quotes expire after 10 minutes (quotes_create).

• renders_getРендер
  FreeRead onlyShows the job window

  Returns one render: status, progress, price and the output asset when done. Use when the user waits for the final film. Don't use when you need all renders of a timeline (renders_list).

• runs_getПрогон
  FreeRead only

  Returns a run (a batch of jobs from a canvas, an element or a plan): status, job counters, budget and spend. Use when you started a canvas run or element portrait and need its progress. Don't use when you need a single job's files (jobs_get).

• templates_getШаблон
  FreeRead only

  Returns a template: card, version, runner form, input schema and permissions. Use when you are about to quote or run it and need to know which inputs it takes. Don't use when browsing the catalog (templates_list).

• templates_listШаблоны
  FreeRead only

  Lists template apps: own, workspace, official or community cards with price estimates. Use when the user wants a ready-made generation recipe. Don't use when you know the template id (templates_get).

• templates_quote_recreateСмета шаблона
  FreeRead onlyShows the estimate window

  Prices a single or batch run of a template: rows ok, invalid or blocked, price per row, totals and balance. Nothing is charged. Use when the user wants to run a template. Don't use when you only want a free preview of the prompt (templates_render_preview).

• templates_recreateЗапустить шаблон
  Paid · estimate, runs right awayShows the job window

  Runs a template app from its quote; rows are dispatched with pacing as jobs. MCP prices it itself and it runs at once (no confirmation step). Use when the user agreed to the templates_quote_recreate price. Don't use when there is no fresh quote.

• uploads_completeЗавершить загрузку
  Free

  Verifies the uploaded bytes against the declaration, moderates them and turns the upload into an asset. Use when you have PUT the file to the URL from uploads_create. Don't use when the upload was not PUT yet, or to cancel it (uploads_abort).

• uploads_createНачать загрузку
  Free

  Declares a file (name, type, exact size) and returns a presigned PUT URL valid for one hour; PUT the bytes there, then call uploads_complete. Use when the user gives you a file to use as a reference or input. Don't use when the file already is an asset of the library (assets_list, assets_get).