Jsoncut MCP Server

Create a JSON configuration for image generation based on jsoncut documentation.

Returns a complete configuration object that can be used with the validate_config tool or submitted directly to the jsoncut API.

WORKFLOW:

1. First get the schema (read resource schema://image or call get_image_schema) to understand all available options

2. Create the configuration with this tool

3. Call validate_config to verify the configuration (if user provided media file paths)

Image Structure:

• Layer-based system (rendered bottom to top, max 50 layers)

• Canvas with dimensions, background color, and output format

• Support for defaults to avoid repetition

Layer Types:

• image: Display uploaded images with fit modes (cover, contain, fill, inside, outside)

• text: Text with custom fonts, alignment, wrapping, and effects

• rectangle: Rectangular shapes with fill, stroke, and rounded corners

• circle: Circular and elliptical shapes

• gradient: Linear or radial color gradients

Positioning Options:

• x, y coordinates (pixels from top-left)

• position strings: center, top, bottom, top-left, top-right, center-left, center-right, bottom-left, bottom-right

• position objects: { x: 0-1, y: 0-1, originX: left|center|right, originY: top|center|bottom }

Visual Effects:

• opacity: 0-1 transparency

• rotation: degrees

• blur: pixel radius

• borderRadius: rounded corners (image, rectangle)

Text Features:

• Custom fonts via fontPath or Google Fonts via googleFont (format: 'FontName:weight' e.g. 'Roboto:600')

• Text wrapping with width and lineHeight

• Alignment: left, center, right

• backgroundColor (single line only)

Output Formats:

• png: Lossless with transparency (default)

• jpeg: Lossy compression (use quality parameter)

• webp: Modern format with transparency and compression

Defaults System:

• defaults.layer: Properties for all layers

• defaults.layerType.{type}: Properties for specific layer types

File paths should be placeholders like "/image/2024-01-15/userXXX/filename.ext" or "/font/2024-01-15/userXXX/font.ttf".

Create a JSON configuration for video generation based on jsoncut documentation.

Returns a complete configuration object that can be used with the validate_config tool or submitted directly to the jsoncut API.

WORKFLOW:

1. First get the schema (read resource schema://video or call get_video_schema) to understand all available options

2. Create the configuration with this tool

3. Call validate_config to verify the configuration (if user provided media file paths)

Video Structure:

• Built using clips (segments) that play sequentially

• Each clip contains layers (rendered bottom to top)

• Supports transitions between clips

• Comprehensive audio system with multiple options

Layer Types:

• video: Display video files with timing control, Ken Burns effects, and enhanced positioning

• image: Static images with positioning and Ken Burns effects

• image-overlay: Images positioned over other content with timing

• title: Large headline text with animation styles (fade-in, word-by-word, letter-by-letter) and enhanced positioning

• subtitle: Smaller text for captions

• news-title: Breaking news style with colored backgrounds

• title-background: Titles with full-screen backgrounds

• slide-in-text: Animated text that slides in

• audio: Audio tracks tied to clips (requires keepSourceAudio: true)

• detached-audio: Audio with clip-relative timing

• fill-color: Solid color backgrounds

• linear-gradient: Linear gradient backgrounds

• radial-gradient: Radial gradient backgrounds

• rainbow-colors: Animated rainbow effects

• pause: Black screen pauses

Audio Options:

• audioFilePath + loopAudio: Background music throughout video

• audioTracks: Multiple audio tracks with independent timing

• audioNorm: Audio normalization with ducking

• keepSourceAudio: Keep audio from video layers

• Audio layers within clips

Video & title layer Positioning:

• Position objects: { x: 0-1, y: 0-1, originX: left|center|right, originY: top|center|bottom }

• Position strings: center, top, bottom, top-left, top-right, center-left, center-right, bottom-left, bottom-right

• Video layers support both position objects and strings

• Title layers support enhanced positioning with position objects

Title Layer Animation Styles:

• fade-in: Smooth fade-in effect (default)

• word-by-word: Words appear sequentially

• letter-by-letter: Letters appear sequentially

• Zoom effects automatically disabled for word-by-word and letter-by-letter styles

Transitions: 75+ transition effects including fade, wipe, circle, cube, glitch, zoom, etc.

File paths should be placeholders like "/input/userXXX/filename.ext".

Validate a job configuration against the jsoncut API.

This tool sends the configuration to the API's validation endpoint to check:

• Schema compliance

• Resource availability

• Estimated token cost

• Any configuration errors

WHEN TO USE:

• ONLY call this tool if the user has provided actual media file paths (e.g., from uploaded files)

• DO NOT validate configurations with placeholder paths like "/image/2024-01-15/userXXX/..."

• Always call this after creating a configuration when real file paths are available

BENEFITS:

• Catches errors before job submission

• Provides accurate token cost estimates

• Verifies that referenced files exist and are accessible

Get the complete JSON schema for image generation.

Returns the full JSON Schema document that defines all possible configuration options for image generation jobs. Use this to understand all available options, constraints, and examples.

NOTE: This schema is also available as a resource at schema://image which can be read directly without a tool call.

IMPORTANT: Get this schema FIRST when creating image configurations to understand the complete structure, available layer types, positioning options, and all properties. This ensures you create valid and complete configurations.

Get the complete JSON schema for video generation.

Returns the full JSON Schema document that defines all possible configuration options for video generation jobs. Use this to understand all available options, constraints, and examples.

NOTE: This schema is also available as a resource at schema://video which can be read directly without a tool call.

IMPORTANT: Get this schema FIRST when creating video configurations to understand the complete structure, available layer types, audio options, transitions, and all properties. This ensures you create valid and complete configurations.