io.github.eidetic-works/nucleus

up checked 2026-11-11T05:38:09.668Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided description

Persistent memory for AI agents — shared .brain across Claude Code, Cursor & Codex

Summary by lookupd

Lets agents share persistent memory and a relay inbox across IDEs, plus manage tasks, plans, audit logs, and spawned sub-agents.

Install

Claude Code, remote (streamable-http)

claude mcp add --transport http nucleus https://relay.nucleusos.dev/mcp

Claude Code, pypi package (stdio)

claude mcp add nucleus -- uvx nucleus-mcp

Codex, remote (streamable-http)

codex mcp add nucleus --url https://relay.nucleusos.dev/mcp

Codex, pypi package (stdio)

codex mcp add nucleus -- uvx nucleus-mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

{
  "mcpServers": {
    "nucleus": {
      "url": "https://relay.nucleusos.dev/mcp"
    }
  }
}

Cursor, pypi package (stdio) → .cursor/mcp.json

{
  "mcpServers": {
    "nucleus": {
      "command": "uvx",
      "args": [
        "nucleus-mcp"
      ]
    }
  }
}

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (28 tools)

Publisher-provided text

• nucleus_governance Governance, Hypervisor & security tools for the Nucleus Agent OS. Actions: auto_fix_loop - Auto-fix loop: Verify->Diagnose->Fix->Verify (3 retries). params
• nucleus_features Feature tracking, proof generation & MCP server mounting. Actions: add - Add a feature. params: {product, name, description, source, version, how
• nucleus_sessions Session management, events, state & checkpoint tools. Actions: save - Save session for later. params: {context, active_task?, pending_decisions?,
• nucleus_tasks Task management, depth tracking & ADHD context-switch tools. Actions: list - List tasks. params: {status?, priority?, skill?, claimed_by?, requi
• nucleus_sync Sync, artifact, trigger & deploy management for multi-agent coordination. Actions: identify_agent - Register agent identity. params: {role, provider, sessi
• nucleus_next_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 m
• nucleus_relay_subscribe 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
• nucleus_ccr_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
• nucleus_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-blocki
• nucleus_orchestration Satellite view, commitments, loops, patterns & metrics. Actions: satellite - Unified satellite view. params: {detail_level?} scan_commitments - Sc
• nucleus_telemetry LLM tiers, telemetry, PEFS notifications & protocol tools. Actions: set_llm_tier - Set default LLM tier. params: {tier} get_llm_status - Get
• nucleus_slots Orchestration slots, sprints & mission management. Actions: orchestrate - THE GOD COMMAND. params: {slot_id?, model?, alias?, mode?} slot_complete
• nucleus_infra Infrastructure: file changes, cloud, marketing & strategy tools. Actions: file_changes - Get pending file change events gcloud_status - Check
• nucleus_agents Agent spawning, critic, swarm, memory, ingestion & dashboard tools. Actions: spawn_agent - Spawn Ephemeral Agent. params: {intent, execute_now?, per
• nucleus_federation Federation management for multi-brain coordination. Actions: status - Get comprehensive federation status join - Join a federation via seed peer. param
• nucleus_engrams Engrams, health, observability, DSoR & tier system tools. Actions: health - Get system health status version - Get Nucleus version
• nucleus_relay Relay-substrate facade — post / read / ack / status. Actions: post - Send a relay envelope. params: {to, subject, body, sender?, priority?, in
• nucleus_route W5 tier routing — route a prompt to the optimal model tier. Actions: route - Route a prompt to cheapest capable model. params: {prompt, complexit
• nucleus_audit W8 Team-tier tamper-evident audit log (SHA-256 hash chain). Actions: log_event - Append an audit event to the chain. params: {event_type, a
• nucleus_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 pick
• 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 ma
• 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 lo
• nucleus_lane_stop Stop all running lane daemons. WHEN TO USE: when all tasks are CONFIRMED or you want to pause autonomous execution.
• 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, o
• 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
• 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
• 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
• 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 imp

Details

• Version: 1.17.1
• Transports: streamable-http, stdio
• Uptime (7 days): 100%
• Median latency: 1400 ms
• First indexed: 2026-11-01T09:28:57.930Z
• Last seen in registry: 2026-11-02T04:17:25.099Z
• Repository: https://github.com/eidetic-works/nucleus-mcp
• Website: https://nucleusos.dev

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.github.eidetic-works/nucleus.svg)](https://lookupd.com/servers/io.github.eidetic-works/nucleus)

• 62071 servers
• Last crawl: 2026-11-11T16:17:25.167Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp