apply_library_field_type_upgrade
ChatGPTUse this when a library field-contract upgrade preview has been reviewed and the user explicitly approved applying it. It re-plans against baseRevision and atomically applies every safe type upgrade and displayed legacy-default repair while preserving valid values and references.
archive_library
ChatGPTUse this when the user explicitly asks to archive a TokenLab library. Do not use for permanent deletion; public MCP only archives libraries.
archive_project
ChatGPTUse this when the user explicitly asks to archive a TokenLab project. Do not use for permanent deletion; public MCP only archives projects.
check_design_graph
ChatGPTUse this when the user wants readiness findings for a Design Graph draft, release, or candidate workspace release before relying on it.
create_branch
ChatGPTUse this when the user explicitly asks to create a branch, or after an explicit branch-scoped write request when no suitable branch exists. Do not create a branch for a read-only or ambiguous request.
create_library
ChatGPTUse this when the user explicitly asks to create a new TokenLab library inside a project.
create_mode
ChatGPTUse this when the user explicitly asks to create a mode in a branch collection.
create_project
ChatGPTUse this when the user explicitly asks to create a new TokenLab project in a workspace.
delete_branch
ChatGPTUse this when the user explicitly asks to delete a TokenLab branch. Deleting the branch discards its unmerged work; governance blocks deletion while an open review exists.
delete_mode
ChatGPTUse this when the user explicitly asks to delete a mode from a branch collection. The operation removes that mode and its token values subject to collection runtime guards.
delete_token
ChatGPTUse this when the user explicitly asks to delete one token from a branch collection.
delete_tokens
ChatGPTUse this when the user explicitly asks to delete the specified tokens from a branch collection. The tokens and their mode values are removed from the branch draft.
get_branch_snapshot
ChatGPTUse this when the user needs the token snapshot and revision for one accessible TokenLab branch.
get_design_context
ChatGPTUse this when the user wants AI-ready guidance for a task from a released or pinned Design Graph context pack.
get_design_graph
ChatGPTUse this when the user explicitly needs the full draft Design Graph payload rather than compact implementation guidance.
get_library
ChatGPTUse this when the user needs metadata for one accessible TokenLab library.
get_library_snapshot
ChatGPTUse this when the user needs the main token snapshot and revision for one accessible TokenLab library.
get_review_request
ChatGPTUse this when the user needs one review request for an accessible TokenLab library. The response includes rejectedByName as the display name and rejectedBy as the internal actor ID.
get_token
ChatGPTUse this when the user needs one token detail and selected mode or Collection Variant value from main or a branch snapshot. variantId returns the effective inherited value layer; omit it for Base. Supports aliasStrategy (resolve, preserve-native, preserve-reference) and colorFormat (source, hex, rgb, hsl, oklch). MCP defaults to preserve-native aliases so alias previews are human-readable token references.
list_branches
ChatGPTUse this when the user needs branches for one accessible TokenLab library.
list_collections
ChatGPTUse this when the user needs collections from main or from a branch snapshot.
list_design_graphs
ChatGPTUse this when the user needs the available workspace or project Design Graph and release metadata before resolving AI context.
list_groups
ChatGPTUse this when the user needs groups in one collection from main or from a branch snapshot.
list_libraries
ChatGPTUse this when the user needs TokenLab libraries by workspace or by project. Provide exactly one selector.
list_library_releases
ChatGPTUse this when the user needs immutable releases before creating a cross-library alias. Draft targets are intentionally unavailable.
list_modes
ChatGPTUse this when the user needs modes in one collection from main or from a branch snapshot.
list_projects
ChatGPTUse this when the user needs projects inside one accessible TokenLab workspace.
list_release_alias_targets
ChatGPTUse this when the user has selected an immutable library release and needs authorized alias targets. Returns primitive, composite-property, and whole-composite targets with modes, effective variant previews, one contextual targetKey per target, and explicit fixed-mode selectors in targetKeysByMode. Returned identifiers, values, revisions, units, and release pins are authoritative.
list_review_requests
ChatGPTUse this when the user needs review requests for one accessible TokenLab library. The response includes rejectedByName as the display name and rejectedBy as the internal actor ID.
list_variants
ChatGPTUse this when the user needs the named value layers in one collection from main or a branch snapshot. Base is virtual and is therefore not returned as a variant. The response includes sourceVariantId inheritance and the number of sparse field overrides.
list_workspaces
ChatGPTUse this when the user needs to see which TokenLab workspaces this connection can access.
move_tokens
ChatGPTUse this when the user explicitly asks to move existing tokens into a group, to the collection root, or to another collection on a branch. For group assignment use action moveWithinCollection with collectionId, tokenIds, and targetGroupId. The whole token list is committed atomically as one revision; use the returned revision as the next baseRevision.
mutate_collection
ChatGPTUse this when the user explicitly asks to create, rename, update, or delete a collection on a branch. Before delete, inspect the collection and confirm that the request covers removal of its groups, modes, and tokens from the branch draft.
mutate_group
ChatGPTUse this when the user explicitly asks to create, rename, update, move, reorder, or delete a group on a branch. Create and update support group type, deprecation plus reason, extendsGroupId, and namespaced extensions. A group name is one segment: spaces are allowed, but "/" is reserved for hierarchy and must be represented with parentId. For a top-level create, omit parentId or send null; for a move to top level, omit targetGroupId or send null. Never use a collection ID or invent a root sentinel. For delete, choose the requested strategy explicitly.
mutate_token_variant
ChatGPTUse this when the user explicitly asks to set or reset one sparse token value on a named Collection Variant. Actions are setValue, setAlias, setExpression, and reset. Omit fieldKey for a primitive $value; provide a Base composite field key for composite tokens. reset removes the override and restores inheritance. Expressions use $[token-id] references and color functions lighten, darken, adjustLightness, adjustChroma, shiftHue, mix, and alpha. Cross-library aliases require an exact immutable release selector.
mutate_variant
ChatGPTUse this when the user explicitly asks to create, update, reorder, or delete a named Collection Variant on a branch. Base is virtual and cannot be mutated. sourceVariantId creates a bounded inheritance chain; null inherits directly from Base. Use the returned revision for the next write.
preview_design_artifact
ChatGPTUse this when the user wants the generated DESIGN.md preview for the current Design Graph draft.
preview_library_field_type_upgrade
ChatGPTUse this when you need to preview library field-contract upgrades before applying them. It reports safe semantic field-type changes, repairs for invalid legacy placeholders including empty values excluded by current policy choices, and conflicts without mutating the branch.
rename_mode
ChatGPTUse this when the user explicitly asks to rename a mode in a branch collection.
search_tokens
ChatGPTUse this when the user needs to find tokens by query, type, collection, group, mode, or Collection Variant in main or a branch snapshot. variantId requires collectionId and returns the effective inherited value layer; omit it for Base. Supports aliasStrategy (resolve, preserve-native, preserve-reference) and colorFormat (source, hex, rgb, hsl, oklch). MCP defaults to preserve-native aliases so alias previews are human-readable token references.
set_default_mode
ChatGPTUse this when the user explicitly asks to set the default mode in a branch collection.
submit_review_request
ChatGPTUse this when the user explicitly asks to submit a branch for human review against main.
update_library
ChatGPTUse this when the user explicitly asks to update a library name, description, tags, or IR extensions.
update_mode
ChatGPTUse this when the user explicitly asks to update a branch mode description or namespaced extensions.
upsert_tokens
ChatGPTUse this when the user explicitly asks to create one atomic token batch or update exactly one property of one existing token on a branch. Each call supports either a create batch or a one-property update. Token names are leaf names: spaces are allowed, but "/" is reserved for hierarchy; groupId identifies the destination. Expressions use $[token-id] references and support arithmetic for number, dimension, and duration tokens; color expressions additionally support lighten, darken, adjustLightness, adjustChroma, shiftHue, mix, and alpha. Same-library aliases follow reference context; cross-library aliases are release-only and require exact immutable release selectors. The server re-authorizes and canonicalizes values, aliases, pins, and category units.
