ultrabrain-mcp
The ultrabrain-mcp server is a local structured reasoning scratchpad and quality gate for AI agents to perform step-by-step deliberation without calling external LLM APIs. It supports:
Start sessions (
ultrabrain_start): Create a named reasoning session for a problem, optionally seeding the first thought and applying a built-in template.Append reasoning steps (
ultrabrain_think): Add canonical thoughts with evidence, assumptions, alternatives, risks, confidence scores, quality metrics, bias detection, and reasoning modes (analytical, critical, socratic, first_principles, etc.).Update existing thoughts (
ultrabrain_update): Strengthen a prior thought with new evidence, confidence adjustments, or metrics.Branch reasoning paths (
ultrabrain_branch): Fork from any prior thought to explore alternative paths in parallel.Merge branches (
ultrabrain_merge): Combine insights from multiple branches via synthesis, best-evidence, or decision strategies.Validate reasoning (
ultrabrain_validate): Check for gaps in evidence, alternatives, verification, bias, and closure readiness.Analyze session quality (
ultrabrain_analyze): Get aggregate quality scores, confidence levels, bias counts, unresolved questions, and recommendations.Review sessions (
ultrabrain_review): Render a session as summary, linear chain, tree, markdown, JSON, or Mermaid diagram.Check status (
ultrabrain_status): Inspect session state, thought count, active branches, and latest quality score.Browse history (
ultrabrain_history): Retrieve recent thought records from a session.Export sessions (
ultrabrain_export): Export as markdown, plain text, or JSON.Get metrics (
ultrabrain_metrics): Retrieve aggregate metrics across sessions, branches, quality, confidence, bias, and reasoning modes.List templates (
ultrabrain_templates): Browse built-in LCV engineering reasoning templates.Reset sessions (
ultrabrain_reset): Clear a single session or all sessions, removing persisted files.
Allows rendering reasoning sessions as Mermaid diagrams, enabling visualization of reasoning chains, branches, and merges.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ultrabrain-mcpstart a reasoning session to analyze the login timeout issue"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ultrabrain-mcp
Install. npm install -g @lcv-ideas-software/ultrabrain-mcp from npmjs.com, or npm install -g @lcv-ideas-software/ultrabrain-mcp --registry=https://npm.pkg.github.com from the GitHub Packages mirror.
Status. Stable. Current release target: v01.02.11 (npm package 1.2.11). See CHANGELOG.md for the full release history.
First publication started at v01.00.00. Public GitHub tags use the LCV display convention v00.00.00; npm keeps normal SemVer.
Change History
The version history at a glance:
Release | Package | Date | Notes |
|
| 2026-08-05 | Adds the read-only |
|
| 05/08/2026 | Moves GitHub administration authority to a non-deploying protected environment, verifies canonical npm registry routing, and separates urgent CodeQL security updates from routine dependency batches. |
|
| 03/08/2026 | Uses checksum-verified npm 12.0.2, accepts only documented |
|
| 28/07/2026 | Completes the provenance-bound 1.2.5/1.2.6 release recovery, preserves the ambiguous 1.2.4 drafts as audit evidence, bundles MCP SDK 1.30.0, removes Socket/StepSecurity integrations, and makes the SDK license regression version-aware. |
|
| 22/07/2026 | Makes draft-release discovery eventual-consistency-safe by waiting for the exact server-issued release id before any asset upload. |
|
| 22/07/2026 | Makes immutable release reconciliation preserve valid |
|
| 22/07/2026 | Binds draft discovery, mutations, asset transfers, and final verification to the exact immutable release identity. |
|
| 22/07/2026 | Corrects npm tarball publication and adds provenance-safe tag/release recovery while preserving the immutable audit trail. |
|
| 22/07/2026 | Ships a self-contained MCP bundle, clean-consumer verification, and provenance-bound multi-registry publication. |
|
| 21/07/2026 | Security patch: updates transitive |
|
| 17/07/2026 | Retro cross-review follow-up: |
|
| 17/07/2026 | Audit remediation: correctness cluster (persistence, state machine, validation, protocol), a |
|
| 15/05/2026 | 4-gate quality directive compliance: added Biome, aligned CI, applied cosmetic source cleanup, and synchronized SERVER_VERSION to |
|
| 12/05/2026 | Refinements for depth enforcement, active thought-reference validation, update record returns, real markdown merge output, optional file persistence, and expanded smoke coverage. |
|
| 12/05/2026 | First LCV Ultrabrain MCP release: branded tool surface, session lifecycle, branching, merging, validation, analysis, prompts, resources, Pages, CI, and publish automation. |
Related MCP server: mcp-llm-eval
What It Does
ultrabrain-mcp is an LCV-created MCP server for local, structured reasoning before engineering work is closed. It gives agents a single branded gate for:
step-by-step reasoning with branches and revisions;
quality metrics, confidence, budget mode, and meta checkpoints;
bias detection and counterexample prompts;
explicit evidence, assumptions, alternatives, risks, and next actions;
session review, validation, metrics, export, prompts, and resources.
The server does not call external LLM APIs. It is a local MCP reasoning scratchpad and quality gate, so source code and private task context stay inside the active MCP host.
Tools
Tool | Purpose |
| Create a reasoning session and optionally seed the first thought. |
| Append the canonical Ultrabrain reasoning step. |
| Strengthen an existing thought with evidence, risks, confidence, or metrics. |
| Create or continue an alternative reasoning path. |
| Merge branch insights into a synthesis, best-evidence path, or decision. |
| Check evidence, alternatives, verification, bias, and closure gaps. |
| Summarize quality, confidence, labels, bias counts, and recommendations. |
| Render a session as summary, linear chain, tree, markdown, JSON, or Mermaid. |
| Show session state, thought count, branches, and latest quality score. |
| Return recent thought records. |
| Export a session as markdown, text, or JSON. |
| Return aggregate session and reasoning metrics. |
| List built-in LCV engineering reasoning templates. |
| Clear one session, or all sessions, removing their persisted files too. |
| Report server version, capabilities, tool surface, data dir, and limits. |
Canonical Example
{
"thought": "Map the failure, list evidence, compare alternatives, and choose the next verification step.",
"thought_number": 1,
"total_thoughts": 4,
"next_thought_needed": true,
"mode": "hybrid",
"step_type": "analysis",
"evidence": ["The failing behavior was reproduced locally."],
"alternatives": ["patch the caller", "patch the shared parser"],
"risks": ["a shared parser change can affect unrelated hosts"],
"next_actions": ["run the focused test", "inspect the shared call path"],
"quality_metrics": {
"logical_consistency": 4,
"completeness": 4,
"objectivity": 4,
"practicality": 5,
"clarity": 5
},
"response_format": "json"
}MCP Configuration
Global npm installation target in the LCV Windows environment:
C:\npm-global\node_modules\@lcv-ideas-software\ultrabrain-mcpUse the MCP server name ultrabrain in host configs:
{
"mcpServers": {
"ultrabrain": {
"command": "ultrabrain-mcp",
"args": []
}
}
}Development checkout and global installation are intentionally separate. Do not create a junction or symlink from C:\npm-global\node_modules\@lcv-ideas-software\ultrabrain-mcp to the workspace checkout.
Optional local persistence can be enabled per host with ULTRABRAIN_STATE_DIR or ULTRABRAIN_PERSIST_DIR. When unset, sessions remain process-local.
Development
npm install
npm test
npm run format:public:check
npm pack --dry-runThe smoke test starts the built MCP server over stdio, lists tools, verifies the branded ultrabrain_* surface, exercises session start, thought, branch, merge, validation, status, export, prompts, and resources.
Release Automation
This repository follows the LCV package baseline:
CI runs on
mainpull requests and pushes.Dependabot tracks npm and GitHub Actions updates.
Pages deploys the static site from
site/usingultrabrain-mcp.lcv.dev.Auto-tagging derives padded public tags from
package.jsonversion.Publish workflow releases to npmjs.com, GitHub Packages, and GitHub Releases.
Third-party actions are pinned to reviewed immutable commit SHAs.
Research
See docs/research-matrix.md. Ultrabrain imports ideas only at the architecture level. It does not copy third-party code, text, branding, non-English localization strings, or external model/API behavior.
Repository conventions
License: Apache-2.0. See NOTICE and THIRDPARTY.
Security disclosure: see SECURITY.md.
Code of conduct: see CODE_OF_CONDUCT.md.
Changelog: CHANGELOG.md.
Contributing: see CONTRIBUTING.md.
Sponsorship: see the repo's
Sponsorbutton or central sponsor page.Action pinning: all GitHub Actions are pinned by full SHA per supply-chain hardening baseline.
Code owners: .github/CODEOWNERS.
Links
npmjs.com: https://www.npmjs.com/package/@lcv-ideas-software/ultrabrain-mcp
GitHub: https://github.com/LCV-Ideas-Software/ultrabrain-mcp
License
Apache-2.0. See LICENSE, NOTICE, and THIRDPARTY.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseBquality-maintenanceMCP server for structured reasoning with cognitive trap detection, verification, and context compressionLast updated5411
- AlicenseAqualityCmaintenanceA local MCP server that packages LLM evaluation gates as reusable CI/CD primitives, enabling AI agents to run datasets against models, score responses, and enforce quality thresholds.Last updated10MIT
- AlicenseAqualityDmaintenanceA structured problem-solving MCP server that breaks down complex tasks into sequential steps, supports iterative refinement and branching, and helps maintain context and explore alternative reasoning paths.Last updated11241MIT
- AlicenseAqualityDmaintenanceStructured reasoning MCP server that decomposes problems into atomic steps (premise, reasoning, hypothesis, verification, conclusion) with confidence scoring, live visualization, and approval feedback.Last updated373MIT
Related MCP Connectors
AI Reasoning Cache & Consensus Layer with 11 MCP tools via Streamable HTTP.
Control plane for autonomous software labor. Agents claim objectives over MCP with audit trail.
Remote MCP for Copilot CLI switch gate MCP, structured receipts, audit logs, and reviewer-ready evid
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/LCV-Ideas-Software/ultrabrain-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server