Back to Browse

Tuval Studio MCP Server

Developer ToolsUse Caution4.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

Tuval Studio MCP: Graphic design, AI design & PDF catalog generator for Claude, Cursor & AI agents.

About

Tuval Studio MCP: Graphic design, AI design & PDF catalog generator for Claude, Cursor & AI agents.

Security Report

4.2
Use Caution4.2High Risk

Tuval Studio MCP is a well-intentioned design tool server with reasonable security posture. The server operates locally via WebSocket with no external API calls for sensitive operations, uses proper dependency management, and includes standard MCP SDK patterns. Minor code quality observations exist around error handling and input validation, but these do not constitute security vulnerabilities. Permissions are appropriate for the server's stated purpose of local graphic design operations. Supply chain analysis found 4 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.

3 files analyzed · 10 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

network_websocket

Check that this permission is expected for this type of plugin.

env_vars

Check that this permission is expected for this type of plugin.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-ariferol01-tuval-studio": {
      "args": [
        "-y",
        "@ariferol01/tuval-studio-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

Tuval Studio MCP Server 🎨

The Graphic Design MCP, AI Design MCP & PDF Generator MCP for AI Agents

npm version License: MIT Node.js Model Context Protocol

Tuval Studio MCP is the official MCP server for Tuval Studio (tuval.site).

It empowers desktop AI agents — including CodeDL, Claude Desktop, Cursor, Codex, Antigravity, Windsurf, Cline, Roo-Code, and OpenCode — with an autonomous, vision-guided design engine for:

  • 🎨 Graphic Design MCP & AI Design MCP: Automated vector composition, typography, mesh gradients, and smart layout audits.
  • 📄 PDF Generator MCP & Catalog Generator: Multi-page PDF catalog generation, magazine layouts, brochures, and pitch decks.
  • 📊 Presentation Generator & Slide Decks: High-resolution multi-page slide creation with synchronized typography and consistent visual branding.
  • 📱 Social Media Design: 1-click marketing banners, Instagram stories, YouTube thumbnails, and ads with zero text overflow.

Looking for a design MCP, PDF MCP, catalog MCP, or graphic design MCP? Tuval Studio MCP connects your AI agent directly to an interactive, client-side browser canvas with 100% privacy and real-time visual feedback!


🌟 Core Features

  • 🚀 Zero-Cloud & 100% Private: Operates entirely in your local browser through a high-speed local WebSocket bridge (ws://127.0.0.1:8765). Zero account or server storage required.
  • 📚 Multi-Page PDF Catalog Engine: Autonomous creation, management, and export of multi-page magazines, lookbooks, product brochures, and pitch decks with pdf_export_catalog.
  • 👁️ Multimodal Vision-in-the-Loop: Every action returns high-res visual snapshots (Base64 PNG) and layer coordinates so AI agents inspect, critique, and perfect their designs visually.
  • 🛡️ Zero-Overflow & Boundary Guard: Built-in validation protocol ensuring all typography, buttons, and badges maintain safe margins (min 50px) with no clipping.
  • ✨ Full Graphic Suite: Multi-layer vector manipulation, custom Google Fonts (Sora, Inter, Playfair, Cinzel, Syne, etc.), mesh gradients, geometric pattern textures, and 1-click AI background removal.
  • 💻 Local File Loading: Load and composite any local photo, asset, or logo from your computer hard drive directly onto the canvas.

⚡ Quick Setup for AI Agents

Add the configuration below to your AI agent's MCP settings file:

1. Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "tuval-studio": {
      "command": "npx",
      "args": ["-y", "@ariferol01/tuval-studio-mcp@latest"]
    }
  }
}

2. CodeDL, Cursor, Codex, Antigravity, Windsurf, Cline & Roo-Code

{
  "mcpServers": {
    "tuval-studio": {
      "command": "npx",
      "args": ["-y", "@ariferol01/tuval-studio-mcp@latest"]
    }
  }
}

How it works: Open Tuval Studio in your browser tab. When your AI agent executes design commands, it connects instantly to your active canvas tab!


🛠️ Complete MCP Tool Catalog

1. Document & Multi-Page PDF Engine

