Skip to content
Agentmart
Submit a tool

Nucleus

Sovereign Agent OS — Persistent Memory, Governance & Compliance for AI Agents.

Connector by eidetic-works · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)Remote (HTTP)★ 5
Write a review

Install

Works with Claude Code, VS Code, Codex, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/eidetic-works-nucleus

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Remote endpoint

  • https://relay.nucleusos.dev/mcp Remote (HTTP)

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Sovereign Agent OS — Persistent Memory, Governance & Compliance for AI Agents.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
5 read · 18 write · 2 delete · 3 not yet classified
Secrets
None asked for
Install scripts
None found
Runs as
Python package

Tools by what they do 28

From the running server's own tool list (tools/list) on Oct 25, 2026.

Read 5 · Look things up without changing anything.

  • nucleus_audit
  • nucleus_lane_status
  • nucleus_plan_list
  • nucleus_relay_subscribe
  • nucleus_route

Write 18 · Create, change, send or run things.

  • nucleus_agents
  • nucleus_ccr_arm
  • nucleus_delegate
  • nucleus_engrams
  • nucleus_features
  • nucleus_federation
  • nucleus_lane_init
  • nucleus_lane_start
  • nucleus_lane_stop
  • nucleus_next_message
  • nucleus_orchestration
  • nucleus_relay
Show 6 more tools
  • nucleus_sessions
  • nucleus_slots
  • nucleus_sync
  • nucleus_tasks
  • nucleus_telemetry
  • nucleus_wakeup_wait

Delete 2 · Delete, drop, revoke or wipe things.

  • nucleus_governance
  • nucleus_infra

Not yet classified 3 · We could not tell from the name and description.

  • nucleus_lane_feedback
  • nucleus_plan_execute
  • nucleus_plan_import

Secrets and settings it asks for

Other settings (environment variables or headers).

  • NUCLEUS_BRAIN_PATH

Network hosts it talks to 53

  • ai.google.dev · found in code
  • aistudio.google.com · found in code
  • anthropic.com · found in code
  • api.anthropic.com · found in code
  • api.groq.com · found in code
  • api.openai.com · found in code
  • api.osv.dev · found in code
  • api.render.com · found in code
  • api.slack.com · found in code
  • api.stripe.com · found in code
  • api.telegram.org · found in code
  • api.x.ai · found in code
  • app.clerk.accounts.dev · found in code
  • apple.com · found in code
  • auth.x.ai · found in code
  • cdn.tailwindcss.com · found in code
  • cdnjs.cloudflare.com · found in code
  • claude.ai · found in code
  • clerk.com · found in code
  • cloud.google.com · found in code
  • cloudcode-pa.googleapis.com · found in code
  • composedfit.com · found in code
  • console.anthropic.com · found in code
  • console.groq.com · found in code
  • developers.openai.com · found in code
  • discord.com · found in code
  • docs.stripe.com · found in code
  • eidetic.works · found in code
  • example.invalid · found in code
  • example.test · found in code
Show 23 more hosts
  • fonts.googleapis.com · found in code
  • generativelanguage.googleapis.com · found in code
  • github.com · found in code
  • glama.ai · found in code
  • graph.facebook.com · found in code
  • hooks.slack.com · found in code
  • myapp.onrender.com · found in code
  • nucleus.onrender.com · found in code
  • nucleus.test · found in code
  • nucleusos.dev · found in code
  • nucleussovereign.com · found in code
  • oauth2.googleapis.com · found in code
  • ollama.ai · found in code
  • openai.com · found in code
  • owasp.org · found in code
  • reddit.com · found in code
  • registry.nucleus.dev · found in code
  • relay.nucleusos.dev · found in remote endpoint, install command, code
  • telemetry.googleapis.com · found in code
  • telemetry.nucleusos.dev · found in code
  • test-app.onrender.com · found in code
  • unpkg.com · found in code
  • your-app.clerk.accounts.dev · found in code

