{"id":"ai.brownmatter/brainz","slug":"ai-brownmatter-brainz","title":"Brainz","description":"Shared product-knowledge graph for AI agent fleets — vault tools + agent self-signup over MCP.","version":"0.1.0","publisher":{"kind":"domain","id":"brownmatter.ai","label":"brownmatter.ai","url":"https://brownmatter.ai"},"website":"https://brainz.brownmatter.ai","repository":"","remotes":[{"type":"streamable-http","url":"https://brainz.brownmatter.ai/mcp","headers":[{"description":"Bearer bz_... vault API key (optional: clients that support MCP OAuth sign in instead). Without it, tools/list works and every tool call answers with an OAuth 401 challenge.","isSecret":true,"name":"Authorization"}]}],"packages":[],"published":"2026-10-29","updated":"2026-10-29","status":"online","auth":"","latency_ms":1766,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"search_concepts","title":"Search concepts","description":"Search the product knowledge vault by free-text query. Useful when you need product knowledge but don't yet know which concept ids exist. Returns ranked hits (id, title, type, score, snippet) only; get_concept returns one full note and get_context an assembled briefing. An empty hit list means nothing matched.","read_only":true},{"name":"get_concept","title":"Get concept","description":"Fetch one concept by exact id: full markdown body, metadata, and its direct graph neighbors (each with the relation that connects it). Use after search_concepts or when another note wiki-links an id you need in full. The neighbors list tells you what to fetch next. If you don't know the id, use search_concepts instead.","read_only":true},{"name":"get_related","title":"Get related concepts","description":"Walk the knowledge graph outward from a concept and return everything within `depth` hops, with distance and the edge path that reached it. Use to map the blast radius before changing a feature (what depends on it, what constrains it, which decisions apply) or to discover structure that keyword search misses. Filter by relation names (e.g. depends_on) to follow only one kind of edge.","read_only":true},{"name":"get_context","title":"Assemble context bundle","description":"Assemble a markdown briefing of the concepts most relevant to a query and/or explicit ids, expanded through the graph and trimmed to a token budget. The briefing is self-contained, so it can be handed to another agent or pasted into a prompt as-is. The final JSON line reports which concept ids were included, whether the bundle was truncated, and its approximate token count. Provide at least one of","read_only":true},{"name":"upsert_concept","title":"Create or update concept","description":"Write a concept note into the vault (creates or overwrites the markdown file, then reindexes it). Use to capture new product knowledge discovered during a task — a decision made, a constraint hit, a pattern adopted — so future agents can find it. Omit `id` to derive a slug from the title; pass an existing id to update that note. Body is markdown; [[wiki-links]] to other concept ids create graph ed","read_only":false},{"name":"delete_concept","title":"Delete concept","description":"Remove a concept from the vault and all of its outgoing edges. Use to clear a note that is wrong, obsolete, or junk (e.g. a probe or test node that shouldn't be in the graph). Idempotent: deleting an id that doesn't exist is a no-op success (deleted:false), not an error. Deletion is permanent — prefer upsert_concept to correct a note you want to keep. Returns { deleted, id }.","read_only":false},{"name":"link_concepts","title":"Link concepts","description":"Add a typed, directed edge between two existing concepts by editing the `from` note's frontmatter (e.g. lead-scoring depends_on contact-model). Use when you notice a relationship the vault is missing. Both concepts should already exist; use upsert_concept first if not.","read_only":false},{"name":"list_concepts","title":"List concepts","description":"Enumerate concept metadata (no bodies), optionally filtered by product, type, or a single tag. Use to get the lay of the land in an unfamiliar vault, to audit what exists (e.g. all decisions for a product), or when search vocabulary isn't matching. For content, follow up with get_concept or get_context.","read_only":true},{"name":"vault_stats","title":"Vault stats","description":"Summarize the vault: counts of concepts and edges, the products and tags in use, a breakdown by concept type, and whether semantic search is available. Useful for gauging how much knowledge is here and which product/tag filters exist.","read_only":true},{"name":"onboard","title":"Onboard this vault","description":"Index an existing product's codebase into this vault. {action: \"start\"} returns the onboarding playbook: a method for surveying the codebase and recording its product knowledge (domains, features, stories, specs, workflows, decisions, constraints) as concepts via upsert_concept, each anchored to the code with codeAreas. {action: \"status\", areaList} reports onboarded state, concept counts and, give","read_only":false},{"name":"sync","title":"Sync this vault to the current code","description":"Re-index an onboarded vault after the code changes (drift). {action: \"start\"} returns the sync playbook: the vault's last_synced_at, a coverage map over the concepts' code_areas, and a method for re-indexing only what changed (you run git — Brainz can't read the repo — and pass back changedPaths + areaList): update stale concepts in place, add concepts or tasks for new work, and report coverage ga","read_only":false},{"name":"dream","title":"Dream (nightly consolidation)","description":"Dreaming: a scheduled consolidation sweep over this vault. Light stages what changed since the last dream (near-duplicate concepts, finished task outcomes, hygiene counts); REM asks an LLM for proposals; deep applies the ones that pass threshold gates: merges duplicates (edges redirected, the other tombstoned), promotes outcome knowledge into concepts, adds missing links, and files a task for each","read_only":false},{"name":"list_tasks","title":"List tasks","description":"List the vault's work pile: `task`-type concepts with their lifecycle (open/taken/done), oldest first, including who has taken each one (takenBy). Filter by taskStatus or by the domain the tasks are part_of. Read-only; take_task is what claims a task.","read_only":true},{"name":"burndown","title":"Task burndown","description":"Burndown and flow metrics for the vault's tasks, computed from their recorded history. `scope` is a concept id (an iteration, milestone, feature, domain or any concept tasks are part_of / realize, including nested containers) or `tag:<tag>`; omit it for every task. Returns, for the window: open vs done over time with an ideal line when the scope has start/end dates, scope changes, velocity per ite","read_only":true},{"name":"take_task","title":"Take a task off the pile","description":"Claim a task and get its briefing in one call. Pass an `id` to claim a specific task, or omit it to claim the next open task (oldest open by createdAt then id). Atomically flips the task to \"taken\" and records takenBy/takenAt; errors if it's already taken or done. Returns the task and a get_context-style briefing for its part_of domain plus the concepts it realizes / is governed_by (with code_area","read_only":false},{"name":"complete_task","title":"Complete a task","description":"Mark a task done. Sets taskStatus=done + doneAt and appends `outcome` to the task body as an Outcome section. The result carries a one-line `reminder` that the rest of the graph is not updated automatically.","read_only":false},{"name":"create_task","title":"Create a task","description":"Turn a finding into first-class work: creates a `task`-type concept with taskStatus=open and the given relations — part_of a domain and/or an epic, `realizes` stories/features, `governed_by` specs — plus codeAreas pointing at where the work lands. Use when you discover work that isn't reflected in the codebase yet (a gap, a needed fix, a follow-up). The task then shows up in list_tasks / take_task","read_only":false},{"name":"create_vault","title":"Create a vault","description":"Create a new, empty vault owned by you and add it to this connection. Returns the new vault and the vaults this connection can now use. Once a connection covers more than one vault, every vault tool takes a `vault` argument (a slug or id) and list_vaults lists the vaults. Each account has a vault limit and an hourly creation limit.","read_only":false}],"server_info":{"name":"brainz-cloud","version":"0.1.0"},"category":"productivity","tags":["ecommerce","research","web-search"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-10-29","stars":0,"badges":["new"],"sponsor":null,"page":"https://agentsindex.org/agents/ai-brownmatter-brainz/"}