Nucleus Sovereign Tool Catalog

features

brain_add_feature

Add a new feature to the product's feature map. Args: product: "gentlequest" or "nucleus" name: Human-readable feature name description: What the feature does source: Where it lives (e.g., "gentlequest_app", "pypi_mcp") version: Which version it shipped in how_to_test: List of test steps expected_result: What should happen when testing status: development/staged/production/released tags: Searchable tags Returns: Created feature object

Parameters

product str

name str

description str

source str

version str

how_to_test List

expected_result str

status str

tags List

orchestration

brain_add_loop

Manually add a new open loop.

Parameters

description str

loop_type str

priority int

tasks

brain_add_task

Create a new task in the queue.

Parameters

description str

priority int

blocked_by List

required_skills List

source str

task_id str

skip_dep_check bool

orchestration

brain_apply_critique

Apply fixes based on a critique review.

Parameters

review_path str

sessions

brain_archive_resolved

Archive all .resolved.* backup files to clean up the brain folder.

Parameters

No parameters required.

orchestration

brain_archive_stale

Auto-archive commitments older than 30 days.

Parameters

No parameters required.

engrams

brain_audit_log

View the cryptographic interaction log for trust verification.

Parameters

limit int

governance

brain_auto_fix_loop

Auto-fix loop: Verify -> Diagnose -> Fix -> Verify. Retries up to 3 times. Phase 4: Self-Healing.

Parameters

file_path str

verification_command str

orchestration

brain_autopilot_sprint

THE SPRINT COMMAND.

Parameters

slots List

mode str

halt_on_blocker bool

halt_on_tier_mismatch bool

max_tasks_per_slot int

budget_limit float

dry_run bool

orchestration

brain_autopilot_sprint_v2

Enhanced autopilot sprint with V3.1 features.

Parameters

slots List

mode str

halt_on_blocker bool

halt_on_tier_mismatch bool

max_tasks_per_slot int

budget_limit float

time_limit_hours float

dry_run bool

sync

brain_check_deploy

Check status of an active deploy poll.

Parameters

service_id str

orchestration

brain_check_kill_switch

Check Kill Switch status.

Parameters

No parameters required.

orchestration

brain_check_protocol

Check multi-agent coordination protocol compliance.

Parameters

agent_id str

sessions

brain_check_recent_session

Check if there's a recent session to offer resumption.

Parameters

No parameters required.

sessions

brain_checkpoint_task

[CHECKPOINT] Save the current state of a task for later resumption.

Parameters

task_id str

step int

progress_percent float

context str

artifacts List

resumable bool

tasks

brain_claim_task

Atomically claim a task.

Parameters

task_id str

agent_id str

orchestration

brain_close_commitment

Close a commitment with specified method.

Parameters

commitment_id str

method str

orchestration

brain_commitment_health

Get commitment health summary.

Parameters

No parameters required.

sync

brain_complete_deploy

Mark a deploy as complete and optionally run smoke test.

Parameters

service_id str

success bool

deploy_url str

error str

run_smoke_test bool

engrams

brain_compounding_status

🔄 Get status of the Compounding v0 Loop.

Parameters

No parameters required.

tasks

brain_context_switch

🧠 Record a context switch and check for ADHD drift.

Parameters

new_context str

tasks

brain_context_switch_reset

🔄 Reset the context switch counter.

Parameters

No parameters required.

tasks

brain_context_switch_status

📊 Get current context switch status and ADHD metrics.

Parameters

No parameters required.

orchestration

brain_critique_code

Run a Critic agent review on a file.

Parameters

file_path str

context str

orchestration

brain_dashboard

Enhanced orchestration dashboard.

Parameters

detail_level str

format str

include_alerts bool

include_trends bool

category str

tasks

brain_depth_map

Generate exploration map.

Parameters

No parameters required.

tasks

brain_depth_pop

Come back up one level.

Parameters

No parameters required.

tasks

brain_depth_push

Go deeper into a subtopic.

Parameters

topic str

tasks

brain_depth_reset

Reset depth to root level.

Parameters

No parameters required.

tasks

brain_depth_set_max

Set the maximum safe depth.

Parameters

max_depth int

tasks

brain_depth_show

Show current depth state.

Parameters

No parameters required.

features

brain_discover_mounted_tools

Discover tools from mounted MCP servers. Args: server_id: Optional. Specific server to query. If None, queries all.

Parameters

server_id str

engrams

brain_dsor_status

Get comprehensive DSoR status.

Parameters

No parameters required.

sessions

brain_emit_event

Emit a new event to the brain ledger.

Parameters

event_type str

emitter str

data Dict

description str

engrams

brain_end_of_day

📝 Capture end-of-day learnings as engrams.

Parameters

summary str

key_decisions List

blockers List

tasks

brain_escalate

Escalate a task to request human help.

Parameters

task_id str

reason str

sync

brain_evaluate_triggers

Evaluate which agents should activate for a given event.

Parameters

event_type str

emitter str

orchestration

brain_export

Export the brain content to a zip file in .brain/exports/.

Parameters

No parameters required.

engrams

brain_export_schema

Export the current MCP toolset as an OpenAPI/JSON Schema.

Parameters

No parameters required.

engrams

brain_federation_dsor_status

Get Federation DSoR status.

Parameters

No parameters required.

federation

brain_federation_health

Get federation health dashboard.

Parameters

No parameters required.

federation

brain_federation_join

Join a federation via seed peer.

Parameters

seed_peer str

federation

brain_federation_leave

Leave the federation gracefully.

Parameters

No parameters required.

federation

brain_federation_peers

List all federation peers with details.

Parameters

No parameters required.

federation

brain_federation_route

Route a task to the optimal brain.

Parameters

task_id str

profile str

federation

brain_federation_status

Get comprehensive federation status.

Parameters

No parameters required.

federation

brain_federation_sync

Force immediate synchronization with all peers.

Parameters

No parameters required.

orchestration

brain_file_changes

Get pending file change events.

Parameters

No parameters required.

orchestration

brain_fix_code

Auto-fix code based on issues context.

Parameters

file_path str

issues_context str

orchestration

brain_force_assign

Force assign a task to a slot.

Parameters

slot_id str

task_id str

acknowledge_risk bool

sessions

brain_garbage_collect_tasks

Archive stale and auto-generated tasks to reduce noise.

Parameters

max_age_hours int

dry_run bool

orchestration

brain_gcloud_services

List Cloud Run services in a project.

Parameters

project str

region str

orchestration

brain_gcloud_status

Check GCloud authentication status.

Parameters

No parameters required.

sessions

brain_generate_handoff_summary

[HANDOFF] Generate a rich context summary for a task handoff.

Parameters

task_id str

summary str

key_decisions List

handoff_notes str

features

brain_generate_proof

Generate a proof document for a feature. Args: feature_id: Feature to generate proof for thinking: AI's decision-making process (markdown) deployed_url: Production URL files_changed: List of files modified risk_level: low/medium/high rollback_time: Estimated time to rollback Returns: Proof generation result with path

Parameters

feature_id str

thinking str

deployed_url str

files_changed List

risk_level str

rollback_time str

orchestration

brain_get_alerts

Get current active alerts.

Parameters

No parameters required.

features

brain_get_feature

Get a specific feature by ID. Args: feature_id: The feature ID (snake_case) Returns: Feature object with test instructions

Parameters

feature_id str

orchestration

brain_get_handoffs

Get pending handoff requests.

Parameters

agent_id str

orchestration

brain_get_llm_status

Get current LLM tier configuration.

Parameters

No parameters required.

tasks

brain_get_next_task

Get the highest-priority unblocked task.

Parameters

skills List

features

brain_get_proof

Get the proof document for a feature. Args: feature_id: Feature ID to get proof for Returns: Proof content or message if not found

Parameters

feature_id str

sessions

brain_get_state

Get the current state of the brain.

Parameters

path Optional

sync

brain_get_triggers

Get all defined neural triggers.

Parameters

No parameters required.

engrams

brain_governance_status

Get current governance status.

Parameters

No parameters required.

orchestration

brain_halt_sprint

Request halt of current sprint.

Parameters

reason str

orchestration

brain_handoff_task

Hand off a task to another session.

Parameters

task_description str

target_session_id Optional

priority int

engrams