ToolDescription
pages_listLists all pages in the document with indices, dimensions, and active status.
pages_addCreates a new page (blank or cloned template) for catalog & brochure workflows.
pages_switchSwitches the active canvas viewport to a specific page index (0, 1, 2...).
pages_duplicateClones the current page layout and all layers to maintain visual consistency.
pages_deleteDeletes a page from the document.
pdf_export_catalogCompiles all pages into a print-ready, high-resolution multi-page PDF document.

2. Canvas & Artboard Setup

ToolDescription
studio_check_statusChecks connection status and instructs agent to open https://tuval.site/editor.
canvas_create_newInitializes a blank canvas with custom width, height, and background color.
canvas_set_dimensionsApplies standard dimensions or social presets (1080x1080, 1080x1920, 1280x720, 1200x630).
canvas_set_backgroundSets solid background color, alpha transparency, or full-bleed background textures.
canvas_set_gradientApplies mesh gradients (cyber, sunset, emerald, space, gold, candy, noir).
canvas_set_patternApplies geometric textures (dots, grid, carbon, isometric, topography, circuit).
canvas_load_templateLoads curated design templates (neon-sale-story, social-launch, youtube-thumbnail).
canvas_clearClears all objects from the current canvas.

3. Typography & Vector Shapes

ToolDescription
text_addAdds text with Google Fonts (Sora, Inter, Playfair Display, Bebas Neue, Cinzel, Syne).
text_update_styleUpdates font family, font size, color, letter spacing, line height, text align, and content.
shape_addInserts geometric shapes (rect, circle, triangle, star, hexagon, heart, pill, badge).
shape_update_styleModifies shape fill color, border stroke, corner radius (rx/ry), opacity, and shadow.
svg_addPlaces curated badges, trust stickers, flares, stars, and callouts onto the canvas.

4. Images, Media & Local Assets

ToolDescription
assets_load_from_pathReads an image from the user's local hard drive and converts it for instant canvas placement.
assets_list_localScans and lists local images and logos available in the workspace.
image_addInserts an image from URL, local file path, or Base64 (supports { isBackground: true }).
image_cropCrops images by bounding box coordinates or aspect ratio.
image_remove_bg_auto1-click client-side background remover.
image_remove_bg_magicMagic wand background extraction with configurable color tolerance.
filter_apply_presetApplies aesthetic color grading (Warm Film, Cyberpunk, Moody Noir, Vivid HDR, Film Grain).

5. Layer Management, Layout Audit & Vision Inspection

ToolDescription
design_audit_layoutAutomated zero-overflow and collision audit across all text and image layers.
studio_get_viewCaptures high-res canvas snapshot (Base64 PNG) & layer tree for visual AI audit.
layer_reorderMoves layers in stack (bring_to_front, send_to_back, bring_forward, send_backward).
layer_alignAligns layers to canvas center, left, right, top, or bottom.
layer_transformAdjusts rotation angle, flip X/Y, opacity, drop shadow, and blend modes.
layer_duplicate / layer_deleteDuplicates or removes specific layers.
studio_batch_actionsExecutes sequential multi-step commands in a single atomic call.
project_set_titleRenames the design project.
project_export_downloadTriggers browser download for PNG, JPG, WebP, or SVG graphics.

🎯 Example Prompts for AI Agents (CodeDL, Claude, Cursor, Codex, Antigravity)

1. Multi-Page Product Catalog & PDF Generation

"Use Tuval Studio MCP to create a 4-page modern Scandinavian furniture catalog. Design an editorial cover on Page 1, a product grid with pricing on Pages 2 and 3, and contact/order details on Page 4. Inspect each page with vision audit for safe margins and export the final multi-page PDF."

2. Social Media Design & Banner Generation

"Design a high-contrast Cyberpunk social media ad banner (1080x1080) for a product launch. Apply dark gradient backgrounds, bold typography, neon callout badges, and verify with design_audit_layout that no text overflows boundaries."

3. Presentation Generator & Pitch Decks

"Build a 5-slide pitch deck presentation in Tuval Studio. Maintain brand colors, modern typography hierarchy, clean card layouts, and export the entire deck as a print-ready PDF."


🔍 Tags & Keywords

Tuval Studio MCP · MCP server · graphic design MCP · AI design MCP · PDF generator MCP · PDF MCP · design MCP · catalog MCP · catalog generator · presentation generator · social media design · AI agents · CodeDL · Claude · Cursor · Codex · Antigravity


📄 License

MIT © Tuval Studio

Reviews

No reviews yet

Be the first to review this server!