Tuval Studio

io.github.ariferol01v1.0.7Updated Oct 6, 2026

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

VerifiedSTDIODesktop onlyFiles & StorageMedia & Design

Overview

AI-generated overview

Lets an AI assistant design graphics on a local browser canvas and export multi-page PDF catalogs, slide decks and social banners.

What it does
Tuval Studio MCP drives an interactive browser canvas so an agent can create and edit designs: pages, artboards, backgrounds, gradients and patterns, text with Google Fonts, vector shapes, SVG badges, images and filters. It manages layers, alignment, transforms and batch actions, and audits layouts for overflow and collisions. Vision tools return Base64 PNG snapshots and a layer tree so the agent can inspect and refine its work, and exports produce multi-page PDFs or PNG, JPG, WebP and SVG downloads.
When to use it
Use it when you want an agent to produce visual deliverables rather than code: multi-page product catalogs, brochures, magazines, pitch decks, slide presentations, or social media banners and thumbnails. It suits desktop agent workflows where a human can watch the canvas and iterate on the design.
Requirements
Runs locally via npx from the npm package @ariferol01/tuval-studio-mcp (Node.js required). Desktop only; no web executable. No account, API key, environment variable or header is declared. It connects to a local browser canvas over a WebSocket bridge at ws://127.0.0.1:8765, so the Tuval Studio editor page must be open in a browser tab.
Before you install
Design actions write to the canvas and can delete pages or layers (pages_delete, layer_delete, canvas_clear), and exports trigger browser downloads. It reads images from local disk paths (assets_load_from_path, assets_list_local), so only point it at folders you are comfortable exposing to the agent. It runs a local WebSocket bridge on 127.0.0.1:8765 and requires the Tuval Studio editor tab to be open.

Installation

In SourceWeft

  1. Open Tuval Studio in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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)

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

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

json
{  "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

Source: README.md at commit 6e6f0f7

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v1.0.7LatestOct 6, 2026