home / mcp / jsoncut mcp server

Jsoncut MCP Server

Provides API-driven image and video config creation, validation, and schema access for automation.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "jsoncut-jsoncut-mcp-server": {
      "url": "https://mcp.jsoncut.com/mcp",
      "headers": {
        "X-API-Key": "your_jsoncut_api_key_here",
        "JSONCUT_API_KEY": "your_api_key_here"
      }
    }
  }
}

You can run a Model Context Protocol (MCP) Server to enable AI agents to create image and video configurations, validate them, and access schema resources. This serves as a bridge between your automation workflows and the Jsoncut API, making it easy to generate media configurations programmatically and securely.

How to use

Connect your MCP client to the public remote server for quick, no-install usage, or run a local MCP server for development and offline work.

Remote usage is configured with a server URL and your API key. For example, point your MCP client at the public server and pass your API key in the request headers to authorize calls.

{
  "jsoncut": {
    "url": "https://mcp.jsoncut.com/mcp",
    "headers": {
      "X-API-Key": "your_jsoncut_api_key_here"
    }
  }
}

How to use with local npx mode

If you prefer to run a local MCP server for development, you can start it with npx. This keeps your environment self-contained and avoids network calls during initial setup.

export JSONCUT_API_KEY=your_api_key_here
npx -y @jsoncut/mcp-server

Available tools

create_image_config

Create JSON configurations for image generation with a layer-based system including images, text, shapes, and gradients.

create_video_config

Create JSON configurations for video generation with clips, layers, transitions, and audio.

validate_config

Validate image or video configurations against the Jsoncut API before submission to ensure correctness and resource usage.

get_image_schema

Retrieve the complete image generation schema to understand all available options for image configs.

get_video_schema

Retrieve the complete video generation schema to understand all available options for video configs.

inspector

Interactively test and inspect MCP configurations against your API key using the MCP Inspector.