brainos-hq avatar

BrainOS

brainos-hq/brain-os

One memory for every AI tool: your AI picks up where you left off, with decisions and plans.

GitHub stars
6
tools
24
transport
STDIO
last updated
Nov 17, 2026

Tools

24 tools

Public tool metadata for what this MCP can expose to an agent.

entity_readRead operational state of one or all tracked entities

Read operational state of one or all tracked entities

No parameter schema in public metadata yet.

entity_updateUpdate entity state — status, momentum, blockers, next moves

Update entity state — status, momentum, blockers, next moves

No parameter schema in public metadata yet.

decision_logLog a strategic decision with reasoning and alternatives

Log a strategic decision with reasoning and alternatives

No parameter schema in public metadata yet.

decision_checkCheck a proposed action against active decisions — returns clear/caution/conflict

Check a proposed action against active decisions — returns clear/caution/conflict

No parameter schema in public metadata yet.

decision_refreshRefresh an existing decision: bump review_date, append evidence, change status. Metadata only — does not mutate decision content.

Refresh an existing decision: bump review_date, append evidence, change status. Metadata only — does not mutate decision content.

No parameter schema in public metadata yet.

decision_reviewReview-debt inbox: buckets overdue decisions (still-true / changed / archive / needs-evidence) and recommends an action for each. Read-only — proposes, you confirm. Auto-detects duplicate-stub decisions.

Review-debt inbox: buckets overdue decisions (still-true / changed / archive / needs-evidence) and recommends an action for each. Read-only — proposes, you confirm. Auto-detects duplicate-stub decisions.

No parameter schema in public metadata yet.

context_resolveResolve which entity the current work belongs to, from explicit mention / alias / files / lexical signals. Deterministic and confidence-scored — routes known context, never guesses intent.

Resolve which entity the current work belongs to, from explicit mention / alias / files / lexical signals. Deterministic and confidence-scored — routes known context, never guesses intent.

No parameter schema in public metadata yet.

focus_getGet prioritized recommendations on what to work on

Get prioritized recommendations on what to work on

No parameter schema in public metadata yet.

project_evidence_scanRead-only scan of a repo's native operating state (STATE.md, FLAGS, HANDOFF, ROADMAP/PLAN/TODO, git activity, dirty files) for human gates, next moves, and do-not-touch — grounds focus in repo reality.

Read-only scan of a repo's native operating state (STATE.md, FLAGS, HANDOFF, ROADMAP/PLAN/TODO, git activity, dirty files) for human gates, next moves, and do-not-touch — grounds focus in repo reality.

No parameter schema in public metadata yet.

operational_state_checkEphemeral read-only comparison of allowlisted package/Git facts with optional claimed and desired state; reports evidence-backed drift/conflict without applying changes.

Ephemeral read-only comparison of allowlisted package/Git facts with optional claimed and desired state; reports evidence-backed drift/conflict without applying changes.

No parameter schema in public metadata yet.

brain_setupSet up Brain OS in the open project from chat. Previews the folder and exact file plan, then writes only after the user confirms (single-use preview token). Never overwrites existing instruction files. Local stdio server only.

Set up Brain OS in the open project from chat. Previews the folder and exact file plan, then writes only after the user confirms (single-use preview token). Never overwrites existing instruction files. Local stdio server only.

No parameter schema in public metadata yet.

pattern_detectAnalyze patterns across all entities

Analyze patterns across all entities

No parameter schema in public metadata yet.

memory_checkAudit memory quality — flags stale data, contradictions, noise

Audit memory quality — flags stale data, contradictions, noise

No parameter schema in public metadata yet.

memory_commitEnd-of-session commit — save all state changes

End-of-session commit — save all state changes

No parameter schema in public metadata yet.

semantic_recallSearch memory by meaning using natural language

Search memory by meaning using natural language

No parameter schema in public metadata yet.

audit_logRead the full mutation history — what changed, when, by whom

Read the full mutation history — what changed, when, by whom

No parameter schema in public metadata yet.

wrap_checkDetect whether meaningful state changes have accumulated since the last wrap

Detect whether meaningful state changes have accumulated since the last wrap

No parameter schema in public metadata yet.

wrap_autoNon-interactive safety-net wrap: applies low-risk fields and stages high-risk changes for review

Non-interactive safety-net wrap: applies low-risk fields and stages high-risk changes for review

No parameter schema in public metadata yet.

plan_setSet an ordered plan for an entity — step 1 becomes active next_move

Set an ordered plan for an entity — step 1 becomes active next_move

No parameter schema in public metadata yet.

plan_advanceComplete or skip a step (requires evidence/reason) — auto-promotes next

Complete or skip a step (requires evidence/reason) — auto-promotes next

No parameter schema in public metadata yet.

plan_addAdd steps to an existing plan

Add steps to an existing plan

No parameter schema in public metadata yet.

plan_readView plan progress and current step

View plan progress and current step

No parameter schema in public metadata yet.

risk_assessClassify risky actions before execution, including public-release and destructive-operation risks

Classify risky actions before execution, including public-release and destructive-operation risks

No parameter schema in public metadata yet.

action_guardApply built-in guard templates to common high-risk actions before proceeding

Apply built-in guard templates to common high-risk actions before proceeding

No parameter schema in public metadata yet.

Sponsors

Readme

Brain OS: Forget your decisions? Brain OS remembers.

npm version MIT License MCP Compatible brainos-hq.com brainOS-HQ/brain-os MCP server

One memory across your AI tools. Keep decisions, plans and next steps connected across ChatGPT, Claude, Cursor and other supported AI apps.

Brain OS


View the full README on GitHub

Details

Repository
github.com/brainos-hq/brain-os
Website
brainos-hq.com
Category
AI & LLM Tools
Package
brain-os
Transport
STDIO
Registry
MCP registry, active

Related AI & LLM Tools MCP servers

View all
1freema avatarPixelForgefreema/pixelforge-mcpForge pixel art sprites, animations, tilesets and game assets with Google Gemini.6stars
2hmakt99 avatarAGASTHYhmakt99/agasthyRead-only dev-machine intelligence: repos, packages, ports, agent sessions and token cost.6stars
3bitbond avatarToken Toolbitbond/token-tool-mcpDeploy compliant ERC-20 tokens from any AI agent. 17 tools, 10 networks, CertiK-audited.6stars
4scrollmark avatarSocialGPTscrollmark/socialgpt-mcpSocial media analytics, video analysis, and competitor intel for any MCP-compatible AI agent.6stars
5sharozdawa avatarAi Visibilitysharozdawa/ai-visibilityTrack brand visibility across ChatGPT, Perplexity, Claude, and Gemini.6stars
6sowiedu avatarEdictsowiedu/edictAI-agent programming language. JSON AST in, WASM out. Typed, effect-tracked, Z3-verified.6stars