brain_health

Get comprehensive system health status.

Parameters

No parameters required.

engrams

brain_hook_metrics

📊 Monitor the auto-write engram hook system.

Parameters

No parameters required.

sync

brain_identify_agent

Register current agent identity for multi-agent coordination.

Parameters

agent_id str

environment str

role str

tasks

brain_import_tasks_from_jsonl

Import tasks from a JSONL file.

Parameters

jsonl_path str

clear_existing bool

merge_gtm_metadata bool

orchestration

brain_ingest_tasks

Ingest tasks from various sources.

Parameters

source str

source_type str

session_id str

auto_assign bool

skip_dedup bool

dry_run bool

orchestration

brain_ingestion_stats

Get overall ingestion statistics.

Parameters

No parameters required.

features

brain_invoke_mounted_tool

Invoke a tool on a mounted external MCP server. Args: server_id: The ID of the server (e.g. mnt-123456) tool_name: The name of the tool to call on that server arguments: Arguments for the tool

Parameters

server_id str

tool_name str

arguments Dict

engrams

brain_ipc_tokens

List IPC authentication tokens.

Parameters

active_only bool

sync

brain_list_artifacts

List artifacts in a folder.

Parameters

folder Optional

orchestration

brain_list_commitments

List all open commitments.

Parameters

tier str

engrams

brain_list_decisions

List recent DecisionMade events.

Parameters

limit int

features

brain_list_features

List all features, optionally filtered. Args: product: Filter by product ("gentlequest" or "nucleus") status: Filter by status tag: Filter by tag Returns: List of matching features

Parameters

product str

status str

tag str

engrams

brain_list_ledger_snapshots

List context snapshots.

Parameters

limit int

features

brain_list_mounted

List all currently mounted external MCP servers.

Parameters

No parameters required.

orchestration

brain_list_pending_consents

List agents awaiting user consent for respawn.

Parameters

No parameters required.

features

brain_list_proofs

List all proof documents. Returns: List of proofs with metadata

Parameters

No parameters required.

orchestration

brain_list_services

List Render.com services.

Parameters

No parameters required.

sessions

brain_list_sessions

List all saved sessions.

Parameters

No parameters required.

orchestration

brain_list_snapshots

List available dashboard snapshots.

Parameters

limit int

tasks

brain_list_tasks

List tasks with optional filters.

Parameters

status Optional

priority Optional

skill Optional

claimed_by Optional

engrams

brain_list_tools

List available tools at current tier level.

Parameters

category str

orchestration

brain_manage_strategy

Read or Update the core Strategy Document.

Parameters

action str

content str

orchestration

brain_mark_high_impact

Manually mark a loop closure as high-impact.

Parameters

No parameters required.

features

brain_mark_validated

Mark a feature as validated after testing. Args: feature_id: Feature that was tested result: "passed" or "failed" Returns: Updated feature with validation timestamp

Parameters

feature_id str

result str

engrams

brain_metering_summary

Get token metering summary.

Parameters

since_hours int

orchestration

brain_metrics

Get coordination metrics (velocity, closure rates, mental load).

Parameters

No parameters required.

orchestration

brain_mission_status

Get current mission status.

Parameters

mission_id str

engrams

brain_morning_brief

🧠 The Nucleus Morning Brief — daily 'Alive Workflow'.

Parameters

No parameters required.

features

brain_mount_server

Mount an external MCP server to Nucleus (Recursive Aggregator). Args: name: Local name for the mounted server command: Executable command (e.g. "npx", "python") args: Command line arguments

Parameters

name str

command str

args List

orchestration

brain_open_loops

Unified view of ALL open loops (tasks, todos, drafts, decisions).

Parameters

type_filter str

tier_filter str

orchestration

brain_optimize_workflow

Self-optimize the workflow cheatsheet.

Parameters

No parameters required.

orchestration

brain_orchestrate

THE GOD COMMAND - Single entry point for all slot operations.

Parameters

slot_id str

model str

alias str

mode str

orchestration

brain_orchestrate_swarm

Initialize a multi-agent swarm.

Parameters

mission str

agents List

orchestration

brain_patterns

Manage learned patterns for commitment closure.

Parameters

action str

orchestration