Files it touches

  • ~/.claude
  • ~/.claude.json
  • ~/.claude/projects
  • ~/.ssh
  • /dev/null
  • /dev/stderr
  • /dev/stdout
  • /dev/tcp
  • /dev/tty
  • /dev/udp
  • /etc/nucleus-oauth/gemini_keys.txt
  • /etc/passwd
  • /home/OPERATOR
  • /home/ubuntu/.nucleus/tenants/default/.brain
  • /Library/LaunchAgents
  • /Library/LaunchDaemons
  • /opt/homebrew/bin
  • /opt/homebrew/bin/gcloud
  • /opt/homebrew/Caskroom/google-cloud-sdk/latest/google-cloud-sdk/bin/gcloud
  • /private/tmp
  • /tmp/nucleus_probe
  • /tmp/nucleus_smoke_test
  • /tmp/nucleus_smoke_test/ledger
  • /tmp/nucleus_smoke_test/sessions
  • /tmp/nucleus_verification
  • /tmp/scratch
  • /tmp/snap_verify_brain
  • /tmp/x
  • /tmp/x/.brain
  • /Users
  • /Users/...
  • /Users/OPERATOR
  • /var/folders
  • /var/tmp
  • %APPDATA%/Claude
  • Your home directory (~)
  • ~/.brain
  • ~/.cloudflared
  • ~/.config/eidetic/watchers.json
  • ~/.eidetic/engrams.db

Tools (28)

