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 --scope user --transport http showoff https://showoff.dev/mcp --header "Authorization: Bearer <API_KEY>"

What the AI can do#

ToolWhat for
list_templates, list_compositionsBrowse templates and proven arrangements.
create_projectCreate a project with devices, arrangement and screenshots in one step.
upload_mediaUpload screenshots by address.
get_upload_linkUpload screenshots, screen recordings and music from your own disk through a link, without going through the chat.
edit_sceneChange devices, camera, background, text and motion, and lift, magnify or redact a spot.
edit_scene with set_highlightLift a spot, put it under a loupe or redact it. snap (on by default) fits the rectangle to the element underneath and measures its rounded corners, radius sets them yourself, lens.zoom sets how much the loupe magnifies, from 1.2 to 4.
edit_scene with set_store_setBuild an App Store set with devices and headlines per image and texts in several languages. Every device gets a layout that fills its image. export_image delivers the set as a ZIP, for the App Store and Google Play, on request in the folders for fastlane.
edit_scene with auto_cutCut the pauses out of a screen recording and let the camera follow the action.
render_previewLook at a quick preview of the picture and check it critically.
edit_scene with match_imageRebuild the layout of a picture exactly, camera and perspective included.
export_imageRender the finished image and hand it over as a file with a link, without going through the editor.
review_scene, finishRun the art-direction review and hand over the finished project.
duplicate_project, folderCopy a project as a variant, such as the same launch video to another song, and file projects into folders (folder on create_project, create_launch_video, update_launch_video and edit_scene, two levels at most).
list_projects, list_foldersFind projects by name, folder or kind (query, folder, kind, offset) and list the folders with how many projects each holds.
list_versions, restore_versionSee the history of a project and bring back an earlier version. It becomes the new current version, and the one before stays in the history.
delete_projectDelete a single project, only when you explicitly ask for it and with its exact name as confirmation.
create_launch_video, update_launch_video, get_launch_videoA launch video, vertical or landscape, composed freely from blocks (hero, feature, MacBook, a chat with Claude, duo, end card) and cut to your song, or a short teaser without an end card. Tempo, beat and drop are detected, then the video renders in your browser. update_launch_video also changes a single block (block), and get_launch_video lists a ready command to replace every screenshot and the song.

Note

If the project is open in the editor, you watch the AI work live, in the project overview too. Every AI session becomes a version in the history that you can bring back. You export the result like any other project in the editor.

What it costs#

MCP is part of Pro. On Free, your AI can work for 3 days, counted from its first request. After that it answers every request with a link to your organization's billing, where whoever manages the organization switches to Pro. You can connect any AI without Pro, and whatever it built stays in your projects.

If the AI exports an image, it counts just like in the editor. On Pro it exports in full quality right away, without limit. On Free it uses the one full-quality export of the month while it is still available, and otherwise exports in 720p. More under Plans and billing.

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.