Space Settings
Space MCP tools in the Space Settings scope (space_settings). Reach these with a wks_live_ key over space-mcp or space-api.
Tools in the space_settings scope, callable over space-mcp (tools/call) or space-api (REST) with a wks_live_* key that grants space_settings.
create_space_snapshot
Scope: space_settings:write
Capture THIS WHOLE SPACE into a snapshot the owner can rebuild as a new space later (create_space_from_snapshot on the account agent, or the Spaces UI). components picks what to include (see preview_space_snapshot); data-bearing components (table_rows, contacts) and campaigns/audiences are included deliberately. Read-only capture — the space is not modified. Returns the snapshot with its typed public_id (snap_space_*).
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | yes | Snapshot name |
description | string | ||
components | string[] | yes | Component keys to include: pages (incl. their websites/landing-page sites — grouping, nav, kind), forms, documents, tables, table_rows, automations, booking_pages, message_templates, cloud_agents, agentic_apps, blog, assets, mail_templates, email_campaigns, sms_campaigns, call_campaigns, audiences, calendar, business_research, tags, contacts. |
selections | object | Optional per-component item id allowlists, e.g. { "pages": ["<id>"] }. Missing key = include everything for that component. |
disable_services
Scope: space_settings:write
Remove Gateway services from this space's allowlist. Removing the LAST assignment returns the space to the platform default where ALL active services are available (stated in the response). Accepts multiple service_keys per call.
| Parameter | Type | Required | Description |
|---|---|---|---|
service_keys | string[] | yes | service_key values (from list_services) to remove from the space's allowlist |
enable_services
Scope: space_settings:write
Assign Gateway services to this space's allowlist. SEMANTICS: a space with no assignments can already use EVERY active service; assigning the first service switches the space to a curated allowlist restricted to exactly what's assigned. Accepts multiple service_keys per call.
| Parameter | Type | Required | Description |
|---|---|---|---|
service_keys | string[] | yes | service_key values from list_services to assign to the space |
get_link
Scope: space_settings:read
Get the canonical CLICKABLE URL for anything you've built or want to point the user at — an item (page, whiteboard, form, booking_page, document, table, blog_post, blog_collection, automation, cloud_agent, app, mail_campaign, sms_campaign, call_campaign, payment_link, listing, hub, meeting, task_project) or a whole surface (space, pages, forms, documents, tables, contacts, automations, blog, mail, phone, calendar, meet, tasks, social, ads, finance, settings, assets, snapshots, space_computer, app_builder, cloud_agents, templates, commerce, business_research, integrations, activity, backstage, dashboard, pm). Returns { url, title, is_public, note }: is_public=true URLs work for anyone; is_public=false URLs open in-app for signed-in members (fine for the owner). When the item isn't live yet (draft page/form), the url opens its editor and note says how to make it public. ALWAYS give the user links as clickable markdown title; prefer url fields already present in tool results, use this tool when a result has none, and NEVER hand-construct wakato.io URLs.
| Parameter | Type | Required | Description |
|---|---|---|---|
kind | string | yes | One of the item or surface kinds listed in the tool description. |
id | string | Item id (uuid) — required for item kinds. Kind 'hub' also accepts the hub slug. | |
username | string | For kind 'profile': the profile username. | |
tab | string | For kind 'backstage': optional tab key. |
get_space_settings
Scope: space_settings:read
Read this space's identity + localization: name, description, timezone, language, and the RESOLVED effective_timezone the space actually uses. Call this to learn the space timezone before scheduling or quoting times.
preview_space_snapshot
Scope: space_settings:read
Preview what a WHOLE-SPACE snapshot of this space would capture: per-component counts and individual items (pages, forms, documents, tables, table_rows, automations, booking_pages, message_templates, cloud_agents, agentic_apps, blog, assets, mail_templates, email_campaigns, sms_campaigns, call_campaigns, audiences, calendar, business_research, tags, contacts).
set_space_settings
Scope: space_settings:write
Update this space's LOCALIZATION only — timezone and/or language (what calendars, schedules, and agents in the space use). Pass an IANA timezone e.g. "America/Chicago", or null to inherit the account default. Cannot change ownership, API keys, or webhooks.
| Parameter | Type | Required | Description |
|---|---|---|---|
timezone | string | IANA timezone, or null to inherit the account default. | |
language | string | BCP-47 language tag, or null to inherit the account default. |