Myco Brain 1.0.0 documentation

1. Quickstart

Docker Compose from a fresh clone: git clone, then docker compose up -d boots Postgres 16 + pgvector, the MCP server, and the extraction worker with zero configuration, no API keys required for the first run.

2. The 13 MCP tools

Every capability is exposed as a brain_* tool over MCP. Tool contracts are stable within a major version.

• brain_context_packAssembles a token-budgeted context pack for your prompt, the primary retrieval tool.
• brain_searchSearches memory with filters, keyless BM25 full-text, plus semantic vector search via local Ollama embeddings (keyless) or OpenAI.
• brain_whyInspects the provenance chain behind a fact, source documents, extraction model, and evidence.
• brain_neighborsTraverses the knowledge graph from an entity to its connected entities.
• brain_ingestIngests files, URLs, or raw text into memory.
• brain_propose_factLets agents propose facts, proposals don't silently become truth.
• brain_annotateLeaves agent breadcrumb notes on existing memory.
• brain_save_memorySimplified memory ingestion for agents.
• brain_recall_memoryAgent-scoped semantic recall of saved memories.
• brain_get_relatedQueries relational context, with provenance attached.
• brain_statsReturns a workspace memory-health snapshot.
• brain_set_modeSets the surfacing mode (silent, ambient, or audit) for how proactively Myco shares what it knows.
• brain_self_checkPull-only health check that reports what is working, what needs approval, and any problem with a fix.

3. Knowledge graph

Entity extraction, entity resolution, and entity-to-entity relationships. Run it fully local with Ollama, no API key, nothing leaves your machine, or set BRAIN_ANTHROPIC_API_KEY for the most accurate graph.

4. Bulk ingest

Pull a local folder or a whole GitHub repo into memory with one command: mycobrain-ingest ./docs or mycobrain-ingest github:owner/repo. No API key required, set GITHUB_TOKEN only for private repos.

5. Architecture

How the pieces fit: Postgres is the source of truth, the LLM is an advisor, writes are deterministic, deduplicated, and traceable, and your data stays in plain Postgres tables.

6. Roadmap

What ships today, what's next, and the bigger bets, including the managed cloud, which is currently waitlist-only. Direction, not a contract.