io.github.ariferol01/tuval-studio

Tuval Studio MCP Server 🎨

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

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

• ⚡ Powered by APIDL Engine (apidlai.com): Breakthrough closed-loop design orchestration developed by apidlai.com. Converges in 2–3 iterative phases (draft -> refine -> final) with automated Quality Gate audits, slashing token costs by ~92% and accelerating execution by 10x compared to traditional single-call MCP tools.
• 🚀 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

2. Canvas & Artboard Setup

3. Typography & Vector Shapes

4. Images, Media & Local Assets

5. Layer Management, Layout Audit & Vision Inspection

🎯 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