CreativeClaw MCP API

openapi: 3.2.0
info:
  title: Creativeclaw Co MCP API
  version: 0.3.0
  contact:
    name: CreativeClaw
    email: hello@creativeclaw.co
    url: https://creativeclaw.co
  license:
    name: Proprietary
    url: https://creativeclaw.co/terms/
  termsOfService: https://creativeclaw.co/terms/
  description: 'Operations tagged MCP across 2 of this provider''s published API definitions: creativeclaw-co-openapi.json, creativeclaw-co-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://app.creativeclaw.co
  description: Production MCP host
security:
- oauth2:
  - profile
  - email
tags:
- name: MCP
  description: Streamable HTTP JSON-RPC transport
paths:
  /mcp:
    post:
      tags:
      - MCP
      operationId: mcpJsonRpc
      summary: MCP Streamable HTTP endpoint
      description: 'JSON-RPC 2.0 over Streamable HTTP (MCP protocol 2025-03-26 and later). Requires a Bearer access token from the Clerk OAuth flow. Clients must send `Accept: application/json, text/event-stream`.'
      security:
      - oauth2:
        - profile
        - email
      - bearerAuth: []
      parameters:
      - name: MCP-Protocol-Version
        in: header
        required: false
        schema:
          type: string
          example: '2025-03-26'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/JsonRpcRequest'
            examples:
              initialize:
                summary: initialize
                value:
                  jsonrpc: '2.0'
                  id: 1
                  method: initialize
                  params:
                    protocolVersion: '2025-03-26'
                    capabilities: {}
                    clientInfo:
                      name: example-agent
                      version: 1.0.0
              toolsList:
                summary: tools/list
                value:
                  jsonrpc: '2.0'
                  id: 2
                  method: tools/list
                  params: {}
              toolsCall:
                summary: tools/call generate_image
                value:
                  jsonrpc: '2.0'
                  id: 3
                  method: tools/call
                  params:
                    name: generate_image
                    arguments:
                      prompt: A matte black espresso machine on a warm kitchen counter
      responses:
        '200':
          description: JSON-RPC success or error envelope, or a text/event-stream for streamed results.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonRpcResponse'
            text/event-stream:
              schema:
                type: string
        '401':
          description: Missing or invalid bearer token. Follow WWW-Authenticate to the protected-resource metadata.
          headers:
            WWW-Authenticate:
              schema:
                type: string
              description: Bearer challenge pointing at https://app.creativeclaw.co/.well-known/oauth-protected-resource/mcp
    servers:
    - url: https://app.creativeclaw.co
      description: Production MCP host
components:
  schemas:
    JsonRpcResponse:
      type: object
      required:
      - jsonrpc
      properties:
        jsonrpc:
          type: string
          const: '2.0'
        id:
          oneOf:
          - type: string
          - type: integer
          - type: 'null'
        result:
          type: object
          additionalProperties: true
        error:
          $ref: '#/components/schemas/JsonRpcError'
    JsonRpcRequest:
      type: object
      required:
      - jsonrpc
      - method
      properties:
        jsonrpc:
          type: string
          const: '2.0'
        id:
          oneOf:
          - type: string
          - type: integer
        method:
          type: string
          enum:
          - initialize
          - tools/list
          - tools/call
          - ping
          - notifications/initialized
        params:
          type: object
          additionalProperties: true
    JsonRpcError:
      type: object
      required:
      - code
      - message
      properties:
        code:
          type: integer
          description: JSON-RPC error code (e.g. -32600 invalid request, -32602 invalid params).
        message:
          type: string
        data:
          description: Optional protocol or tool error payload.
  securitySchemes:
    oauth2:
      type: oauth2
      description: OAuth 2.1 authorization code with PKCE S256. Dynamic client registration is supported. Request only `profile` and `email`.
      flows:
        authorizationCode:
          authorizationUrl: https://clerk.creativeclaw.co/oauth/authorize
          tokenUrl: https://clerk.creativeclaw.co/oauth/token
          refreshUrl: https://clerk.creativeclaw.co/oauth/token
          scopes:
            profile: Read the authenticated user profile
            email: Read the authenticated user email
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'Access token from the Clerk token endpoint, sent as `Authorization: Bearer <token>`.'
externalDocs:
  description: Developer and agent documentation
  url: https://creativeclaw.co/developers/
x-refined-from:
- creativeclaw-co-openapi.json
- creativeclaw-co-openapi.yml
x-mcp-endpoint: https://app.creativeclaw.co/mcp
x-mcp-transport: streamable-http
x-pkce: S256
x-mcp-tools:
- name: swap_video_characters
  summary: Swap people or characters in an existing video (up to 30 seconds) from reference photos or saved Characters with Seedance 2.5, keeping motion, cuts and audio. Free image previews first; 480p draft by default, 720p or 1080p direct.
  category: edit
  async: true
- name: update_video_workflow
  summary: Change one free preview of a video workflow, such as a character swap, before its paid render.
  category: edit
- name: generate_image
  summary: 'Generate or edit an image. Default model: Nano Banana 2.'
  category: generate
- name: generate_video
  summary: 'Generate, animate, extend, or edit video. Default model: Gemini Omni Flash.'
  category: generate
  async: true
- name: generate_speech
  summary: 'Generate speech or dialogue. Default model: ElevenLabs v4.'
  category: generate
