Building mockups with an AI (MCP)

MCP (Model Context Protocol) is the standard AI programs use to work with tools. Connect Showoff to your AI and it can browse the templates, create projects, upload screenshots and put them on the screens, set background and text and look at a preview, all inside your organization.

The AI does not work unchecked. Every change first passes the art-direction review, which looks for devices touching, unnatural angles, text over a device, cropped screenshots, doubled status bars and weak contrast. A change that introduces an error is not saved, and the AI gets the fix along with the rejection.

Setting it up#

  1. Add the server address to your AI. That is all it needs, no key.
  2. The first time it connects, your browser opens. Sign in to Showoff there, pick the organization and approve.
  3. Ask your AI for a mockup, for example “Build me an App Store image with two iPhones and this screenshot.”
https://showoff.dev/mcp

The server address

Clients#

In Claude or Claude Desktop, open the settings, add a custom connector under Connectors, paste the address and click Connect.

Without a browser, using an API key#

For scripts, CI or clients without browser sign-in there are API keys. Create them in the MCP section of the settings, each one is shown exactly once. The key goes along as a header or, if a client only takes an address, as the last part of the address.

claude mcp add --transport http showoff https://showoff.dev/mcp --header "Authorization: Bearer <API_KEY>"

What the AI can do#

Tool What for
list_templates, list_compositions Browse templates and proven arrangements.
create_project Create a project with devices, arrangement and screenshots in one step.
upload_media Upload screenshots by address.
get_upload_link Upload screenshots from your own disk through a link, without going through the chat.
edit_scene Change devices, camera, background, text and motion.
render_preview Look at a quick preview of the picture and check it critically.
edit_scene with match_image Rebuild the layout of a picture exactly, camera and perspective included.
export_image Render the finished image and hand it over as a file with a link, without going through the editor.
review_scene, finish Run the art-direction review and hand over the finished project.
create_launch_video, update_launch_video, get_launch_video A vertical launch video, composed freely from blocks (hero, feature, MacBook, a chat with Claude, duo, end card) and cut to your song. Tempo, beat and drop are detected, then the video renders in your browser.

Note

If the project is open in the editor, you watch the AI work live. You export the result like any other project in the editor.

Security#

A connection works for you in one organization and cannot do anything you could not do there yourself. The MCP section of the settings lists every connected app, and disconnecting one takes effect immediately. Leaving an organization also ends the AI’s access there.

Heads up

Only approve in the browser if you just started the connection yourself. An API key works like a password, so do not share it or put it in a public repository.