Settings & projects
Setting profiles and project lifecycle: create and switch projects, store and remove settings, and save project metadata and module manifests.
These tools live in the on-demand catalog rather than the default tool list, keeping the connected client's context small. Discover them with search_tools (e.g. search_tools(queries: ["settings"])) and run them with execute_tools — or call them directly if your client has already loaded them.
Save Setting
save_setting
via execute_tools
Create or update a setting profile. Data is merged with existing values. Access via config('name.key') in code.
Parameters
-
- Name
name- Type
- string
- Required
- required
- Description
-
Setting profile name (e.g., "app", "vote", "features")
-
- Name
data- Type
- object
- Required
- required
- Description
-
Key-value pairs for the setting (e.g., { "salt": "secret", "enabled": true })
Get Setting
get_setting
read-only
via execute_tools
Get a setting profile by name. Returns key-value pairs accessible via config() in code.
Parameters
-
- Name
name- Type
- string
- Required
- required
- Description
-
Setting profile name (e.g., "app", "database", "mail", or custom names like "vote")
Delete Setting
delete_setting
via execute_tools
Delete a setting profile from the tenant's settings table.
WARNING: This permanently removes the entire setting profile and all its values. This cannot be undone.
EXAMPLE: { "name": "vote" }
This removes the "vote" setting profile entirely.
Parameters
-
- Name
name- Type
- string
- Required
- required
- Description
-
Setting profile name to delete
Save Project Meta
save_project_meta
via execute_tools
Set the ACTIVE project's App Store card metadata — its display name and description. These are what the Constellation store card renders, so set them whenever a project is built for (or headed to) the store. Owner-only. Does NOT publish the project (listing stays a manual review) and cannot touch is_public or card images.
Parameters
-
- Name
name- Type
- string
- Description
-
Project display name (e.g., "Semantic Search"). Shown as the card title.
-
- Name
description- Type
- string
- Description
-
Card blurb shown under the title. One or two selling sentences.
Save Module
save_module
via execute_tools
Set a project module's name and/or description. Modules are the named groups files/routes are organised into (created via the 'module' param on create_file/create_route); the description documents what the module provides for anyone browsing or reusing it.
Parameters
-
- Name
module- Type
- string
- Required
- required
- Description
-
Module UUID or kebab-case name (e.g., "ai-chat").
-
- Name
name- Type
- string
- Description
-
New module name (kebab-cased server-side).
-
- Name
description- Type
- string
- Description
-
What this module provides.
Create Project
create_project
via execute_tools
Create a fresh, empty project for the user and make it their ACTIVE project. Use when starting work that belongs in its own project (e.g. a new Constellation module) instead of building inside the currently open one. The current project is untouched — the active pointer is simply repointed. Owner-only and requires a paid plan (or a debug environment). Scaffolds the same starters as the UI: owner permission, app/database settings, a "/" homepage route and the routes directory.
Parameters
-
- Name
name- Type
- string
- Description
-
Project display name (e.g., "Metrics Dashboard"). Defaults to "New project".
Set Active Project
set_active_project
via execute_tools
Switch the user's ACTIVE project to another project they own or have been assigned to. All other tools operate on the active project, so use this to move between projects (e.g. back to a module project to rename or extend it). Fails with 403 for projects the user has no access to.
Parameters
-
- Name
uuid- Type
- string
- Required
- required
- Description
-
UUID of the target project.