Tapercraft — VHS Label Maker

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Compose printable VHS, DVD, cassette, CD and vinyl packaging from any movie, show, or album.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Tapercraft — VHS Label Maker": {
      "url": "https://vhs.texs.org/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (16)

• list_formats read-only

  List the packaging formats that can be composed, with their printed dimensions. Call this first if you are unsure which format the user wants.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• describe_format read-only

  One format in detail: the printed sheet in px and inches at export DPI, every panel (front, spine, back, flaps…) as a rectangle with its pixel size, and which intent sections the format accepts. Call this BEFORE generating artwork for a format so each image is made at the right size and aspect.

  Parameters:

  • format (required) — string — A slug from list_formats

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_decals read-only

  The decal catalog: every sticker, graphic, shape and retro distributor mark the designer offers (a title's own posters / logos / stills come from get_content instead), grouped by category, each with its id (what decals[].id takes), natural pixel size and preview URLs — plus the Classic Logo ids style.productionLogos takes. Call it before placing decals; ids are exact strings, never guessed. Pass a category id to get one category, or a query to search names.

  Parameters:

  • query — string — Case-insensitive match on decal id / name
  • category — string — One category id (e.g. "priceTags", "oldDistributors", "shapes")

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_content read-only

  A movie or TV title's own artwork: every TMDB poster, logo (the wordmark / title art) and backdrop (stills) as a decal id with pixel size and preview URLs, plus title, year, tagline and overview. Place one with decals[].id in the same intent as the content (e.g. the real wordmark under the cover art, a still on the back) — sized by width like any decal. Ids come from search_content.

  Parameters:

  • type (required) — string
  • id (required) — string — TMDB id from search_content

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• search_content read-only

  Look up a movie, TV show, or music album by title and return candidate matches with years. Use when the user's title is ambiguous and you want to confirm which one they mean before composing.

  Parameters:

  • type (required) — string — movie, tv, or album
  • query (required) — string — Title to search for, e.g. "Predator 1987" or "Michael Jackson Thriller"

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• compose_design read-only

  Build a label design and return a URL the user opens to finish it. Designing and previewing are free; exporting a print-ready file requires a membership, so present the URL as a starting point the user completes in their browser. Fields listed in the response as "unsupported" were NOT applied — tell the user rather than reporting them as done. The user's own artwork goes in through `images` (upload it first with upload_image; needs an API key): `images.background` covers the whole sheet, `images.panels.<key>` one panel each (keys from describe_format), `images.logo` a custom studio logo. `decals` places catalog stickers / shapes / retro marks (ids from list_decals) or the user's uploads anywhere on the sheet, `texts` adds free text blocks, `style.productionLogos` picks the studio marks (`style.productionLogoColorize: 'off'` keeps their own colours), and `layout.hide: ["poster"]` clears the cover art — enough to rebuild a specific vintage cover. Without a key, compose from format + content and tell the user to drag images in after opening the URL.

  Parameters:

  • format (required) — string — Which packaging format
  • text — object — Overrides for the fetched metadata (video formats only — on audio formats these come back as unsupported). Omit a field to keep the provider value.
  • style — object
  • texts — array — Free text blocks placed on the label (the designer's Text tab). x/y are the block's center in percent of the sheet; width is the percent of the sheet width the block spans (text wraps); size is the font size as percent of the sheet height.
  • decals — array — Stickers, graphics, shapes and the user's own images placed on the label. Each entry names a catalog decal by id (list_decals) OR an upload by ref (upload_image; needs the API key). x/y are percent of the sheet (center-anchored; see describe_format → placement for the coordinate space and the size units). Size with `width` (percent of the sheet width) where describe_format accepts it, else `scale`.
  • images — object — The user's own artwork by upload ref (from upload_image). Needs the API key that owns the uploads. Single-surface formats only (describe_format → singleSurface). Each value is a ref string or { ref, fit, opacity }.
  • layout — object
  • content — object — What the design is of. Provide a query, or an id from search_content. Video formats take movie/tv; audio formats (cassette, jcard, cd*, vinyl*, minidisc*) take album. For audio, the album alone builds the complete design — cover art, tracklist sides, QR code — and style.font / labelColor / background restyle it.

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• upload_image

  Put an image into the user's Uploads library ("Your Uploads" in every picker) and get back a ref for the images.* fields of compose_design / save_design. Needs an API key with design:write. Send the file as base64 (JPEG/PNG/WebP, at the panel size describe_format reports). SIZE: the request body may not exceed 4.5 MB, so keep the base64 under 3 MB (~2.2 MB of image); a file up to 4 MB goes through POST https://vhs.texs.org/api/v1/uploads as multipart instead — re-encode as JPEG quality 80–85 before either. Identical bytes already in the library return the existing item instead of a copy. The library has a per-plan image count (get_account → uploads); at the ceiling the call answers LIBRARY_IMAGE_LIMIT — call list_uploads and delete_upload to make room.

  Parameters:

  • data (required) — string — Base64 of the image bytes (no data: prefix needed; one is tolerated)
  • mimeType (required) — string — e.g. image/png
  • name — string — A filename or label shown in the library, e.g. "predator-front.png"

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• list_uploads read-only

  The user's Uploads library, newest first: id, upload:<id> ref, name, pixel size, bytes and an hour-long preview url. Needs an API key with read. Use it to reuse an image already uploaded (identical bytes dedupe anyway) or to pick what to delete_upload when upload_image answers LIBRARY_IMAGE_LIMIT.

  Parameters:

  • limit — integer — Default 50

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• delete_upload destructive

  Remove one image from the user's Uploads library by id (from upload_image or list_uploads). Needs an API key with design:write. Saved designs keep their own copies, so this never breaks a design; it only frees a library slot. Prefer deleting images this session uploaded over ones the user added themselves.

  Parameters:

  • uploadId (required) — string — The id (or upload:<id> ref) to remove

  Hints: read-only no · destructive yes · idempotent not declared · open-world no

• save_design

  Save a design straight to the user's dashboard and return its link. Takes the SAME fields as compose_design plus a name; needs an API key with design:write. Use it when the user wants the design kept on their account without opening a link first. Images are copied into the design (safe to delete from the library afterwards). The preview thumbnail and the frozen content snapshot are captured the first time the owner opens and saves it in the browser — say so.

  Parameters:

  • format (required) — string — Which packaging format
  • name — string — Design name shown on the dashboard (max 120 chars)
  • text — object — Overrides for the fetched metadata (video formats only — on audio formats these come back as unsupported). Omit a field to keep the provider value.
  • style — object
  • texts — array — Free text blocks placed on the label (the designer's Text tab). x/y are the block's center in percent of the sheet; width is the percent of the sheet width the block spans (text wraps); size is the font size as percent of the sheet height.
  • decals — array — Stickers, graphics, shapes and the user's own images placed on the label. Each entry names a catalog decal by id (list_decals) OR an upload by ref (upload_image; needs the API key). x/y are percent of the sheet (center-anchored; see describe_format → placement for the coordinate space and the size units). Size with `width` (percent of the sheet width) where describe_format accepts it, else `scale`.
  • images — object — The user's own artwork by upload ref (from upload_image). Needs the API key that owns the uploads. Single-surface formats only (describe_format → singleSurface). Each value is a ref string or { ref, fit, opacity }.
  • layout — object
  • content — object — What the design is of. Provide a query, or an id from search_content. Video formats take movie/tv; audio formats (cassette, jcard, cd*, vinyl*, minidisc*) take album. For audio, the album alone builds the complete design — cover art, tracklist sides, QR code — and style.font / labelColor / background restyle it.

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• list_designs read-only

  The user's saved designs, newest first, with their links. `total` is how many designs match (the user may have hundreds); page on with `offset` = `nextOffset` until it is null. Filter by `format` (a list_formats slug, e.g. 'slipcover', 'vhslabels') or `query` (matches the design name or the movie/album title). Needs an API key with read.

  Parameters:

  • limit — integer — Default 25
  • query — string — Case-insensitive match on the design name or content title
  • format — string — Only designs of this format slug (list_formats)
  • offset — integer — Skip this many (newest first). Use nextOffset from the previous page.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_design read-only

  One saved design by id: name, format, link and its raw design params. Needs an API key with read.

  Parameters:

  • designId (required) — string — From list_designs or save_design

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• delete_design destructive

  Delete one of the user's saved designs (and the image copies it owns). Irreversible — confirm with the user first. Needs an API key with design:write.

  Parameters:

  • designId (required) — string

  Hints: read-only no · destructive yes · idempotent not declared · open-world no

• export_design

  Render a saved design. Queues a job — a headless renderer produces the file in ~15–60 s — and returns a jobId; poll get_export. output 'preview' (every plan) is a downscaled image of the whole sheet that get_export returns INLINE so you can look at it: render one after every save, check the layout, cover art, text sizes and colours against what the user asked for, fix the intent and save again before exporting. 'png' is the Original full-resolution print PNG (600 DPI) and 'pdf' its design-size PDF — members only, and only once the preview looks right. Needs an API key with the export scope.

  Parameters:

  • designId (required) — string — From save_design or list_designs
  • output — string — 'preview' to see the design, 'png' (default) or 'pdf' for the print file

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• get_export read-only

  Status of an export job from export_design. When status is done, `file.url` is a download link valid for an hour; a preview job also returns the image itself. Files are kept for a day, then the job reads `expired`.

  Parameters:

  • jobId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_account read-only

  Who the API key belongs to: membership tier, today's remaining agent quotas, saved-design and upload-library counts. Needs an API key (Authorization: Bearer tc_live_…, created at https://vhs.texs.org/en/dashboard?tab=api-keys). Call it once to confirm the key works before uploading or saving.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.