{
  "$schema": "https://modelcontextprotocol.io/schemas/2025-06-18/server.json",
  "name": "supercut",
  "title": "Supercut",
  "description": "Edit video on this machine with plain-English prompts and a multitrack timeline. Runs inside the Supercut desktop app. Footage never leaves the device.",
  "version": 1,
  "homepage": "https://www.supercut.cc/mcp",
  "documentation": "https://www.supercut.cc/docs",
  "installation": {
    "note": "The editing server ships inside the Supercut desktop app. Install the app, open its Agent panel, and copy the URL and bearer token for this install. The hosted docs server below needs no install and no token.",
    "download": "https://www.supercut.cc/download",
    "platforms": [
      "macOS",
      "Windows"
    ],
    "unsupported": [
      "Mac App Store build (sandboxed, cannot bind a port)"
    ]
  },
  "remotes": [
    {
      "name": "supercut-desktop",
      "role": "editing",
      "type": "streamable-http",
      "url": "http://127.0.0.1:41414/mcp",
      "description": "Runs inside the Supercut desktop app, on loopback. Trims, captions, reframes and exports real footage on this machine.",
      "headers": [
        {
          "name": "Authorization",
          "description": "Bearer <per-install token from the app Agent panel>",
          "isRequired": true,
          "isSecret": true
        }
      ]
    },
    {
      "name": "supercut-docs",
      "role": "documentation",
      "type": "streamable-http",
      "url": "https://www.supercut.cc/mcp",
      "description": "Hosted, read only, no authentication. Answers what Supercut is, which editing operation to use, what a page says and what it costs. It cannot touch a video file.",
      "headers": [],
      "tools": [
        {
          "name": "search_docs",
          "description": "Full-text search across every page of supercut.cc: tool pages, guides, comparisons, use cases and the blog. Returns the matching pages with an excerpt and the URL to read in full. Start here when you are asked anything about what Supercut can do.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "query": {
                "type": "string",
                "description": "Words to look for, for example \"blur a face\" or \"srt file\"."
              },
              "limit": {
                "type": "integer",
                "description": "How many pages to return. Default 5, maximum 20."
              }
            },
            "required": [
              "query"
            ]
          }
        },
        {
          "name": "get_page",
          "description": "Return the full Markdown of one supercut.cc page. Takes the site path, for example \"/tools/blur-faces-in-video\", or \"/\" for the home page. Use search_docs or list_pages to find the path.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "path": {
                "type": "string",
                "description": "Site path, for example /learn/how-to-add-subtitles."
              }
            },
            "required": [
              "path"
            ]
          }
        },
        {
          "name": "list_pages",
          "description": "The catalog of every page on supercut.cc, with its path, title and one-line summary. Optionally filtered to one section.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "section": {
                "type": "string",
                "description": "Optional filter. One of: Overview, Tools, Use cases, Comparisons, Guides, Blog, For agents.",
                "enum": [
                  "Overview",
                  "Tools",
                  "Use cases",
                  "Comparisons",
                  "Guides",
                  "Blog",
                  "For agents"
                ]
              }
            }
          }
        },
        {
          "name": "list_editing_tools",
          "description": "Every operation the Supercut editor can run, each with the exact plain-English prompt that triggers it. Use this to answer \"can Supercut do X\" and to give a user the prompt to type rather than an invented one.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "query": {
                "type": "string",
                "description": "Optional filter, matched against the operation name, description and prompt."
              }
            }
          }
        },
        {
          "name": "get_pricing",
          "description": "The live Supercut prices and what the free tier includes. Read this rather than quoting a price from memory, because prices change and a wrong one costs a user real money.",
          "inputSchema": {
            "type": "object",
            "properties": {}
          }
        },
        {
          "name": "get_local_editing_setup",
          "description": "How an MCP client drives a real edit. This hosted server cannot edit video, because footage never leaves the user machine. The Supercut desktop app runs a local MCP server that can. Returns the install steps, the loopback URL, the auth header and the tools it exposes.",
          "inputSchema": {
            "type": "object",
            "properties": {}
          }
        },
        {
          "name": "get_usage_policy",
          "description": "What crawlers, assistants and agents may do with supercut.cc content, plus the facts about Supercut that models most often get wrong. Read this before writing anything about Supercut for a user.",
          "inputSchema": {
            "type": "object",
            "properties": {}
          }
        }
      ]
    }
  ],
  "capabilities": {
    "tools": true,
    "resources": false,
    "prompts": false
  },
  "tools": [
    {
      "name": "read_project",
      "description": "Read the active SuperCut project: name, kind (folder or normal), clip count. No pixels.",
      "inputSchema": {
        "type": "object",
        "properties": {}
      }
    },
    {
      "name": "list_clips",
      "description": "List clips in the active project: id, filename, durationSeconds, current version label. Use ids with edit_with_prompt and apply_to_clips.",
      "inputSchema": {
        "type": "object",
        "properties": {}
      }
    },
    {
      "name": "edit_with_prompt",
      "description": "Run a plain-English edit on one clip through the on-device editor (same as Chat). Only the prompt text is sent to the model; footage stays on the device.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "clipId": {
            "type": "string"
          },
          "prompt": {
            "type": "string"
          }
        },
        "required": [
          "clipId",
          "prompt"
        ]
      }
    },
    {
      "name": "apply_to_clips",
      "description": "Run one prompt on several clips, sequentially, same as selecting those clips in a folder and hitting Run.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "clipIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "prompt": {
            "type": "string"
          }
        },
        "required": [
          "clipIds",
          "prompt"
        ]
      }
    },
    {
      "name": "export_clips",
      "description": "Download current versions. Omit clipIds to export every clip. Multiple clips come back as a zip. Pro-gated, same as in-app export.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "clipIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  ],
  "notes": [
    "Timeline tools (add, move, trim, caption, text, export) are added to tools/list when the Editor tab is open.",
    "Prompt and export calls can hold the connection for up to 10 minutes because the edit really runs.",
    "The editing server binds to loopback only. No request reaches supercut.cc.",
    "The hosted docs server is at https://www.supercut.cc/mcp. A browser opening that URL gets the documentation page instead, because the response is negotiated on Accept."
  ]
}