- name: compare_models
  summary: Run one image prompt through 2–4 image models side by side.
  category: generate
- name: list_models
  summary: List current image, video, speech, and upscale models. Filter by category.
  category: discover
- name: get_model_params
  summary: Read a model’s live schema, defaults, enums, and extras.
  category: discover
- name: render_html_image
  summary: Render HTML/CSS to a PNG via the branded layout engine.
  category: layout
- name: render_html_video
  summary: Render code-driven HTML motion to MP4. Returns a job ID.
  category: layout
  async: true
- name: create_template
  summary: Create a reusable HTML or generative template.
  category: layout
- name: render_template
  summary: Render a saved template with parameter values.
  category: layout
- name: update_template
  summary: Patch an existing template’s fields.
  category: layout
- name: list_templates
  summary: List saved templates for the account.
  category: layout
- name: transcribe
  summary: Transcribe audio or video with word-level timestamps.
  category: edit
  async: true
- name: isolate_audio
  summary: Remove noise, music, and reverb from a voice recording.
  category: edit
  async: true
- name: upscale_image
  summary: 'Upscale an image: image_url, a model id such as upscale/aura-sr (default), and model-specific extras. list_models({category:"upscale"}) lists the models; get_model_params gives each model’s extras.'
  category: edit
- name: upscale_video
  summary: 'Upscale a video: video_url, a model id such as upscale/bytedance (default), and model-specific extras. list_models({category:"upscale"}) lists the models; get_model_params gives each model’s extras.'
  category: edit
- name: increase_frame_rate
  summary: 'Raise a video’s frame rate or make slow motion by generating in-between frames: video_url, a model id such as frame-interpolation/topaz-apollo (default), and extras target_fps, slowdown_factor. list_models({category:"frame_interpolation"}) lists the models.'
  category: edit
  async: true
- name: trim_video
  summary: Cut a time range from a video.
  category: edit
- name: scale_video
  summary: Resize, crop, or pad a video.
  category: edit
- name: add_subtitles
  summary: Burn captions onto a video.
  category: edit
- name: remove_background
  summary: 'Remove the background from an image or video: media_url, type, an optional model such as background-removal/bria-v3 (video default) or background-removal/veed (semi-transparent subjects), extras, and output_format webm, mp4 or prores. list_models({category:"background_removal"}) lists the models.'
  category: edit
- name: extract_frames
  summary: Extract still frames from a video.
  category: edit
- name: merge_media
  summary: Concatenate videos or audio, or mix an audio track onto video.
  category: edit
  async: true
- name: create_character
  summary: Create a Character with a reference image and optional voice.
  category: characters
- name: update_character
  summary: Update a Character, its reference image, or its saved voices.
  category: characters
- name: clone_voice
  summary: Attach a consented voice clone to an existing Character.
  category: characters
- name: list_characters
  summary: List reusable Characters and IDs.
  category: characters
- name: delete_character
  summary: Permanently delete a Character and its saved voices.
  category: characters
- name: create_film_project
  summary: Create a multi-shot Film project.
  category: film
- name: update_film_project
  summary: Save script, shots, storyboards, clips, and approval state.
  category: film
- name: get_film_project
  summary: Inspect one Film project.
  category: film
- name: list_film_projects
  summary: List Film projects for the account.
  category: film
- name: assemble_film
  summary: Merge approved clips and audio into the final Film.
  category: film
- name: list_themes
  summary: List brand themes and the default theme.
  category: brand
- name: get_theme
  summary: Fetch the default or named brand theme.
  category: brand
- name: update_theme
  summary: Create or update a brand theme, or open the visual editor.
  category: brand
- name: delete_theme
  summary: Soft-delete a brand theme.
  category: brand
- name: search_assets
  summary: Search the permanent asset library by type, query, tags, or name.
  category: assets
- name: show_media
  summary: Display workspace images, videos, and audio by asset ID, job ID, or Creative Claw CDN URL.
  category: assets
- name: update_asset
  summary: Set a unique name, replace tags, or update a description.
  category: assets
- name: delete_asset
  summary: Soft-delete an asset.
  category: assets
- name: load_image
  summary: Load an image URL inline for visual review.
  category: assets
- name: import_media
  summary: Open the media picker when the user still needs to choose a file.
  category: assets
- name: import_chatgpt_media
  summary: Convert a ChatGPT attachment into a durable CreativeClaw asset (ChatGPT only).
  category: assets
- name: get_upload_url
  summary: Mint a signed upload URL for clients that can HTTP PUT bytes.
  category: assets
- name: confirm_upload
  summary: Finalize a signed upload into the asset library.
  category: assets
- name: upload_asset
  summary: Copy a public, directly downloadable URL into the library.
  category: assets
- name: check_job
  summary: Poll an async job by job_id until it completes or fails.
  category: billing
- name: get_credits_balance
  summary: Read remaining credits and optionally estimate a generation cost.
  category: billing
- name: get_credits_link
  summary: Return a user-operated Polar checkout link for credit top-up.
  category: billing
- name: purchase_credits
  summary: 'Start a credit purchase. Packs: 1000/$10, 5000/$50, 11000/$100, 27500/$250.'
  category: billing
- name: submit_feedback
  summary: Send product feedback (bug, missing feature, praise) to the team.
  category: billing