New Inspiro AI Demo Generator — can't find the perfect demo? Describe your website and AI builds a custom one in about 2 minutes. Learn more →

Knowledge Base

Documentation

Theme Documentation



Plugin Documentation



Resources

Build pages with the Design MCP

This article refers to WPZOOM Design MCP

Once the server is connected, you talk to your agent as usual and it uses the Design MCP’s tools behind the scenes. This article explains what the tools do, which prompts work well, how to get WordPress blocks or Tailwind instead of plain HTML, and the fair-use limits.


Table of Contents

  1. The nine tools
  2. Prompts that work
  3. Output formats: HTML, Tailwind, WordPress blocks
  4. Images
  5. Fair use and limits
  6. Troubleshooting

The nine tools

The server tells the agent the order of work: read the design system, pick sections, fill them with content, compose the page. Every rendering tool takes a format (html, tailwind or blocks).

Tool What it does
list_templates Every design with its tags, section count and pages. The agent starts here.
get_design_system The design guide and tokens of one design. The agent reads this before building.
list_sections A design’s sections by category, with their content fields.
get_section One section: content schema, demo content, rendered markup.
fill_section Renders one section with your content, validated against the schema.
compose_page A complete page from sections in order, each with your content.
get_page One of the design’s page recipes with the demo content.
find_images Stock photos by subject and shape for every image slot.
search_library Keyword search across designs and sections.

Prompts that work

Name the design and say where the result should go:

  • “Build a homepage for Northwind, a branding studio in Lisbon, with the inspiro-agency design. Save it as index.html.”
  • “Make a Services page for a dental clinic in the inspiro-creative design, with a pricing section and an FAQ. Use real stock photos.”
  • “Which WPZOOM design fits a boutique hotel? Show me its sections.”
  • “Rebuild the About page we made yesterday with the same design but a team section instead of the timeline.”

The agent writes the copy in the design’s voice and within each field’s length, so the layout never breaks. To keep later edits on-design, ask the agent to read the design system again before changing a page by hand.

Output formats: HTML, Tailwind, WordPress blocks

  • HTML (default): a complete page with the design’s fonts, CSS and script. Open it in a browser or drop it into any static site.
  • Tailwind: the same sections styled only with default Tailwind v4 utility classes, for projects that already use Tailwind. Ask for “Tailwind” or “as Tailwind utilities”.
  • WordPress blocks: block-editor markup. Ask for “as WordPress blocks”, then paste the result into the editor’s code view (⋮ → Code editor) of a page. Header and footer come from your theme. With the AI Connect connector, the agent can also publish the page as a draft on your paired site.

Images

The agent should not reuse a demo’s photos for your brand. For each photo slot it either uses the images you give it or calls find_images with a subject and the slot’s orientation, and gets back free stock photos (Pexels with a key, Openverse without). Where nothing fits, the server inserts a labelled placeholder that shows the shape of the spot; ask the agent which images are placeholders and replace them with your own.

Fair use and limits

Without a key All Access Pass Inspiro Premium
Designs you can render Inspiro Creative All All Inspiro designs
Section renders a month 100 per IP address 1,000 per key 500 per key
Keys – 1 (5 on unlimited-sites tiers) 1

A section render is one fill_section, get_section (HTML view), get_page or compose_page call; a page counts once. Catalogue, design-system and image calls are free. Counts reset on the 1st of the month; your account’s Design MCP tab shows the current number. The server also limits every caller to 60 requests a minute.

Troubleshooting

  • 401 “Unknown or expired Design MCP key”. The key in your editor is wrong, was regenerated, or the plan behind it expired. Open the Design MCP tab, copy or regenerate the key and update the editor (Connect your editor).
  • “Rendering the … design needs a Design MCP key”. The request carried no key, or the design is not in your plan (Inspiro Premium covers the Inspiro designs). Check that the editor sends the Authorization header.
  • “Fair use reached”. This key used its section renders for the month. Counts reset on the 1st; team tiers can issue another key.
  • “The key service is unreachable”. The server could not confirm your key with wpzoom.com. Keys already confirmed keep working for an hour; try again in a minute.
  • The agent ignores the design. Ask it to call get_design_system first and to build with compose_page instead of writing markup itself.

What’s Next?

Last updated on October 29, 2026