Workspace

Aktiver Datenkontext und externe Zugänge.

API credentials

Endpoints and secrets used outside Sonaloop.

MCP endpoint

HTTP endpoint for MCP-compatible clients.

TypeEndpointScopeAll workspacesStatusStable

EndpointUse this URL in Claude Code, Claude.ai, ChatGPT or another MCP host.

https://api.sonaloop.com/mcp

MCP bearer token

Secret token bound to the active workspace.

TypeSecretScopeWorkspaceStatusUnavailable

Bearer tokenShown as Authorization: Bearer <token> in an MCP host.

<workspace-token>

Catalog token

Secret for premium catalog persona access.

TypeSecretScopePremium catalogStatusUnavailable

TokenUse as SONALOOP_CATALOG_TOKEN=<copied token>.

<catalog-token>

MCP role matrix

Compiled from the live MCP catalog: 293 functions.

Admin293 functions

Full MCP catalog for explicit workspace administration.

Workspace user84 functions

Normal interactive MCP surface for Claude Code and hosted clients.

Automation agent81 functions

Hosted automation runtime surface for server-side agent runs.

Function permissions

Function	Admin293 tools	Workspace user84 tools	Automation agent81 tools
`add_artifact`Bring a REAL artifact into a project's council pool so personas react to what is ACTUALLY ...	allowed	allowed	allowed
`add_task`Insert a task into the plan (shape the breadth): bucket analyze\|act\|verify, a capability ...	allowed	not allowed	not allowed
`add_to_section`Add node ids to a section's membership (validated against the project graph).	allowed	not allowed	not allowed
`aggregate_predictions`The segment roll-up of every predicted behavior in a project — grouped by (action, step, ...	allowed	not allowed	not allowed
`assess_coverage`Coverage / diversity check over a study's PERSONA SET — a deterministic analysis that flags when ...	allowed	not allowed	not allowed
`assess_progress`Record an evidence-backed assessment of progress toward the HMW goal. `delta` is a free ...	allowed	not allowed	not allowed
`assess_project`Project-level meta-assessment (read-only, computed — no LLM verdict): coverage, open evi ...	allowed	allowed	allowed
`attach_asset`Attach a file/image/screenshot to a project as citable evidence. Pass EITHER `path` (a l ...	allowed	not allowed	not allowed
`attach_evidence`Attach a real-world SOURCE (doc/url/note) to a persona to ground its claims.	allowed	allowed	allowed
`attach_prototype_shot`Screenshot a registered prototype (Playwright) and attach the shot to the project as ima ...	allowed	not allowed	not allowed
`attach_survey_evidence`Loop the imported REAL responses back onto a persona as Evidence (source_type='survey') ...	allowed	not allowed	not allowed
`available_project_icons`Existing regular icons that Projects/Jobs can choose at initialization or edit time.	allowed	not allowed	not allowed
`brief_ask`Gather one persona's loaded context (SOUL + recent events + task-keyed memory) so you ca ...	allowed	not allowed	not allowed
`brief_calibration`Gather the MISSES (refuted bets, high-error predictions, each with its evidence trail) s ...	allowed	not allowed	not allowed
`brief_cohort_critic`GATHER compact per-persona records across the cohort so you can judge which personas fal ...	allowed	not allowed	not allowed
`brief_completeness_critic`GATHER a computed exhaustiveness snapshot for an INDEPENDENT critic: coverage + the gene ...	allowed	not allowed	not allowed
`brief_consolidation`GATHER a simulated day + known entities. Returns instructions for you to author memory_d ...	allowed	not allowed	not allowed
`brief_council`Gather a council. A council is scoped to a research project, so `project_id` is REQUIRED ...	allowed	allowed	allowed
`brief_day`GATHER context for planning ONE day (active projects, open threads, recall, world). Retu ...	allowed	not allowed	not allowed
`brief_digest`GATHER a period for a consolidated digest (replaces hardcoded reflections).	allowed	not allowed	not allowed
`brief_eval_critic`GATHER source+SOUL+sampled activities+arcs for a semantic critique. Author a verdict (an ...	allowed	not allowed	not allowed
`brief_evidence_check`GATHER profile claims + attached evidence to validate synthesis against reality.	allowed	not allowed	not allowed
`brief_flow_walkthrough`GATHER one persona's artifact walkthrough: loaded persona context + the ordered screens ...	allowed	not allowed	not allowed
`brief_grounding`Gather the chunks + authoring contract to ground a persona in real material. WITHOUT per ...	allowed	not allowed	not allowed
`brief_head_to_head`Gather a HEAD-TO-HEAD (X vs Y) — run the panel on a DIRECT comparison of two (or more) concrete ...	allowed	allowed	allowed
`brief_hypothesis`GATHER what is worth betting on: the project's contested findings (councils whose statem ...	allowed	allowed	allowed
`brief_month`GATHER context to author a whole month bundle (period plan + sample days + digest), chai ...	allowed	not allowed	not allowed
`brief_next`GATHER what the plan's ready frontier needs now: the primary ready task (+ the full ready ...	allowed	not allowed	not allowed
`brief_period`GATHER context for a week\|month\|quarter\|year plan, incl. candidate sample days. Author a ...	allowed	not allowed	not allowed
`brief_persona`Gather the prompt + frame to AUTHOR one persona profile from a source description. You w ...	allowed	allowed	allowed
`brief_persona_revision`GATHER evidence (digests/facts) to propose SLOW identity drift. Change is the exception.	allowed	not allowed	not allowed
`brief_price_ladder`Gather a PRICE LADDER (pricing Job protocol — willingness-to-pay): a FIXED ascending ladder of ...	allowed	not allowed	not allowed
`brief_prototype_session`GATHER persona context + how-to-drive + anti-steering before a persona uses the app.	allowed	not allowed	not allowed
`brief_red_team`Gather a RED-TEAM (falsification) — run the panel to ATTACK the idea instead of flattering it ...	allowed	allowed	allowed
`brief_survey`GATHER everything needed to author a survey that is answerable against the graph: the pr ...	allowed	allowed	allowed
`brief_synthesis`GATHER an ordered chain of councils (their exec_summaries/votes) so you can author a cro ...	allowed	allowed	allowed
`brief_synthesis_outline`GATHER the whole project graph + study content so you can author the project REPORT outline.	allowed	allowed	allowed
`brief_synthesis_section`GATHER one section's source studies (+ councils) so you can author it with citations.	allowed	allowed	allowed
`brief_usability_session`GATHER persona context (SOUL + state + task-keyed memory) + anti-steering framing + the ...	allowed	not allowed	not allowed
`calibration_report`Measure calibration NOW (mean Brier + hit rate + the reliability curve over scored predi ...	allowed	not allowed	not allowed
`calibration_trend`Calibration quality OVER TIME: the persisted report series, the Brier delta first→last, ...	allowed	not allowed	not allowed
`catalog_pull`Pull catalog personas (by slug and/or archetype `pack`) into the CURRENT store — profile ...	allowed	allowed	allowed
`catalog_recommend`Deterministic, explainable persona-SET recommendation over the catalog (no LLM): spec = ...	allowed	allowed	allowed
`catalog_search`Browse the curated persona catalog (github:jhoetter/sonaloop-data): slugs, names, roles ...	allowed	allowed	allowed
`catalog_status`The `git fetch && git status` of the catalog: for every catalog-pulled persona in the CU ...	allowed	allowed	allowed
`chat_with_persona`Chat with ONE persona, durably. Returns the loaded agent context + prior turns; YOU auth ...	allowed	allowed	allowed
`checkpoint_step`Append a completed step (task_id, bucket, key, evidence ids, 1-line summary) to the journal.	allowed	allowed	allowed
`cloud_add_member`Add (or update) a member: owner \| editor \| viewer.	allowed	not allowed	not allowed
`cloud_archive_design_asset`Archive an asset record without deleting content-addressed bytes.	allowed	not allowed	not allowed
`cloud_close_survey_share`Close/revoke a hosted survey share link. Existing responses stay in the survey graph.	allowed	allowed	allowed
`cloud_configure_automation`Save workspace-specific settings for an automation. Scheduled triggers such as CRON use ...	allowed	allowed	not allowed
`cloud_create_automation`Create or update a structured automation definition. This is the MCP-first natural-langu ...	allowed	allowed	not allowed
`cloud_create_design_system_draft`Validate and persist a draft v2 design-system version without publishing it.	allowed	not allowed	not allowed
`cloud_create_workspace`Create a workspace with its first owner (subject = the user's OIDC `sub`).	allowed	not allowed	not allowed
`cloud_get_automation_run`Fetch one automation run with its append-only event trace. Linked hosted agent runs are ...	allowed	allowed	allowed
`cloud_list_automations`List Cloud automation definitions in the active workspace. Automations are structured DA ...	allowed	allowed	allowed
`cloud_list_design_assets`List assets in the workspace design-system library.	allowed	not allowed	not allowed
`cloud_list_design_system_audit`List governance events for workspace design-system drafts, assets, publishes and exports.	allowed	not allowed	not allowed
`cloud_list_design_system_versions`List the workspace design-system version history.	allowed	not allowed	not allowed
`cloud_list_survey_shares`Every hosted survey share in the active workspace, optionally filtered by survey_id.	allowed	allowed	allowed
`cloud_list_workspaces`Every workspace with its members (row tenancy: a project belongs to a workspace by its w ...	allowed	not allowed	not allowed
`cloud_publish_design_system_version`Publish one draft design-system version and archive the prior published version.	allowed	not allowed	not allowed
`cloud_publish_survey`Publish a core survey as a hosted Cloud share link. Core already owns survey authoring/e ...	allowed	allowed	allowed
`cloud_remove_member`Remove a member (the last owner cannot be removed).	allowed	not allowed	not allowed
`cloud_rollback_design_system_version`Restore an earlier published/archived design-system version for a workspace.	allowed	not allowed	not allowed
`cloud_set_design_system`Set (or clear, with null/{}) and publish the workspace's v2 customer design system. The ...	allowed	not allowed	not allowed
`cloud_set_member_role`Change a member's role (the last owner cannot be demoted).	allowed	not allowed	not allowed
`cloud_start_automation`Start one concrete automation run. The returned run id is the audit handle; inspect it w ...	allowed	allowed	not allowed
`cloud_upload_design_asset`Upload a logo/font/image asset. content_base64 is decoded and validated server-side.	allowed	not allowed	not allowed
`cloud_validate_design_system_version`Return the publish validation report for one design-system version.	allowed	not allowed	not allowed
`cohort_memory_depth`How deep is the cohort's simulated memory (avg facts+events/persona)? A thin cohort should be ...	allowed	not allowed	not allowed
`complete_task`Mark a ready task done. Verify tasks are gate-checked (breadth + gate judgment + artifacts/ ...	allowed	not allowed	not allowed
`create_note`Create a lightweight NOTE node — the ONE note entity (from a raw observation to a worked-out ...	allowed	allowed	allowed
`create_research_project`Create a research Project: a themed GRAPH of studies (syntheses). Distinct from the memo ...	allowed	not allowed	not allowed
`create_section`Create a labeled overlay grouping of graph nodes (e.g. 'Initial user research', 'Problem ...	allowed	not allowed	not allowed
`define_flow`Define an ORDERED flow from the project's screenshot assets — each step is {asset_id, ca ...	allowed	not allowed	not allowed
`delete_artifact`Remove an artifact (by id or label) from a project's pool.	allowed	not allowed	not allowed
`delete_council`Delete a council session.	allowed	not allowed	not allowed
`delete_note`Delete a note node from the project.	allowed	not allowed	not allowed
`delete_persona`Delete a persona + all its persona-scoped rows and rendered SOUL/avatar files.	allowed	allowed	allowed
`delete_prototype`Delete a prototype artifact record (files on disk are kept).	allowed	not allowed	not allowed
`delete_research_project`Delete a project container + its edges/open-questions. Syntheses (incl. reports) are kept.	allowed	not allowed	not allowed
`delete_section`Delete a section. Member nodes are kept (reference, not containment).	allowed	not allowed	not allowed
`delete_synthesis`Delete a synthesis (study) and detach it from any project graphs.	allowed	not allowed	not allowed
`derive_sections`Auto-organize: derive persisted SECTION overlays from the plan — one per methodology phase ...	allowed	not allowed	not allowed
`describe_framework`One Framework's plain-language description by stable id (e.g. 'double_diamond'): {id, na ...	allowed	not allowed	not allowed
`drop_hypothesis`Retire an OPEN bet without scoring it (the question became moot, the metric unmeasurable ...	allowed	not allowed	not allowed
`eval_scorecard`Aggregate the hit-rate across RESOLVED hypotheses (per project, or global with a per-pro ...	allowed	not allowed	not allowed
`evaluate_cohort_diversity`Structural bulk-generation gate: flag near-duplicate personas and implausibly uniform co ...	allowed	not allowed	not allowed
`evaluate_simulation`Run the quality harness (uniformity, repetition, continuity, project movement, consisten ...	allowed	not allowed	not allowed
`evaluate_simulation_full`Combined 'top' verdict: structural harness + latest LLM critic (definition v2).	allowed	not allowed	not allowed
`export_council_session`Export one council session as a document (md\|json) for sharing.	allowed	not allowed	not allowed
`export_persona`Export one persona (profile + SOUL/memory) as json/markdown.	allowed	not allowed	not allowed
`export_plan_md`Render the plan as a human-readable, bucketed plan.md (analyze/act/verify + status + gates).	allowed	not allowed	not allowed
`export_section`Self-contained export of a section (md\|json): its members' summaries, for a downstream agent.	allowed	not allowed	not allowed
`export_survey`Render the survey as a SENDABLE, self-contained static HTML form (spa-min template) — wo ...	allowed	allowed	allowed
`export_synthesis`Export a report (synthesis). format: `md`\|`json` returned inline · `pdf`\|`pptx` rendered as a ...	allowed	allowed	allowed
`export_synthesis_html`Export a report (synthesis) as a SHAREABLE read-only static HTML bundle — `data/export/s ...	allowed	allowed	allowed
`extract_pain_points`Surface a persona's pain-point observations over a date range.	allowed	not allowed	not allowed
`fetch`Fetch ONE research record by id (a project/council/synthesis/hypothesis/persona id, e.g. ...	allowed	allowed	allowed
`finish_run`Mark the run finished/stopped.	allowed	allowed	allowed
`flow_funnel`The segment funnel of one flow: per step entered/continued/dropped with the drop reasons ...	allowed	not allowed	not allowed
`generate_avatar`Generate (or regenerate) the persona's avatar image — needs OPENAI_API_KEY. Without the ...	allowed	allowed	allowed
`generate_project_icon`Create a fitting custom SVG icon for a Project/Job from its title/goal plus an optional ...	allowed	not allowed	not allowed
`get_activity`Fetch one simulated activity (block) by id.	allowed	not allowed	not allowed
`get_artifact`One artifact (by id or A/B label) with its full captured snapshot.	allowed	not allowed	not allowed
`get_asset`One asset record (by id or filename) — includes the text excerpt for documents.	allowed	not allowed	not allowed
`get_calendar`A persona's calendar events for one day.	allowed	not allowed	not allowed
`get_calendar_period`A persona's calendar for a day\|week\|month\|year view — LEAN event rows (id/timestamp/even ...	allowed	not allowed	not allowed
`get_chat`One chat with its full turn history.	allowed	not allowed	not allowed
`get_corpus`One corpus record; include_chunks=True adds a PAGE of chunks (`chunk_list`, shared pagin ...	allowed	not allowed	not allowed
`get_council`Fetch one council session by id (prompt, turns/statements, votes, summary).	allowed	allowed	allowed
`get_current_state`A persona's live state — what they're doing now / at a given time.	allowed	not allowed	not allowed
`get_day_plan`Fetch the stored day plan for a persona on a given date.	allowed	not allowed	not allowed
`get_decision`One decision record by id — what was decided, the evidence cited (based_on), the rejecte ...	allowed	allowed	allowed
`get_form`Inspect one registered primitive form by canonical id or compatibility alias.	allowed	not allowed	not allowed
`get_head_to_head`Fetch one head-to-head result by session id — its options, per-persona preferences, the ...	allowed	allowed	allowed
`get_hypothesis`One hypothesis by id — the bet, its prediction, and (once resolved) the recorded result ...	allowed	allowed	allowed
`get_ideation`Fetch one ideation summary by session id — problem, HMW questions, idea pool, ranked sho ...	allowed	not allowed	not allowed
`get_job_preset`One Job preset by stable taxonomy id (e.g. 'positioning'): framework + framework_options + ...	allowed	not allowed	not allowed
`get_language`Read the active content language (host-authored text) and UI language.	allowed	allowed	allowed
`get_methodology`The full constellation spec for one methodology (steps, tags, consumes, produces, requires).	allowed	not allowed	not allowed
`get_open_loops`A persona's unresolved threads / open loops (filter by status).	allowed	not allowed	not allowed
`get_period_plan`Fetch a stored period plan (week\|month\|quarter\|year) for a persona.	allowed	not allowed	not allowed
`get_persona`Full persona record + recent calendar/experience/pain points.	allowed	allowed	allowed
`get_persona_memory`Render + return MEMORY.md: active projects (timelines), open threads, digests.	allowed	not allowed	not allowed
`get_persona_soul`The persona's SOUL.md (authoritative identity + grown drift).	allowed	not allowed	not allowed
`get_plan`The project's research plan (analyze/act/verify task DAG + evidence refs + judgments).	allowed	allowed	allowed
`get_price_ladder`Fetch one price-ladder result by session id — the ladder, the raw per-persona/per-rung banded ...	allowed	not allowed	not allowed
`get_project`Full fact/status timeline of one project (use `as_of` for how it looked then).	allowed	allowed	allowed
`get_project_graph`The core navigation call: nodes (studies + theme tags + sentiment), typed edges, themes, ...	allowed	not allowed	not allowed
`get_prototype`One prototype artifact by id or slug.	allowed	not allowed	not allowed
`get_red_team`Fetch one red-team result by session id — its stance, adversarial roles, per-persona objections ...	allowed	allowed	allowed
`get_research_frontier`The anti-explosion surface: the project's still-open questions + structural notes.	allowed	not allowed	not allowed
`get_result_schema`One domain-neutral result schema by id, e.g. stimulus_reaction.v1.	allowed	not allowed	not allowed
`get_section`Get one section by id.	allowed	not allowed	not allowed
`get_section_members`Resolve a section's members into {kind,title,summary,href} records (section-scoped view).	allowed	not allowed	not allowed
`get_session_funnel`Aggregate ALL usability sessions of one subject into a step-indexed funnel: per step the ...	allowed	not allowed	not allowed
`get_state_at`Time-travel: entities + facts + open threads + world valid at a given date.	allowed	not allowed	not allowed
`get_study_result`ONE structured study result: lean project row + run state + council rows + the FULL synt ...	allowed	not allowed	not allowed
`get_survey`One survey by id or slug — the instrument document + its live response_count.	allowed	allowed	allowed
`get_synthesis`Fetch one report (synthesis) by id — its findings/sections/scope and metadata.	allowed	allowed	allowed
`get_timeline`Chronological facts + experience events for a persona over a date range (optionally one ...	allowed	not allowed	not allowed
`get_usability_session`One recorded usability session by id — the full replayable trace (steps + outcome + stat ...	allowed	not allowed	not allowed
`get_world_context`The shared world context (macro facts personas live in) valid at a given date.	allowed	allowed	allowed
`import_survey_responses`Ingest a batch of REAL responses — a JSON list (the export form's payload shape: {respon ...	allowed	allowed	allowed
`ingest_corpus`Ingest one REAL document (interview transcript, support-ticket export, review dump, surv ...	allowed	not allowed	not allowed
`inject_work`Turn one critic `missing` item {kind, what, ...} into a real plan task/open-question (the ...	allowed	not allowed	not allowed
`iterate_task`Open the NEXT iteration round on a done-or-ready task with a `loop_back` target (HOST-judged ...	allowed	not allowed	not allowed
`link_evidence`Attach an evidence ref (kind=council\|synthesis\|artifact\|session, id) to a task (usually the ...	allowed	not allowed	not allowed
`list_active_projects`Compact list of the persona's open projects with status + open-loop counts.	allowed	allowed	allowed
`list_artifacts`List every artifact ingested into a project (id, label A/B/…, kind, url, capture status).	allowed	allowed	allowed
`list_assets`Every asset attached to a project (lean records; excerpt via get_asset, pixels via view_ ...	allowed	not allowed	not allowed
`list_chats`Paginated lean chat rows (newest first), optionally scoped to one persona.	allowed	not allowed	not allowed
`list_corpora`Every ingested corpus (id, title, source_type, chunk count).	allowed	not allowed	not allowed
`list_councils`List council sessions (id, prompt, persona count, votes), newest first. Paginated per th ...	allowed	allowed	allowed
`list_decisions`List decision records (optionally per project and/or status: proposed\|adopted\|superseded ...	allowed	allowed	allowed
`list_digests`List a persona's consolidated digests (optionally filtered by scope).	allowed	not allowed	not allowed
`list_examples`The example projects shipped with Sonaloop: slug, title, one-line tagline, and whether e ...	allowed	allowed	allowed
`list_flows`Every defined flow on a project (id, title, step count).	allowed	not allowed	not allowed
`list_forms`List registered primitive forms, optionally filtered by primitive id.	allowed	not allowed	not allowed
`list_frameworks`The Frameworks (the methodologies that seed a study's plan) in PLAIN LANGUAGE, as one clean ...	allowed	not allowed	not allowed
`list_hooks`All durable hook registrations (id, event pattern, kind, target, label).	allowed	not allowed	not allowed
`list_hypotheses`List hypotheses (optionally per project and/or status: open\|validated\|refuted\|inconclusi ...	allowed	allowed	allowed
`list_ideas`The project's idea records, filterable by HMW question, source persona, or cluster tag — ...	allowed	not allowed	not allowed
`list_job_presets`The Job presets — one per named research Job (positioning, pricing, jtbd_demand, ideation_hmw, ...	allowed	not allowed	not allowed
`list_lifecycle_events`The documented lifecycle-event catalogue the core emits (persona.created, council.record ...	allowed	not allowed	not allowed
`list_memory_anomalies`Flagged memory anomalies (contradictions / integrity issues), optionally per persona.	allowed	not allowed	not allowed
`list_methodologies`List available methodologies (built-in + user-defined) and their step keys.	allowed	not allowed	not allowed
`list_notes`List a project's note nodes in creation order. Paginated per the shared convention (docs ...	allowed	allowed	allowed
`list_period_plans`List a persona's period plans (optionally filtered by scope).	allowed	not allowed	not allowed
`list_persona_revisions`The history of evidence-backed identity revisions for a persona.	allowed	not allowed	not allowed
`list_personas`Lean one-line overview of personas (slug/name/age/role/segment) — drill in with get_pers ...	allowed	allowed	allowed
`list_primitives`List registered Library primitives with family, icon, color and purpose metadata.	allowed	not allowed	not allowed
`list_proto_sessions`List live browser sessions.	allowed	not allowed	not allowed
`list_prototypes`List registered prototype artifacts (optionally for one project).	allowed	not allowed	not allowed
`list_research_projects`List research projects (graph containers) with study/edge/theme counts.	allowed	allowed	allowed
`list_result_contracts`List the output contracts declared for Jobs and methodologies.	allowed	not allowed	not allowed
`list_result_schemas`List domain-neutral result schemas plus registry validation errors.	allowed	not allowed	not allowed
`list_sections`List a project's sections (ordered).	allowed	not allowed	not allowed
`list_surveys`List surveys (optionally per project), each with its live response_count.	allowed	allowed	allowed
`list_syntheses`List all reports (syntheses) — id, title, scope, date — for browsing.	allowed	allowed	allowed
`list_usability_sessions`List recorded usability sessions, optionally filtered by project, persona and/or subject ...	allowed	not allowed	not allowed
`load_example`Load one shipped example project end-to-end (empty slug = list what's available). Idempo ...	allowed	allowed	allowed
`next_action`The ready task FULLY loaded for a lean autonomous loop: analyze→grounding (prior synthes ...	allowed	allowed	allowed
`park_evidence`Explicitly park evidence that should remain visible but should NOT flow into a downstream ...	allowed	not allowed	not allowed
`prepare_persona_agent_context`Build the launch context for a persona subagent (SOUL + state + recent events).	allowed	allowed	allowed
`price_ladder_analysis`The analytics shape of a recorded price ladder: acceptable-price range + cliff points, overall ...	allowed	not allowed	not allowed
`project_result_contract_state`Show which expected result schemas are recorded or still missing for a project.	allowed	not allowed	not allowed
`proto_act`Act on the latest snapshot: {type: click\|type\|select\|scroll\|key\|wait, ref?, text?, value?}.	allowed	not allowed	not allowed
`proto_close`Close a browser session.	allowed	not allowed	not allowed
`proto_open`Open a real running app in a headless browser session; returns {session_id, snapshot}. W ...	allowed	not allowed	not allowed
`proto_read`Re-read the current snapshot of a session.	allowed	not allowed	not allowed
`put_day_plan`Persist the day plan you authored from brief_day.	allowed	not allowed	not allowed
`put_digest`Persist + embed the digest you authored from brief_digest.	allowed	not allowed	not allowed
`put_period_plan`Persist a period plan (its sample_days drive which days you simulate concretely).	allowed	not allowed	not allowed
`query_councils`Paginated lean council rows; filter by project, participant, free text, `since`.	allowed	not allowed	not allowed
`query_personas`Paginated lean persona rows, filterable by free text. Stable ordering + next_offset.	allowed	allowed	allowed
`query_projects`Paginated lean research-project rows; filter by status, free text, and `since` (ISO lowe ...	allowed	not allowed	not allowed
`query_syntheses`Paginated lean synthesis rows (the answer/report nodes); filter by status, text, `since`.	allowed	not allowed	not allowed
`recall_memory`Hybrid (semantic + keyword/entity + recency + importance) recall over episodes, facts, d ...	allowed	not allowed	not allowed
`record_actuation_gate`The fidelity-vs-theater head-to-head: compare a rung-1 artifact walkthrough against a ru ...	allowed	not allowed	not allowed
`record_calibration_round`Stamp one authored correction round ({persona_id, text, refs?} each) and snapshot a fres ...	allowed	not allowed	not allowed
`record_chat_turn`Persist one authored chat exchange (the durable, queryable artifact). Emits the `chat.re ...	allowed	allowed	allowed
`record_cohort_critic`Persist the host-authored cohort critique (outliers + cohort_note) as an eval report + a ...	allowed	not allowed	not allowed
`record_completeness_critic`Persist the independent critic verdict {scores, passed, missing[{kind,what,why, suggeste ...	allowed	not allowed	not allowed
`record_council`Persist a host-authored council. Shape it by what you pass (the UI derives the mode): DI ...	allowed	allowed	allowed
`record_critic_round`Log one completeness-critic round on the run (loop-until-dry observability).	allowed	not allowed	not allowed
`record_day`Persist a host-authored SINGLE day end-to-end (put_day_plan -> simulate the authored blo ...	allowed	not allowed	not allowed
`record_decision`Persist a host-authored decision record — "we decided X, based on syntheses A and B, rej ...	allowed	allowed	allowed
`record_eval_critic`Persist the host-authored critic verdict; flags low dimensions + items as anomalies.	allowed	not allowed	not allowed
`record_evidence_check`Persist provenance verdict: confirmed/contradicted/unsupported; flags contradictions.	allowed	not allowed	not allowed
`record_frame`Discharge an ANALYZE frame task: author research questions + hypotheses grounded in cited ...	allowed	not allowed	not allowed
`record_grounding`Persist authored grounding: optional profile patch + the provenance map (claim → chunk i ...	allowed	not allowed	not allowed
`record_head_to_head`Persist a host-authored HEAD-TO-HEAD (stored as a CouncilSession with a `head_to_head` block). ...	allowed	allowed	allowed
`record_hmw_reframe`REFRAME (ideation_hmw protocol step 1): persist your How-Might-We reframe of a raw problem — ...	allowed	not allowed	not allowed
`record_hypothesis`Persist a host-authored hypothesis with status=open — the bet stamped BEFORE reality ans ...	allowed	allowed	allowed
`record_hypothesis_result`Attach the REAL-WORLD observation and flip the status. `source` is a Ref that must RESOL ...	allowed	allowed	allowed
`record_ideas`DIVERGE (step 2): persist council-generated ideas as first-class, queryable idea records. ...	allowed	not allowed	not allowed
`record_ideation_summary`CONVERGE (step 3): persist the FORCED ranking as an ideation summary. `shortlist` is your ...	allowed	not allowed	not allowed
`record_job_outcome`Persist one project-owned schema outcome as a job completion milestone.	allowed	not allowed	not allowed
`record_judgment`Record an evidence-backed LLM gate judgment on a plan TASK (usually a verify task). `gate_tag` ...	allowed	not allowed	not allowed
`record_memory_deltas`Persist host-authored memory deltas: resolves/dedupes entities, writes bi-temporal facts ...	allowed	not allowed	not allowed
`record_month_bundle`Persist a host-authored month bundle through the full loop (plan->sample days-> simulate ...	allowed	not allowed	not allowed
`record_open_questions`Promote open questions raised by a study into first-class graph nodes.	allowed	not allowed	not allowed
`record_persona`Validate + persist the persona profile you authored from brief_persona. This is the crea ...	allowed	allowed	allowed
`record_persona_revision`Persist evidence-backed identity drift (re-renders SOUL); source identity preserved.	allowed	not allowed	not allowed
`record_prediction_outcome`Match ONE real outcome to one predicted behavior and score it. prediction_ref: {kind: se ...	allowed	not allowed	not allowed
`record_price_ladder`Persist a host-authored PRICE LADDER (stored as a CouncilSession with a `price_ladder` block). ...	allowed	not allowed	not allowed
`record_prototype_session`Persist a persona's grounded prototype use as an experience + memory + artifact; rejects ...	allowed	not allowed	not allowed
`record_red_team`Persist a host-authored RED-TEAM (stored as a CouncilSession with a `red_team` block). Pass the ...	allowed	allowed	allowed
`record_survey`Persist a host-authored survey. `questions` = [{id?, text, kind: single\|multi\|scale\|text, ...	allowed	allowed	allowed
`record_synthesis`Persist/UPDATE a host-authored synthesis. A synthesis is DECOUPLED from councils: `counc ...	allowed	allowed	allowed
`record_synthesis_outline`Persist the host-authored report outline (sections derived from the graph).	allowed	allowed	allowed
`record_synthesis_section`Persist one authored report section. `content`: {markdown, citations:[{study_id\|council_id}], ...	allowed	allowed	allowed
`record_usability_session`Persist a host-authored usability session — the durable, REPLAYABLE trace (the session is ...	allowed	not allowed	not allowed
`refresh_persona_from_source`Refresh a persona from where it came from. Catalog-pulled personas re-pull from their re ...	allowed	allowed	allowed
`register_hook`Subscribe a durable hook to a lifecycle event. `event` is an exact name, 'domain.*', or ...	allowed	not allowed	not allowed
`register_methodology`Register a USER-DEFINED methodology — author your own constellation and it becomes a Fra ...	allowed	not allowed	not allowed
`register_prototype`Register a hand-authored app under prototypes/ as a runnable artifact (fidelity tag, e.g. lofi\|m ...	allowed	not allowed	not allowed
`remove_asset`Detach an asset from a project (by id or filename).	allowed	not allowed	not allowed
`remove_example`Remove ONE example project's entities — and nothing else. Every id is re-derived from th ...	allowed	not allowed	not allowed
`remove_from_section`Remove node ids from a section's membership (nodes themselves are untouched).	allowed	not allowed	not allowed
`reorder_sections`Set the display/outline order of a project's sections.	allowed	not allowed	not allowed
`resolve_entity`Resolve a free-text mention to an existing entity (dedup), or null if new.	allowed	not allowed	not allowed
`result_contract_for_job`The expected result schemas for one Job.	allowed	not allowed	not allowed
`result_contract_for_methodology`The expected result schemas a methodology usually produces.	allowed	not allowed	not allowed
`run_journal`The run's journal (steps + critic rounds + cursor + status) — the source of truth for resume.	allowed	not allowed	not allowed
`run_prototype`Start the app on an ephemeral localhost port; returns {url, pid}. Local-only.	allowed	not allowed	not allowed
`run_step`The ESV driver's brain (deterministic). Returns the next dispatch to execute: {kind: ana ...	allowed	allowed	allowed
`scaffold_prototype`Generate a real, minimal, runnable web app from a host-authored concept and register it. ...	allowed	not allowed	not allowed
`scaffold_synthesis`Seed a project REPORT outline from the project's phases so the conclusion hand-off is one author ...	allowed	allowed	allowed
`score_run`Persist a RunScore (critic rubric scores + finish + novelty + groundedness + memory depth) so ...	allowed	not allowed	not allowed
`search`Find the workspace's research records (projects, councils, syntheses, hypotheses, person ...	allowed	allowed	allowed
`search_corpus`Keyword search over corpus chunks — pull the real signal relevant to a task (determinist ...	allowed	not allowed	not allowed
`search_entities`Find a persona's memory entities by kind and/or name substring.	allowed	not allowed	not allowed
`set_language`Set the content language (de\|en) for generated text and/or the web UI language. By defau ...	allowed	allowed	allowed
`set_note_data`Merge keys into a note's `data` — e.g. set a concept note's `prototype_id` once you build it, ...	allowed	not allowed	not allowed
`set_project_icon`Replace a Project/Job icon. Use `icon=<existing name>`, `randomize=True`, or pass a cust ...	allowed	not allowed	not allowed
`set_project_methodology`Bind an existing research project to a methodology by (re)seeding its plan from the cons ...	allowed	not allowed	not allowed
`set_project_result_schemas`Set the project-owned result schema contract that must be satisfied before the job is done.	allowed	not allowed	not allowed
`set_section_members`Bulk-set a section's membership — the 'promote this cluster into a named section' move.	allowed	not allowed	not allowed
`set_world_context`Set exogenous backdrop facts (season, regulation, market...). Not shared persona knowledge.	allowed	allowed	allowed
`sharpen_question`Turn a FUZZY goal into a well-formed study — deterministically (no server-side text-LLM). ...	allowed	not allowed	not allowed
`start_job_study`Start a study FROM a Job preset: seeds the plan through the preset's default Framework (or any ...	allowed	not allowed	not allowed
`start_project`THE ENTRY POINT. Create a project + seed its research plan (methodology -> analyze/act/verify ...	allowed	allowed	allowed
`start_run`Create (or resume) the run object — the SINGLE entry to the governed loop. Returns the run + ...	allowed	allowed	allowed
`stop_prototype`Stop a running prototype.	allowed	not allowed	not allowed
`substrate_schema`The versioned substrate contract (envelope, row schemas, filters, the chat flow, the acc ...	allowed	not allowed	not allowed
`suggest_artifact_types`SUGGESTED artifact-type tags for produces.artifact_type / requires.*_tags (matched by ta ...	allowed	not allowed	not allowed
`suggest_capabilities`SUGGESTED capability tags (explore/cluster/decide/build/test/synthesize, …) for a step's ...	allowed	not allowed	not allowed
`suggest_chart_kinds`Which report CHART to use when (bar, pie, stacked_bar, diverging_bar, gauge, dot_plot, h ...	allowed	not allowed	not allowed
`suggest_finding_kinds`SUGGESTED Finding kinds (summary/key_problem/pain_solver/open_question/recommendation/ c ...	allowed	not allowed	not allowed
`suggest_forms`Show the registered forms, schemas, renderers, aggregators and alias policy for one primitive.	allowed	not allowed	not allowed
`suggest_friction_levels`The CANONICAL per-step friction vocabulary for usability sessions — call this before aut ...	allowed	not allowed	not allowed
`suggest_likelihood_levels`The CANONICAL likelihood vocabulary for predicted behaviors (rare → certain, each with t ...	allowed	not allowed	not allowed
`suggest_methodologies`SUGGESTED whole-constellation templates to copy and adapt (the registered methodologies ...	allowed	not allowed	not allowed
`suggest_roles`SUGGESTED role tags for a step's produces.role. Recommendations only.	allowed	not allowed	not allowed
`suggest_section_kinds`Suggested section kinds + presentation (data-driven; adopt/tweak/invent).	allowed	not allowed	not allowed
`suggest_stances`The CANONICAL stance vocabulary — call this before authoring statement stances, votes, or ...	allowed	not allowed	not allowed
`suggest_tech_comfort`The CANONICAL tech-comfort vocabulary for a persona's capability profile (capabilities.t ...	allowed	not allowed	not allowed
`summarize_persona_period`Gather a persona's experience over a date range (optional lens) for summarisation.	allowed	not allowed	not allowed
`survey_results`Per-question aggregates of the imported responses — and for stance_mapped questions the ...	allowed	allowed	allowed
`test_hook`Fire a sample envelope through one registered hook and report delivery success — the ver ...	allowed	not allowed	not allowed
`trace_evidence`Resolve a cited evidence chunk id back to its source: the chunk text, its corpus, and ev ...	allowed	not allowed	not allowed
`unregister_hook`Remove one durable hook registration by id.	allowed	not allowed	not allowed
`update_decision`Flip a decision's status (proposed\|adopted) — or supersede it: `superseded_by` names the ...	allowed	not allowed	not allowed
`update_persona`Apply a host-authored patch to a persona's profile; records a revision with the reason. ...	allowed	allowed	allowed
`update_section`Update a section (title/kind/parent_id/order/presentation/note/member_ids).	allowed	not allowed	not allowed
`view_asset`LOOK at an asset. For an image/screenshot this returns the actual image — view it before ...	allowed	not allowed	not allowed
`walk_open`Open a LIVE walkthrough session on a real SaaS URL under the WalkPolicy safety contract ...	allowed	not allowed	not allowed
`walk_own`Rung 2 — drive a live surface WE OWN: pass `prototype_id` (the scaffolded app is started ...	allowed	not allowed	not allowed
`walk_policy_defaults`The safe default WalkPolicy walk_open applies when none is passed — origin-locked to the ...	allowed	not allowed	not allowed

Design System

Choose a category to edit the workspace brand, tokens, typography, imagery and exports.

Surfaces

Backgrounds from page to elevated overlay. The same roles skin the app shell, reports and exports.

--bgMain background--paper-2Secondary background--sidebarNavigation surface--panelCard panel--panel-2Nested panel--overlayOverlay--hoverHover fill--selSelected fill

Content

Text colors for primary copy, secondary copy and the quietest labels.

--inkPrimary text--ink-2Secondary text--mutedMuted text--faintQuiet metadata

Lines

Hairlines and dividers. Keep them quiet so structure reads without boxing everything in.

--lineHairline border--line-2Subtle divider

Accent

Primary action, focus, selection and the softened accent fill.

--accentPrimary accent--accent-weakWeak accent fill--accent-inkText on accent

Semantic

Council verdicts and status signals: support, warning, opposition, information and skepticism.

--greenPositive--amberWarning--redNegative--blueInformation--violetSecondary series--skepSkeptical signal

Surfaces

Backgrounds from page to elevated overlay. The same roles skin the app shell, reports and exports.

--bgMain background--paper-2Secondary background--sidebarNavigation surface--panelCard panel--panel-2Nested panel--overlayOverlay--hoverHover fill--selSelected fill

Content

Text colors for primary copy, secondary copy and the quietest labels.

--inkPrimary text--ink-2Secondary text--mutedMuted text--faintQuiet metadata

Lines

Hairlines and dividers. Keep them quiet so structure reads without boxing everything in.

--lineHairline border--line-2Subtle divider

Accent

Primary action, focus, selection and the softened accent fill.

--accentPrimary accent--accent-weakWeak accent fill--accent-inkText on accent

Semantic

Council verdicts and status signals: support, warning, opposition, information and skepticism.

--greenPositive--amberWarning--redNegative--blueInformation--violetSecondary series--skepSkeptical signal

Workspace

Team

Local

API credentials

MCP endpoint

MCP bearer token

Catalog token

MCP role matrix

Plan

Design System

Surfaces

Content

Lines

Accent

Semantic

Surfaces

Content

Lines

Accent

Semantic

Keyboard shortcuts

Global

Lists

Detail pages

Feedback