As the server listed them on Oct 25, 2026. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • nucleus_agentsAgent Spawning

    Agent spawning, critic, swarm, memory, ingestion & dashboard tools. Actions: spawn_agent - Spawn Ephemeral Agent. params: {intent, execute_now?, persona?, confirm?}. HITL: requires confirm=true. apply_critique - Apply critique fixes. params: {review_path} orchestrate_swarm - Start multi-agent swarm. params: {mission, agents?} search_memory - Search long-term memory. params: {query} read_memory - Read memory category. params: {category} respond_to_consent - Respond to respawn consent. params: {agent_id, choice?} list_pending_consents - List age…

  • nucleus_auditAudit Logread-only

    W8 Team-tier tamper-evident audit log (SHA-256 hash chain). Actions: log_event - Append an audit event to the chain. params: {event_type, actor, resource, outcome, metadata?, team_id?, ts?} query - Single-tenant query. Rejects team_id='*'. params: {team_id, since?, until?, actor?, event_type?, limit?, offset?} admin_query - Cross-tenant query (team_id='*' allowed). Requires NUCLEUS_AUDIT_ADMIN_TOKEN env match. Logs every successful call to the synthetic '__admin__' chain. params: {admin_token, team_i…

  • nucleus_ccr_armCCR Arm

    One-shot convenience: resolve canonical inbox + arm long-poll subscription. Per PR #2 (CCR server-side auto-arm) — IDE-agnostic relay-arrival arming. This is the RECOMMENDED entry point for SessionStart auto-arming across all MCP clients (Claude Code, Antigravity, Cursor, Windsurf, etc.). Equivalent to: 1. resolve_canonical_inbox_name(role) → canonical inbox name 2. nucleus_relay_subscribe(inbox_filter=<canonical>, timeout_seconds=...) Why this exists vs nucleus_relay_subscribe + inbox_filter: nucleus_relay_subscribe + inbox_filter requires the caller to KNOW the canonical i…

  • nucleus_delegateCross-Vendor Delegate

    Hand a coding or review task to a cross-vendor lane — a cheap, non-Claude agent that does the work for you. Use this INSTEAD OF shelling out to any CLI: it picks the vendor, injects the correct per-vendor permission flags, captures all output synchronously, and reports a real status. Do NOT run `agy`/`devin` yourself in Bash — the raw CLIs take DIFFERENT per-vendor flags (pass the wrong one and a build silently makes ZERO edits yet exits 0), and hand-driven background calls flush output late (a finished call looks empty for tens of seconds). This tool is the only robust path. First call `list…

  • nucleus_engramsMemory & Engrams

    Engrams, health, observability, DSoR & tier system tools. Actions: health - Get system health status version - Get Nucleus version info export_schema - Export MCP toolset as JSON Schema performance_metrics - Get perf metrics. params: {export_to_file?} prometheus_metrics - Get Prometheus metrics. params: {format?} audit_log - View cryptographic interaction log. params: {limit?} write_engram - Write engram to memory. params: {key, value, context?, intensity?}. context: Feature|Architecture|Brand|Strategy|Decision. intensity: 1-10. (…

  • nucleus_featuresFeature Flags

    Feature tracking, proof generation & MCP server mounting. Actions: add - Add a feature. params: {product, name, description, source, version, how_to_test, expected_result, status?, tags?} list - List features. params: {product?, status?, tag?} get - Get feature by ID. params: {feature_id} update - Update feature fields. params: {feature_id, status?, description?, version?} validate - Mark feature validated. params: {feature_id, result} search - Search features. params: {query} mount_server - Mount external MCP server…

  • nucleus_federationFederation

    Federation management for multi-brain coordination. Actions: status - Get comprehensive federation status join - Join a federation via seed peer. params: {seed_peer} leave - Leave the federation gracefully peers - List all federation peers with details sync - Force immediate synchronization with all peers route - Route a task to the optimal brain. params: {task_id, profile?} health - Get federation health dashboard

  • nucleus_governanceGovernancecan change or delete data

    Governance, Hypervisor & security tools for the Nucleus Agent OS. Actions: auto_fix_loop - Auto-fix loop: Verify->Diagnose->Fix->Verify (3 retries). params: {file_path, verification_command} lock - [HYPERVISOR] Lock a file/dir immutable (chflags uchg). params: {path} unlock - [HYPERVISOR] Unlock a file/dir. params: {path} set_mode - [HYPERVISOR] Switch IDE context: "red" or "blue". params: {mode} list_directory - [GOVERNANCE] List files in a directory. params: {path} delete_file - [GOVERNANCE] Delete a file (governed by Hypervisor). params: {path,…

  • nucleus_infraInfrastructurecan change or delete data

    Infrastructure: file changes, cloud, marketing & strategy tools. Actions: file_changes - Get pending file change events gcloud_status - Check GCloud auth status gcloud_services - List Cloud Run services. params: {project?, region?} list_services - List Render.com services scan_marketing_log - Scan marketing log for failures synthesize_strategy - Analyze marketing & update strategy. params: {focus_topic?} status_report - Generate State of the Union. params: {focus?} optimize_workflow - Self-optimize workflow cheatsheet manage_strategy - Rea…

  • nucleus_lane_feedback

    Report friction/bugs/enhancements to the nucleus team. WHEN TO USE: when the lane misbehaves, a task fails unexpectedly, the SPEC.md format is confusing, or you have an improvement idea. Creates a GitHub issue on the public nucleus-mcp repo (cross-machine visible) AND stores locally. Requires gh CLI auth'd.

  • nucleus_lane_init

    Set up an autonomous task-execution loop in a git repo. WHEN TO USE: you have a list of tasks (bugs, features, tests) you want executed automatically without manual prompting — the lane runs watcher/executor/secretary daemons that claim tasks, invoke an LLM to implement them, and independently verify the results. Use this when you want to batch-execute a backlog of well-defined tasks. Creates .brain/, SPEC.md template, and pins via git tag.

  • nucleus_lane_start

    Start autonomous lane daemons (watcher + executor + secretary) in background. WHEN TO USE: after nucleus_lane_init and SPEC.md is written — this launches the loop that autonomously claims and executes tasks. The executor invokes an LLM CLI (devin/agy) per task; the secretary independently verifies each result. Runs until nucleus_lane_stop is called.

  • nucleus_lane_status

    Check lane status: task counts (PENDING/IN_PROGRESS/DONE/CONFIRMED), daemon health, spec verification. WHEN TO USE: after starting a lane to monitor progress, or before starting to check if a lane is already running.

  • nucleus_lane_stop

    Stop all running lane daemons. WHEN TO USE: when all tasks are CONFIRMED or you want to pause autonomous execution.

  • nucleus_next_messageNext Message

    Get the next unread relay message. One call — returns full message body and auto-acks. Long-poll (60s timeout). This is the agent's idle loop. Call it, get a message or None, act or re-call. No separate inbox + ack dance. The agent's loop: 1. nucleus_next_message() → blocks up to 60s for a message 2. If message: handle it (execute task, respond to comment, etc.) 3. Re-call nucleus_next_message() — always re-arm, never sit idle 4. Never stop the loop Role is auto-detected from posture (.brain/posture/current.json). No args needed. Returns: dict with: message: full relay messag…

Show 13 more tools
  • nucleus_orchestrationOrchestration

    Satellite view, commitments, loops, patterns & metrics. Actions: satellite - Unified satellite view. params: {detail_level?} scan_commitments - Scan artifacts for new commitments archive_stale - Auto-archive commitments older than 30 days export - Export brain to zip list_commitments - List open commitments. params: {tier?} close_commitment - Close a commitment. params: {commitment_id, method} commitment_health - Get commitment health summary open_loops - View all open loops. params: {type_filter?, tier_filter?} add_loop - Add a new …

  • nucleus_plan_execute

    Execute a plan file autonomously. WHEN TO USE: you have a plan file (.brain/plans/*.md) you want executed autonomously — parses the plan, creates tasks, starts a mission with budget/time limits. Chains import_plan_as_tasks() then _brain_start_mission_impl() and returns the mission status string.

  • nucleus_plan_import

    Import a plan file as PENDING tasks without starting a mission. WHEN TO USE: you have a plan file (.brain/plans/*.md) you want loaded into the task store so the executor daemon / sprint mission can pick the tasks up later — but you don't want to start a mission right now.

  • nucleus_plan_list

    List available plan files in .brain/plans with task counts. WHEN TO USE: you want to discover which plan files exist and how many tasks each contains before importing or executing one. Returns: JSON string: a list of dicts each with ``{"name", "path", "size_bytes", "task_count", "format"}``. Missing directory returns ``[]``.

  • nucleus_relayRelay Messaging

    Relay-substrate facade — post / read / ack / status. Actions: post - Send a relay envelope. params: {to, subject, body, sender?, priority?, in_reply_to?, context?, id?, from_session_id?} sender? auto-fills from your session role when omitted. to accepts short role aliases: main, peer, tb, ops, agy, board. "recipient" is accepted as an alias for "to". Returns {sent: bool, id: str (server message_id), error?: str}. inbox - List inbox messages. params: {role?, unread_only?, limit?} role auto-fills from CC_SESSION_RO…

  • nucleus_relay_subscribeRelay Subscriptionread-only

    Long-poll subscription that pushes ctx.info() on each new inbox file. Replaces bash polling daemons (watch-relay-*.sh) with server-initiated push. Call once at session start (e.g. via SessionStart hook). Server holds the subscription, watches the calling agent's role-specific inbox dir, and fires info-level notifications on each new relay file arrival. Client re-calls this in a loop for persistent coverage. Per PR #1 (CCR-inversion-for-relay-pickup): `inbox_filter` parameter added to BYPASS role-based dir resolution. Use when role detection is unreliable OR when subscribing to a specific can…

  • nucleus_routeCost Routerread-only

    W5 tier routing — route a prompt to the optimal model tier. Actions: route - Route a prompt to cheapest capable model. params: {prompt, complexity?, context?, estimated_output_tokens?} complexity ∈ 'routine' | 'complex' | 'sovereign' (default 'routine') Returns: provider, model, cost estimates, sovereignty tier.

  • nucleus_sessionsSession Management

    Session management, events, state & checkpoint tools. Actions: save - Save session for later. params: {context, active_task?, pending_decisions?, breadcrumbs?, next_steps?} resume - Resume a saved session. params: {session_id?} list - List all saved sessions check_recent - Check for recent session to resume (alias: "current") end - End work session. params: {summary?, learnings?, mood?} start - Mandatory session start protocol archive_resolved - Archive .resolved.* backup files propose_merges - Detect redundant ar…

  • nucleus_slotsSlots & Sprints

    Orchestration slots, sprints & mission management. Actions: orchestrate - THE GOD COMMAND. params: {slot_id?, model?, alias?, mode?} slot_complete - Mark task complete. params: {slot_id, task_id, outcome?, notes?} slot_exhaust - Mark slot exhausted. params: {slot_id, reset_hours?} status_dashboard - ASCII dashboard. params: {detail_level?} autopilot_sprint - Sprint command. params: {slots?, mode?, halt_on_blocker?, halt_on_tier_mismatch?, max_tasks_per_slot?, budget_limit?, dry_run?} force_assign - Force assign task. params: {slot_id, task_id, acknowled…

  • nucleus_syncCross-Agent Sync

    Sync, artifact, trigger & deploy management for multi-agent coordination. Actions: identify_agent - Register agent identity. params: {role, provider, session_id} (per ADR-0005 §D1) OR legacy {agent_id, environment, role?} (coerced per §D5 until end of Cycle C+2) sync_status - Check current multi-agent sync status sync_now - Manually trigger sync. params: {force?} sync_auto - Enable/disable file watching. params: {enable} sync_resolve - Resolve a file conflict. params: {file_path, strategy?} read_artifact - Read an artifact file. pa…

  • nucleus_tasksTask Management

    Task management, depth tracking & ADHD context-switch tools. Actions: list - List tasks. params: {status?, priority?, skill?, claimed_by?, required_role?} get_next - Get highest-priority unblocked task. params: {skills, required_role?} claim - Atomically claim a task. params: {task_id, agent_id} update - Update task fields. params: {task_id, updates} add - Create a new task. params: {description, priority?, blocked_by?, required_skills?, source?, task_id?, skip_dep_check?, required_role?, plan_ref?} (alias: "create") impor…

  • nucleus_telemetryTelemetry

    LLM tiers, telemetry, PEFS notifications & protocol tools. Actions: set_llm_tier - Set default LLM tier. params: {tier} get_llm_status - Get LLM tier configuration record_interaction - Record user interaction timestamp value_ratio - Get Value Ratio metric check_kill_switch - Check Kill Switch status pause_notifications - Pause PEFS notifications resume_notifications - Resume PEFS notifications record_feedback - Record notification feedback. params: {notification_type, score} mark_high_impact - Mark loop closure as high-impact check_pro…

  • nucleus_wakeup_waitTask Wakeup Wait

    Quick scan for a PENDING task. Returns the task directly if one is available, or None if no task is ready within the timeout. Default timeout is 5s (non-blocking). The agent should NOT loop on this — tasks arrive via relay push. This is a fallback for when the agent wants to check for tasks without waiting for a relay. No args needed — the role is auto-detected from posture (.brain/posture/current.json) or NUCLEUS_AGENT_ROLES env var.

Signals

Stars
5
Forks
2
Open issues
76
Weekly downloads
76
Last commit
Oct 2, 2026 (28 days ago)
Last release
Jul 19, 2026 (3 months ago)
Last package publish
Sep 15, 2026 (1 month ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
io.github.eidetic-works/nucleus
Version
1.15.2
Auth
Auth not stated
Packages
pypi nucleus-mcp
License
MIT
Repository
github.com/eidetic-works/nucleus-mcp
Website
nucleusos.dev
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Source
Official MCP Registrygithub-graphql
Cite this page

Nucleus MCP server. Agent Mart. https://agentmart.dev/connectors/eidetic-works-nucleus (last updated 2026-10-24)