@jsoncut/mcp-server
Advanced tools
Model Context Protocol server for jsoncut API - Generate images and videos using AI
Model Context Protocol server for the Jsoncut API
Enable AI agents to generate stunning images and videos programmatically
export JSONCUT_API_KEY=your_api_key_here
npx -y @jsoncut/mcp-server
A public MCP server is available at https://mcp.jsoncut.com. No installation needed - just configure your MCP client with your API key:
{
"jsoncut": {
"url": "https://mcp.jsoncut.com/mcp",
"headers": {
"x-api-key": "your_jsoncut_api_key_here"
}
}
}
You can also run your own local server using Docker:
# Pull and run from Docker Hub
docker run -d \
--name jsoncut-mcp \
-p 3210:3000 \
centerbit/jsoncut-mcp-server:latest
# Access at: http://localhost:3210/mcp
Or use Docker Compose:
# Start the service
docker-compose up -d
# Access at: http://localhost:3210/mcp
📖 See DOCKER.md for complete Docker deployment guide
Get your Jsoncut API key at jsoncut.com
# Set as environment variable
export JSONCUT_API_KEY=your_api_key_here
# Or create .env file
cp .env.example .env
# Edit .env and add: JSONCUT_API_KEY=your_api_key_here
Use the public server at https://mcp.jsoncut.com:
Open Cursor Settings → Features → MCP Servers → "+ Add New MCP Server"
{
"jsoncut": {
"url": "https://mcp.jsoncut.com/mcp",
"headers": {
"X-API-Key": "your_jsoncut_api_key_here"
}
}
}
Add to your claude_desktop_config.json:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"jsoncut": {
"url": "https://mcp.jsoncut.com/mcp",
"headers": {
"X-API-Key": "your_jsoncut_api_key_here"
}
}
}
}
For local development without network access:
{
"jsoncut": {
"command": "npx",
"args": ["-y", "@jsoncut/mcp-server"],
"env": {
"JSONCUT_API_KEY": "your_api_key_here"
}
}
}
{
"mcpServers": {
"jsoncut": {
"command": "npx",
"args": ["-y", "@jsoncut/mcp-server"],
"env": {
"JSONCUT_API_KEY": "your_api_key_here"
}
}
}
}
If you're running your own local Docker server:
{
"jsoncut": {
"url": "http://localhost:3210/mcp",
"headers": {
"X-API-Key": "your_jsoncut_api_key_here"
}
}
}
{
"mcpServers": {
"jsoncut": {
"url": "http://localhost:3210/mcp",
"headers": {
"X-API-Key": "your_jsoncut_api_key_here"
}
}
}
}
The server automatically exposes JSON schemas as MCP resources:
schema://image - Complete image generation schemaschema://video - Complete video generation schemaAI agents can read these directly without tool calls for fast access to all configuration options.
create_image_configCreate JSON configurations for image generation with a layer-based system.
Layer Types:
Positioning:
{ x: 100, y: 50 }center, top, bottom, top-left, top-right, etc.{ x: 0.5, y: 0.5, originX: "center", originY: "center" }Example:
{
"width": 1200,
"height": 630,
"layers": [
{
"type": "gradient",
"x": 0, "y": 0, "width": 1200, "height": 630,
"gradient": {
"type": "linear",
"colors": ["#667eea", "#764ba2"],
"direction": "diagonal"
}
},
{
"type": "text",
"text": "Welcome to Jsoncut",
"position": "center",
"fontSize": 64,
"color": "#ffffff"
}
]
}
create_video_configCreate JSON configurations for video generation with clips, layers, and transitions.
Key Features:
Example:
{
"width": 1920,
"height": 1080,
"fps": 30,
"defaults": {
"duration": 3,
"transition": { "name": "fade", "duration": 1 }
},
"clips": [
{
"layers": [
{ "type": "title", "text": "Welcome", "position": "center" }
]
}
]
}
validate_configValidate configurations against the Jsoncut API before submission.
Parameters:
type: "image" or "video"config: Configuration object to validateapiKey: Optional API key (uses environment if not provided)Returns:
get_image_schema / get_video_schemaGet complete JSON schemas for image or video generation.
Note: Schemas are also available as MCP resources (schema://image and schema://video) which AI agents can access directly without tool calls.
create_image_config or create_video_configvalidate_config if you have actual file pathsThe schemas are automatically available as MCP resources, so AI agents have instant access to all configuration options.
Use placeholder paths in configurations:
/image/2024-01-15/userXXX/photo.jpg
/video/2024-01-15/userXXX/video.mp4
/audio/2024-01-15/userXXX/music.mp3
/font/2024-01-15/userXXX/CustomFont.ttf
Supported formats:
Use the MCP Inspector for interactive testing:
export JSONCUT_API_KEY=your_api_key_here
npm run inspector
# Clone and install
git clone https://github.com/jsoncut/jsoncut-mcp-server.git
cd jsoncut-mcp-server
npm install
# Build
npm run build
# Watch mode
npm run watch
# Run locally
node dist/index.js
For Cursor/Claude Desktop, use the local build:
{
"jsoncut": {
"command": "node",
"args": ["/absolute/path/to/jsoncut-mcp-server/dist/index.js"],
"env": {
"JSONCUT_API_KEY": "your_api_key_here"
}
}
}
See the examples/ directory for complete configurations:
image-example.json - Image generation with multiple layer typesvideo-example.json - Video generation with clips and transitionsContributions are welcome! Please feel free to submit a Pull Request.
MIT License - see LICENSE file for details.
Built with the Model Context Protocol SDK by Anthropic
Made with ❤️ by the Jsoncut Team
FAQs
Model Context Protocol server for jsoncut API - Generate images and videos using AI
We found that @jsoncut/mcp-server demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Socket CEO Feross Aboukhadijeh joins Insecure Agents to discuss CVE remediation and why supply chain attacks require a different security approach.
Security News
Tailwind Labs laid off 75% of its engineering team after revenue dropped 80%, as LLMs redirect traffic away from documentation where developers discover paid products.
Security News
The planned feature introduces a review step before releases go live, following the Shai-Hulud attacks and a rocky migration off classic tokens that disrupted maintainer workflows.