Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.moda.app/llms.txt

Use this file to discover all available pages before exploring further.

The most popular way to use Moda’s MCP server is to create designs by chatting with Claude. Instead of opening a design tool and building layouts by hand, you describe what you want and Claude creates it for you in Moda. This works from any Claude environment — the desktop app, the browser at claude.ai, Claude Code in your terminal, or even Claude on mobile. Claude is the primary workflow covered here because it’s the most common for Moda design creation. The same MCP tools can also be used from Cursor and other MCP-capable clients, but the exact UX depends on the host app.

​
How it works

  1. You ask Claude to create a design (a slide deck, social post, ad, report, etc.)
  2. Claude calls the start_design_task tool on the Moda MCP server
  3. The tool returns immediately with a task handle and a canvas URL — your design starts building right away
  4. On claude.ai web and Claude Desktop, an embedded progress view shows live updates and rendered pages as the agent works. On other clients, Claude (or any MCP host) polls get_task_status(task_id) to track progress.
  5. Once the design is ready, you can open it, edit it, export it, or ask Claude to revise it
Every design Claude creates is fully editable in Moda — you’re never locked into what the AI produces.

​
Quick setup

If you haven’t connected Moda yet, it takes about 30 seconds. Follow the setup guide for your environment (Claude Desktop, claude.ai, Claude Code, Claude mobile, Cursor, or VS Code). Before your first prompt:
  1. In Claude, click the + button in the chat box.
  2. Open Connectors.
  3. Enable Moda for the current conversation.
If you belong to multiple Moda organizations or teams, ask Claude to switch to the right workspace first: 
What Moda organization and team am I currently using?

Switch Moda to the "Acme Corp" organization and the "Marketing" team.

​
Example prompts

Here are real prompts you can copy and paste into Claude right now. Be explicit about the output type in every prompt, especially for non-slide work. Phrases like PDF report, Instagram post, diagram, flowchart, or presentation slides help Moda choose the right format.

​
Slide decks and presentations

Create a 10-slide pitch deck for a B2B SaaS startup called "Relay" that does
automated customer onboarding. Include a title slide, problem, solution,
how it works, market size, business model, traction, team, and a closing CTA.

Turn these meeting notes into a clean presentation:
[paste your notes here]

Create a quarterly business review deck with sections for revenue,
customer growth, product updates, and next quarter goals. Use a
professional dark theme.

​
Social media posts

Create 5 Instagram carousel slides announcing our new product feature.
The feature is [describe feature]. Use bold typography and a modern layout.

Design a LinkedIn post image announcing that we just raised a Series A.
Keep it clean and professional.

Create a set of 4 social media ads for a summer sale — 20% off everything.
Make versions for Instagram (1080x1080) and Instagram Stories (1080x1920).

​
Marketing and ads

Create a one-page product flyer for our new wireless headphones.
Key features: 40hr battery, active noise cancellation, $149 price point.
Use a clean white background with product-focused layout.

Design a banner ad (1200x628) for a webinar called "The Future of AI in Design"
happening on May 15th. Include a register CTA.

​
Reports and documents

Create a project status report as a PDF. The project is "Website Redesign",
it's 65% complete, on track for the June deadline. Include sections for
accomplishments, risks, and next steps.

Create a one-page PDF resume for a senior product designer with 8 years of
experience. Use a modern, minimal layout.

​
Diagrams and visuals

Create a flowchart showing our user onboarding process:
Sign up → Verify email → Choose plan → Connect integrations → Dashboard

Create an organizational chart diagram for a 20-person startup with
Engineering, Design, Product, and Operations teams.

​
Using your brand

If your team has a default brand kit in Moda, Claude applies it to designs automatically. Your brand colors, fonts, logos, and style guidelines are used without you having to mention them. To set up a brand kit from Claude: 
Create a brand kit from our website: https://yourcompany.com
Moda will scrape your site and extract colors, fonts, logos, and brand guidelines. The first brand kit created for a team becomes the default automatically. If your team already has a default brand kit, you can ask Claude to use the new one explicitly: 
Create a slide deck using the "Acme Corp" brand kit.
You can also ask Claude to check what brand assets are available: 
What brand kits do we have set up? Show me the colors and fonts.

​
Iterating on designs

Claude remembers the context of your conversation, so you can refine designs with follow-up messages: 
Make the headline bigger and change the background to dark blue.

Add a third slide with customer testimonials.

Swap the layout to put the image on the left and text on the right.
Each follow-up modifies the same canvas — Claude tracks the conversation automatically. You don’t need to start over.

​
Attaching references

You can give Claude reference images, PDFs, or existing Moda designs to work from: 
Here's a screenshot of a landing page I like: [paste image]
Create something similar but with our branding.

Use this PDF as the content source and turn it into a slide deck:
[paste or upload PDF]

Look at my existing canvas "Q1 Marketing Deck" and create a Q2 version
with updated numbers.

​
Specifying format and dimensions

For best results, tell Claude what kind of design you want:
What you’re makingSuggested prompt addition
Slide deck / presentation”Create slides” or “Create a presentation”
Social media post”Create an Instagram post” (or specify platform)
PDF / report / document”Create a PDF report” or “Create a one-pager”
Diagram / flowchart”Create a diagram” or “Create a flowchart”
UI mockup”Create a UI mockup” or “Design a screen”
You can also specify exact dimensions: 
Create a social media post at 1080x1080 pixels.

Create presentation slides at 1920x1080.

​
Exporting your designs

Once Claude creates a design, you can export it directly from the conversation. Under the hood, the MCP flow is:
  1. start_design_task(...) — returns immediately with {task_id, canvas_id, canvas_url, status: 'queued'}
  2. get_task_status(task_id) until can_export == true or the task reaches a terminal failure state
  3. export_canvas(canvas_id=..., format=...)
On claude.ai web and Claude Desktop, the live-progress iframe handles step 2 visually so neither you nor Claude has to wait for the tool to finish before seeing pages render. On hosts without iframe support, Claude polls get_task_status itself. If export is attempted too early, Moda MCP returns a structured not_ready response with a retry interval instead of a tool error. Then Claude can export from the conversation: 
Export that as a PDF.

Export the slide deck as a PowerPoint file.

Export page 1 as a PNG.
Supported formats: PNG, JPEG, PDF, and PPTX.

​
Tips for great results

  • Be specific about content. The more detail you give Claude about text, structure, and layout, the better the output. Vague prompts produce generic designs.
  • Mention the format. Saying “create a slide deck” vs. “create a social post” helps Moda choose the right canvas dimensions and layout style.
  • Provide real content. Instead of “add some text about our product,” paste the actual copy you want on the design.
  • Iterate in conversation. Don’t try to get everything perfect in one prompt. Start with the structure, then refine colors, layout, and content in follow-ups.
  • Use brand kits. Setting up a brand kit once means every design automatically uses your colors, fonts, and logos.
  • Attach references. If you have a design you like, share it as a reference image. Claude can match the style while using your content.

​
Usage limits

Your organization has a cap on how many design tasks can run at once. start_design_task and remix_design calls from the MCP server share this cap with your REST API usage.
PlanMax concurrent tasks
free3
free_beta3
paid10
ultra15
When you hit the cap, the tool returns an error like "Rate limit exceeded: 10/10 concurrent tasks active." Wait for an existing task to finish (poll via get_task_status) and retry. See Usage Limits for the full picture, including how to contact support if you need a higher cap.

​
What’s next

  • Setup Guide — Detailed setup for all editors
  • Agent Skill — Drop our skill into your AI agent so it picks the right pattern without you re-explaining
  • Design Task Recipes — The four canonical start_design_task patterns (create / edit / fill template / rebrand template) with side-by-side REST + MCP examples
  • Tools Reference — Full reference for start_design_task, remix_design, and all other tools
  • Design-to-Code Guide — The reverse workflow: turning Moda designs into code