brain_pause_notifications

Pause all PEFS notifications.

Parameters

No parameters required.

engrams

brain_performance_metrics

Get performance metrics for Nucleus operations.

Parameters

export_to_file bool

engrams

brain_prometheus_metrics

Get Prometheus-compatible metrics.

Parameters

format str

sessions

brain_propose_merges

Detect redundant artifacts and generate merge proposals.

Parameters

No parameters required.

engrams

brain_query_engrams

Query Engrams from the cognitive memory ledger.

Parameters

context str

min_intensity int

sync

brain_read_artifact

Read contents of an artifact file.

Parameters

path str

sessions

brain_read_events

Read recent events.

Parameters

limit int

orchestration

brain_read_memory

Read full content of a memory category.

Parameters

category str

orchestration

brain_record_feedback

Record user feedback on a notification.

Parameters

notification_type str

score int

orchestration

brain_record_interaction

Record a user interaction timestamp.

Parameters

No parameters required.

orchestration

brain_register_session

Register this session's focus area.

Parameters

conversation_id str

focus_area str

orchestration

brain_request_handoff

Request a handoff to another agent.

Parameters

to_agent str

context str

request str

priority int

artifacts List

orchestration

brain_respond_to_consent

Respond to a respawn consent request.

Parameters

agent_id str

choice str

sessions

brain_resume_from_checkpoint

[CHECKPOINT] Retrieve the context and instructions to resume a task.

Parameters

task_id str

orchestration

brain_resume_notifications

Resume PEFS notifications after pause.

Parameters

No parameters required.

sessions

brain_resume_session

Resume a saved session.

Parameters

session_id str

orchestration

brain_resume_sprint

Resume a halted sprint.

Parameters

sprint_id str

orchestration

brain_rollback_ingestion

Rollback an ingestion batch.

Parameters

batch_id str

reason str

engrams

brain_routing_decisions

Query routing decision history.

Parameters

limit int

orchestration

brain_satellite_view

Get unified satellite view of the brain.

Parameters

detail_level str

sessions

brain_save_session

Save current session for later resumption.

Parameters

context str

active_task str

pending_decisions List

breadcrumbs List

next_steps List

orchestration

brain_scan_commitments

Scan artifacts for new commitments (checklists, TODOs).

Parameters

No parameters required.

orchestration

brain_scan_marketing_log

Scan the marketing log for failure tags.

Parameters

No parameters required.

engrams

brain_search_engrams

Search Engrams by substring match.

Parameters

query str

case_sensitive bool

features

brain_search_features

Search features by name, description, or tags. Args: query: Search query Returns: Matching features

Parameters

query str

orchestration

brain_search_memory

Search long-term memory for keywords.

Parameters

query str

orchestration

brain_session_briefing

Get a briefing of pending work at session start.

Parameters

conversation_id Optional

sessions

brain_session_end

🏁 End your work session — auto-captures what happened as an engram.

Parameters

summary str

learnings str

mood str

engrams

brain_session_inject

🚀 Session-start context injection.

Parameters

No parameters required.

sessions

brain_session_start

START HERE - Mandatory session start protocol.

Parameters

No parameters required.

orchestration

brain_set_alert_threshold

Set custom alert threshold for a metric.

Parameters

metric str

level str

value float

orchestration

brain_set_llm_tier

Set the default LLM tier for agent spawning.

Parameters

tier str

orchestration

brain_slot_complete

Mark a task as complete and get next task.

Parameters

slot_id str

task_id str

outcome str

notes str

orchestration

brain_slot_exhaust

Mark slot as exhausted.

Parameters

slot_id str

reset_hours int

sync

brain_smoke_test

Run a smoke test on any URL.

Parameters

url str

endpoint str

orchestration

brain_snapshot_dashboard

Create a manual dashboard snapshot.

Parameters

name str

orchestration

brain_spawn_agent

Spawn an Ephemeral Agent via NAR.

Parameters

intent str

execute_now bool

persona str

sync

brain_start_deploy_poll

Start monitoring a Render deploy.

Parameters

service_id str

commit_sha str

orchestration

brain_start_mission

Start a new mission.

Parameters

name str

goal str

task_ids List

slot_ids List

