Kittl

Checks the status of an image-vectorization job by ID. Non-terminal responses include checkAgainInSeconds, the suggested delay before the next manual check. Completed results include an editUrl that continues the SVG in Kittl's AI Creations Quick Edit.

kittl-get-image-vectorization-status

Checks the status of a media generation by ID. Non-terminal responses include checkAgainInSeconds, the suggested delay before the next manual check.

kittl-get-media-generation-status

Returns the user's available Kittl token balance for a workspace. Use this when the user asks about tokens, balance, or remaining generation allowance.

kittl-get-token-balance

Browse the current catalog of published Kittl AI workflow presets - curated multi-step generation recipes. Natural-language `search` is relevance-ranked; use a concise, deliverable-focused query and treat results as candidates until inspected. Without search, results default to popularity and may under-represent smaller categories; sortBy and sortDirection are ignored during search. kittl-list-ai-workflow-use-cases returns category IDs for filtering. kittl-get-ai-workflow-preset returns a selected preset's inputs and workspace-scoped base cost estimate before it is run. Direct image transformations use the dedicated image tools; raw or model-specific generation, or requests with no clear preset fit, use kittl-generate-media.

kittl-list-ai-workflow-presets

List the Kittl AI workflow use-case taxonomy (e.g. "Merchandise", "Marketing") as a hierarchy of parent/sub use cases. Use the returned numeric IDs as the useCaseIds filter for kittl-list-ai-workflow-presets.

kittl-list-ai-workflow-use-cases

List Brand Kits for a Kittl team (workspace): id, name, status, visualStyleStatus, and hasVisualStyle (workflow brand-selector gate). New kits come from kittl-create-brand-kit-from-url when the brand has a website. Same id: when hasVisualStyle is true, pass under the brand-selector field key from kittl-get-ai-workflow-preset (brandSelectorFields — not always named brandId) on kittl-run-ai-workflow; or call kittl-get-brand-kit for brandContext (prompt composition) and optional referenceImages uploadIds for kittl-generate-media. FAILED kits are omitted — use kittl-get-brand-kit to read a failed create-from-url error. Optional deeper playbook: kittl-get-ai-generation-guidance.

kittl-list-brand-kits

Use this only when the user wants to browse Kittl's image-style categories or no useful visual-style search term is available. Otherwise call kittl-list-image-styles directly with a short style-name search. Returns compact category names and eligible style counts; pass a returned name as the exact, case-insensitive group filter on kittl-list-image-styles. Never invent group names.

kittl-list-image-style-groups

Use this when the user wants to list or find one of Kittl's curated image-generation styles, such as watercolor, anime, clipart, or vector art — including for a reference-image remix. Search directly when the user provides a visual-style term. List style groups first via kittl-list-image-style-groups only when the user wants to browse categories or no useful style term is available. Search matches a literal style-name substring, so use a short visual-style term rather than the user's full request; filter by that search and/or exact group (at least one required). Returns compact paginated candidates with model, reference-image, health, background, type, and paid-plan metadata. Names are not unique, so never invent ids or silently select among multiple matches. Pass the chosen id as promptStyleId to kittl-generate-media with type image. For remix, use the row modelId only when it supports reference images and its health permits; otherwise choose an I2I model through kittl-list-media-generation-models.

kittl-list-image-styles

Fetch available AI models from Kittl's AI generator. Returns image and/or video models (optionally filtered to one via `typeFilter`) with their capabilities, baseTokenCostEstimate (a rate — for many video models it is per second, not per run), speeds, and recommended use cases. Pass the same workspaceId you will use with kittl-generate-media so listed rates match what that workspace will be charged. The tokens actually charged come back as creditCost from kittl-generate-media. Each model's Parameters line includes referenceImages bounds (e.g. maximum N) when choosing how many uploadIds or image URLs to pass.

kittl-list-media-generation-models

Lists the current user's Kittl AI workflow sessions for a team, ordered by most recent activity, newest first, so the first card is the latest session. Each card opens the session grid via kittl-get-ai-workflow-session-status. For a pasted studio URL with ?session=, use kittl-show-ai-workflow-session instead. Results render in Kittl's Media Result View widget. The widget offers Previous/Next when more pages exist; you can also paginate with take/skip when the user asks for more (e.g. take=2 for the two newest sessions).

kittl-list-ai-workflow-sessions

Lists images from a Kittl workspace library and renders them in Kittl's Media Result View widget. Required source chooses exactly one library: 'uploads' (non-AI images) or 'ai-creations' (completed IMAGE generations, including ones moved into a user folder) — both cannot be listed in one call; if the user does not say which, ask before calling. Optional folderId applies equally to both sources ('all' default, 'root', or an id from kittl-list-upload-folders). A complete mixed folder view needs two calls with the same folderId. Results are ordered newest-first by createdAt; each image includes createdAt (ISO) for grouping or filing by date. Pass take for "latest N" (e.g. take=2). Each image's uploadId is a reusable image ID — Media Result View "Use in chat" sends it as selectedImageObjectId; pass uploadId directly to compatible raw-generation or workflow image inputs (MIME/size/dimension checks can still reject it). Each image includes an editUrl that continues it in Kittl's AI Creations Quick Edit. The widget offers Previous/Next when more pages exist; you can also paginate by calling again with the returned meta.pagination.nextCursor as cursor when hasMore is true.

kittl-list-library-images

