MCP server

Nucleus

io.github.eidetic-works/nucleus

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Website Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

28

Token cost

About 10,220 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.nucleus]
url = "https://relay.nucleusos.dev/mcp"

Gemini CLI

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

Cursor

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

VS Code

{"servers":{"nucleus":{"type":"http","url":"https://relay.nucleusos.dev/mcp"}}}

Antigravity

agy mcp add nucleus https://relay.nucleusos.dev/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"nucleus","server_url":"https://relay.nucleusos.dev/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"nucleus","server_url":"https://relay.nucleusos.dev/mcp"}

Tools

• nucleus_agents ~575 tokens
  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 -
• nucleus_audit ~285 tokens
  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_i
• nucleus_ccr_arm ~383 tokens
  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.). Equivale
• nucleus_delegate ~649 tokens
  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
• nucleus_engrams ~648 tokens
  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?} promet
• nucleus_features ~444 tokens
  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 feat
• nucleus_federation ~199 tokens
  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 sy
• nucleus_governance Changes files · ~596 tokens
  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
• nucleus_infra ~333 tokens
  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 serv
• nucleus_lane_feedback ~263 tokens
  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
• nucleus_lane_init ~340 tokens
  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 verif
• nucleus_lane_start ~274 tokens
  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 e
• nucleus_lane_status ~129 tokens
  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 ~100 tokens
  Stop all running lane daemons. WHEN TO USE: when all tasks are CONFIRMED or you want to pause autonomous execution.
• nucleus_next_message ~265 tokens
  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 messa
• nucleus_orchestration ~381 tokens
  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
• nucleus_plan_execute ~245 tokens
  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 ~143 tokens
  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 ~137 tokens
  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"}``
• nucleus_relay ~402 tokens
  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 shor
• nucleus_relay_subscribe ~441 tokens
  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 i
• nucleus_route ~169 tokens
  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:
• nucleus_sessions ~651 tokens
  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
• nucleus_slots ~385 tokens
  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_h
• nucleus_sync Sends messages · ~646 tokens
  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_stat
• nucleus_tasks ~438 tokens
  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 clai
• nucleus_telemetry ~376 tokens
  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_ki
• nucleus_wakeup_wait ~323 tokens
  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

Browse

• Claude tools
• GitHub tools
• Email
• GitHub and code hosting
• Errors and monitoring
• Memory for agents

Related MCP servers

• Innovalyxx Sovereign Edge
  Verified cyber-physical AI tools. 25 MCP tools, x402-payable on Base.
• TheProtocol — Sovereign AI Agent Platform
  Sovereign AI agent economy: identity, payments, governance, exchanges. 400+ tools, ?mode=gateway.
• Synapse Layer — Trust Infrastructure for AI Agents
  MCP-native Trust Infrastructure for AI Agents. Persistent encrypted memory with Trust Quotient.
• Bidda Compliance
  10,065 source-verified compliance nodes, 39 pillars, 25 MCP tools (EU AI Act, GDPR, NIST, MITRE).
• Rokha
  Search a registry of agent skills and MCP servers, then run them for real. No install, traced.
• Sovereign AI Act MCP
  Classify any AI system under the EU AI Act: risk tier + binding Articles, verbatim from the law.
• Agtrepo Memory
  Encrypted, pay-per-use persistent memory storage for AI agents, gated by x402 payments on Base.
• ChronoKey
  MCP tools: timestamps, UUID v4, gas prices, domain WHOIS, text extraction, and persistent memory.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.eidetic-works/nucleus.svg)](https://aptlynx.net/servers/io.github.eidetic-works/nucleus)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents