Nucleus Sovereign Tool Catalog

170 tools available
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