Get Kittl projects for the current user - returns an object with a "projects" array and "meta" (pagination + filter params). Each project has an ID, name, url (the direct url to the Kittl editor for this project), thumbnailUrl which should be used to render a preview of the project, createdAt, and updatedAt (last edited timestamp). Supports search, sorting, pagination, and folder filtering. Defaults to every project in the team (folderId all). Results render as an interactive project list in the chat UI.

kittl-list-projects

Get Kittl teams (workspaces) for the current user, with each team's ID and name, and the default team ID.

kittl-list-teams

List project folders in a Kittl team. Returns folders with id, name, projectCount, createdAt, lastUpdatedAt, and optional thumbnailUrl. Each folder id is what kittl-list-projects takes as folderId and what kittl-move-project-to-folder takes as folderId. Project folders are a different tree from upload/library folders (kittl-list-upload-folders).

kittl-list-project-folders

List upload/library folders in a Kittl team. Returns folders with id, name, uploadCount, createdAt, lastUpdatedAt, optional sizeMb (index only), and optional thumbnailUrl. uploadCount is the unfiltered total of every upload in that folder and may exceed the kittl-list-library-images result for the same folder (source is exclusive and image-only). Each folder id is what kittl-list-library-images, kittl-save-image-to-library, and kittl-move-library-images-to-folder take as folderId. Upload folders are a different tree from project folders (kittl-list-project-folders).

kittl-list-upload-folders

Move one or more persisted library images into an upload folder. uploadIds come from kittl-list-library-images (either source) or kittl-save-image-to-library; folderId comes from kittl-list-upload-folders. Temporary objectIds from kittl-upload-image must be saved first. Unknown ids are skipped; the API returns 404 only when none match. Not for projects (kittl-move-project-to-folder).

kittl-move-library-images-to-folder

Move one or more projects to a specific project folder in Kittl. folderId comes from kittl-list-project-folders. Not for library images (kittl-move-library-images-to-folder).

kittl-move-project-to-folder

Shows an interactive upload widget for the user to provide an image directly. Use this when kittl-upload-image can't work - no reachable URL and no local file to PUT (e.g. an image attached inline in chat). The objectId is not returned by this call: once the user finishes the upload in the widget, it arrives as an update to your context - wait for that before using it.

kittl-open-image-uploader

Receives base64-encoded image bytes from the upload widget and stores them as a Kittl upload object. Not for direct use - only the upload widget calls this.

kittl-receive-image-bytes

Removes an image's background and renders the transparent result in Kittl's Media Result View widget. Defaults to 'standard' (Fast), which costs 0 tokens. 'enhanced' (Detailed) produces higher-quality cutouts but may cost tokens and may require a paid plan. Completed results include an editUrl that continues the image in Kittl's AI Creations Quick Edit. For generation-tool routing guidance see kittl-get-ai-generation-guidance.

kittl-remove-image-background

Starts a Kittl AI workflow run from a preset (may consume credits). kittl-get-ai-workflow-preset returns the preset's required fields, for building a complete submittedValues up front; missing fields are elicited from the user or returned for retry. Once started, kittl-show-ai-workflow-run renders the result(s) in Kittl's Media Result View widget. To iterate later (either is fine): pass the returned sessionId with this same presetId and updated submittedValues, or open the returned workflowUrl for studio Quick Edit.

kittl-run-ai-workflow

Promote a temporary upload object ID (from kittl-upload-image or the image uploader) into a permanent library Upload. Optional folderId from kittl-list-upload-folders places it in that upload folder; omit or 'root' saves unfiled. Returns uploadId reusable for workflow/generation image inputs. Does not create folders (kittl-create-upload-folder).

kittl-save-image-to-library

Shows a Kittl AI workflow run's progress and renders the result(s) in Kittl's Media Result View widget. Call once, right after kittl-run-ai-workflow succeeds. Result includes workflowUrl (studio) plus sessionId/presetId for same-session follow-ups.

kittl-show-ai-workflow-run

Shows a Kittl AI workflow session's merged outputs (including later MCP re-runs and studio Quick Edit / regenerate runs) in Kittl's Media Result View widget. Use when the user pastes a studio URL with ?session=, or to refresh after iterating in-session via kittl-run-ai-workflow or studio. kittl-get-ai-workflow-session-status is the plain poll twin while outputs are still generating.

kittl-show-ai-workflow-session

Gets a Kittl upload object ID, for input fields that expect one rather than a raw URL - for example, kittl-run-ai-workflow input fields whose uiSchema presentation is "image-upload". If context or a previous result provides uploadId or selectedImageObjectId, that value is already a reusable image ID; pass that value directly. Otherwise, obtain a Kittl upload object ID for an image: pass imageUrl to kittl-upload-image if you have a public URL for it. Omit imageUrl (agents with filesystem/shell access and no existing public URL) to get a presigned URL back immediately and push the file's bytes yourself. If neither applies (e.g. an image attached inline in chat, with no URL and no local file you can read), call kittl-open-image-uploader instead to let the user upload it directly, then wait for the objectId to arrive in your context before proceeding.

kittl-upload-image

Starts a Kittl image-upscale job (currently does not consume tokens) and renders progress and the final image in Kittl's Media Result View widget. Source image sides must be between 256px and 4096px (some backends cap the source at 3000px). For generation-tool routing guidance see kittl-get-ai-generation-guidance.

kittl-upscale-image

Starts a Kittl vectorization job (currently does not consume tokens) and renders progress and the final SVG in Kittl's Media Result View widget. Source images may be up to 20MB. For generation-tool routing guidance see kittl-get-ai-generation-guidance.

kittl-vectorize-image