add_to_shelf
ChatGPTAdmin only. Puts one of YOUR published apps on a shelf so every user sees it under Featured. An app can be on several shelves. The optional section groups apps by subject inside the shelf (e.g. 'Biochemistry'). Calling it again for the same app updates its section/position. The app disappears from the shelf automatically if it is later made private or suspended.
create_app
ChatGPTCreates a new free, non-commercial app draft (with a starter index.html) in the user's Koi Launch hub and returns its appId. Storefronts, sales, subscription offers and checkout, including placeholder or external-checkout versions, are not supported. Personal subscription trackers remain supported.
create_shelf
ChatGPTAdmin only. Creates a curated shelf that appears in everyone's hub under Featured once it holds at least one published, non-private app.
delete_app
ChatGPTPermanently deletes an app, all its versions and its users' data. Its link stops working. Requires the app's exact name as confirmation.
delete_file
ChatGPTDeletes a file from the app draft.
edit_file
ChatGPTReplaces an exact snippet in a draft text file (old_text must match exactly once unless replace_all).
get_account
ChatGPTReturns the account this MCP connection actually authorizes, including its own linked sign-in emails. Switching accounts on the Web does not change an existing MCP connection. No tokens, app data or other accounts are returned.
get_ai_guide
ChatGPTChecks whether this account can build apps with AI inside (Koi Launch Go with AI turned on), and returns only maker instructions and approved capability metadata. No user inputs, results or usage history.
get_app
ChatGPTShows app details and renders the opening buttons for a published app without publishing a new version.
get_app_icon
ChatGPTShows the app's current icon: the emoji only, or the SVG an assistant designed, with its source so you can edit it and pass it back to set_app_icon.
get_check_result
ChatGPTThe latest automated check result for the app: each check's expected and actual behaviour, and whether the result still matches the current draft.
get_image_import
ChatGPTReturns this connected account’s image-import results and verified draft paths. Call after the person selects photos or after binary uploads. Reports removed files as incomplete. Does not publish, run AI or return upload credentials.
get_platform_guide
ChatGPTReturns the runtime rules, a scope check (what works as-is, what needs a fallback such as live data, and what has no equivalent yet, with the closest alternative for each), the SDK (TgApp storage/shared/haptics/share), CSP, design checklist and templates for Koi Launch apps.
get_preview_report
ChatGPTWhat happened the last time the draft ran in the in-chat preview: whether it started, runtime errors (with lines), layout problems (sideways scrolling, too-wide elements, tiny tap targets, broken images) and the text and buttons on screen.
import_asset
ChatGPTDownloads one file from a public https URL (image, audio, font, JSON… ≤ 5 MB) into the app draft.
import_assets
ChatGPTDownloads up to 20 public https files (images, audio, JSON… ≤ 5 MB each) into the app draft in one call, e.g. one micrograph per quiz question. Costs no tokens for the file data.
import_images
ChatGPTImport the user’s attached PNG/JPEG directly, without base64. Omit files to open an image/file picker supported in ChatGPT and Claude; it resizes phone photos on the device and can extract PDF pages and PowerPoint pictures. In a code sandbox with real file and network access, use uploadRequest for direct binary transfer instead. Creates content-addressed image files in this owned app draft; does not publish or replace existing files. Use text detail for readable slides, photo for photos, auto otherwise. Imported images become accessible to people allowed to open the app after publication. Never ask for public URLs, print base64, or substitute a different picture for an inaccessible attachment.
list_apps
ChatGPTLists the user's apps with appId, publish status, version, visibility and the available Web/Telegram destinations.
list_shelves
ChatGPTAdmin only. Lists the curated shelves shown in everyone's hub under Featured (for example 'CAU 1st year'), with their slugs, status, app counts and share links.
preview_app
ChatGPTShows the current draft running inside the chat (same runtime as Telegram; separate preview storage) and reports problems that would block publishing. The running preview records whether it started, runtime errors, layout problems and the text on screen.
publish_app
ChatGPTValidates and publishes a new free, non-commercial app version, then renders the opening buttons in the chat. Web-only users get Web; Telegram-linked users get both. Storefronts, sales, subscription offers and checkout flows, including disabled or external-checkout placeholders, are not supported.
read_file
ChatGPTReturns the current text of a draft file (optionally a line range).
remove_from_shelf
ChatGPTAdmin only. Takes an app off a shelf. The app itself stays published and keeps working for anyone with its link.
rollback
ChatGPTMakes an earlier published version live again and restores it into the draft.
run_checks
ChatGPTChecks the app's current draft in a real browser: static checks, startup on a phone-size screen, and the saved acceptance scenarios with real input. Returns a job id; a result usually takes under a minute. Each person has a daily number of checks.
run_in_app
ChatGPTOpens the app's current draft in a fresh, isolated test copy (empty storage; nothing is saved to the real app or its data) in a real browser, runs JavaScript once inside the app page, and returns what it returned, console output, uncaught errors, blocked requests and a text layout report of the screen afterwards. The code is the body of an async function. Limits: 4000 characters of code, 5 s of awaited work, 8 s in total, and a daily number of runs per person.
save_scenarios
ChatGPTStores the expected behaviour of an app as acceptance scenarios with real input steps (tap, drag, type, key, wait, expectText, expectVisible and more). Automated checks run them against the current draft on a real browser. Stored outside the app's files. A failing scenario is reported; it does not stop publishing.
set_app_icon
ChatGPTSets or replaces the app icon from an SVG you design OR a generated/user-provided PNG/JPEG. Replacing an icon permanently deletes its previous stored image and SVG source; reset: true removes the image and returns to the emoji tile. Previous icon revisions cannot be restored through this tool. Icons are publicly retrievable, including for private apps: never include private data. Call this right after create_app for every new app, without being asked, and before publish_app. Use image_path for an existing file in THIS app draft, or image_base64 for a small image file you can access. For an image-generation result, obtain its actual file bytes; never invent a URL or claim an unavailable file was uploaded. If that file cannot be accessed, design an SVG instead. Keep transfers small: resize raster images to a square 512 × 512, preferably under 100 KB, at most 1 MB and 4 megapixels. No original raster is retained; the server crops centrally, strips metadata and saves resized PNGs. Do not recreate an existing icon on unrelated edits. Design rules: square viewBox (viewBox="0 0 512 512"); a full-bleed background (a rect or gradient covering the whole square, no transparent corners); one bold, simple symbol of what the app does, readable at 48 px and kept inside the central 80 % circle (launchers crop the edges); 2–4 colours with strong contrast; flat shapes or gradients. NOT allowed (the call fails): <text>, letters or emoji glyphs (no fonts are available), <image>, scripts, external links or url() other than url(#id), filters/blur/shadows, more than 32 KB. Also pass emoji: one emoji matching the icon, used where only text fits (Telegram messages). The result includes the rendered icon so you can check it; show the person and offer to change it.
set_visibility
ChatGPTprivate = only the owner can open it; link = anyone with the link (default); public = also listed in the future public gallery.
update_app_info
ChatGPTChanges the app's display name, description or emoji icon (takes effect immediately in the hub).
update_shelf
ChatGPTAdmin only. Renames a shelf, changes its order, hides/shows it, or sets/clears its end date. Only the fields you pass are changed.
validate_ai_app
ChatGPTValidates this app's AI manifest and approved model references without running AI. Available to accounts that can build AI apps (Koi Launch Go with AI turned on).
write_file
ChatGPTCreates or overwrites one file in the app draft. Text files: split the app into several files and keep each call under ~30 KB. Binary files such as images: set encoding to 'base64' and send the data in chunks of at most 40,000 base64 characters (each chunk a multiple of 4 characters): the first call with append false, the rest with append true. Shrink images before sending (<= 1200 px, WebP/JPEG about 70% quality, usually 50-150 KB). Paths are relative (index.html, app.js, images/epithelium.webp).