budget_limit float

time_limit_hours float

success_criteria List

orchestration

brain_status_dashboard

Generate ASCII dashboard of slot status.

Parameters

detail_level str

sync

brain_sync_auto

Enable or disable automatic file watching and sync.

Parameters

enable bool

sync

brain_sync_now

Manually trigger multi-agent sync.

Parameters

force bool

sync

brain_sync_resolve

Manually resolve a file conflict.

Parameters

file_path str

strategy str

sync

brain_sync_status

Check current multi-agent sync status.

Parameters

No parameters required.

orchestration

brain_synthesize_status_report

Generate a 'State of the Union' report.

Parameters

focus str

orchestration

brain_synthesize_strategy

Analyze marketing logs and update Strategy using GenAI.

Parameters

focus_topic Optional

features

brain_thanos_snap

Trigger the Phase C 'Thanos Snap' - Instance Fractal Aggregation.

Parameters

No parameters required.

engrams

brain_tier_status

Get current tool tier configuration status.

Parameters

No parameters required.

features

brain_traverse_and_mount

Recursively explore and mount downstream servers. Args: root_mount_id: The mount ID to start traversal from

Parameters

root_mount_id str

sync

brain_trigger_agent

Trigger an agent by emitting a task_assigned event.

Parameters

agent str

task_description str

context_files List

features

brain_unmount_server

Unmount an external MCP server. Args: server_id: The ID of the server to unmount (e.g. mnt-123456)

Parameters

server_id str

features

brain_update_feature

Update a feature's fields. Args: feature_id: Feature to update status: New status description: New description version: New version Returns: Updated feature

Parameters

feature_id str

status str

description str

version str

orchestration

brain_update_roadmap

Read or Update the Roadmap.

Parameters

action str

item str

sessions

brain_update_state

Update the brain state with new values (shallow merge).

Parameters

updates Dict

tasks

brain_update_task

Update task fields.

Parameters

task_id str

updates Dict

orchestration

brain_value_ratio

Get the Value Ratio metric.

Parameters

No parameters required.

engrams

brain_version

Get Nucleus version and system information.

Parameters

No parameters required.

orchestration

brain_weekly_challenge

Manage the weekly growth challenge.

Parameters

action str

challenge_id str

engrams

brain_weekly_consolidate

🧹 Weekly consolidation.

Parameters

dry_run bool

sync

brain_write_artifact

Write contents to an artifact file.

Parameters

path str

content str

engrams

brain_write_engram

Write a new Engram to the cognitive memory ledger.

Parameters

key str

value str

context str

intensity int

governance

hypervisor_status

[HYPERVISOR] Reports the current security state of the Agent OS.

Parameters

No parameters required.

governance

lock_resource

[HYPERVISOR] Locks a file or directory using 'chflags uchg' (Immutable). Prevents ANY modification, even by root/sudo, until unlocked. Use this to protect critical state or during Red Team audits.

Parameters

path str

governance

nucleus_curl

[EGRESS FIREWALL] Proxied HTTP fetch for Air-Gapped Agents. Use this to read docs/schemas when your runtime --network is blocked.

Parameters

url str

method str

governance

nucleus_delete_file

[GOVERNANCE] Attempts to delete a file. This action is strictly governed by the Nucleus Hypervisor (Layer 4).

Parameters

path str

governance

nucleus_list_directory

[GOVERNANCE] Lists files in a directory. Allows the agent to safely inspect a folder before performing audit actions.

Parameters

path str

governance

nucleus_pip_install

[EGRESS FIREWALL] Proxied pip install for Air-Gapped Agents. Executes 'pip install' on the Host so you can import the library.

Parameters

package str

governance

set_hypervisor_mode

[HYPERVISOR] Switches the IDE visual context (Layer 2 Injection). mode: "red" (Audit/Attack) or "blue" (Build/Defend).

Parameters

mode str

governance

unlock_resource

[HYPERVISOR] Unlocks a file or directory (removes 'uchg' flag).

Parameters

path str

governance

watch_resource

[HYPERVISOR] key file/folder monitoring (Layer 1). If a protected resource is modified while locked, it triggers an alert and immediately re-applies the lock.

Parameters

path str