promptowl avatar

Context Nest

promptowl/contextnest

A shared, governed brain for AI agents: versioned context with approvals, local or hosted.

GitHub stars
21
tools
47
transport
STDIO, HTTP
env var
1
last updated
Nov 16, 2026

Tools

47 tools

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

context_initOpen a vault: instructions, configuration, path, and what it holds (`include_nodes` to also list nodes)

Open a vault: instructions, configuration, path, and what it holds (`include_nodes` to also list nodes)

No parameter schema in public metadata yet.

context_nestsList every nest in the central registry

List every nest in the central registry

No parameter schema in public metadata yet.

context_skillRender a `type: skill` node as a harness-ready skill file

Render a `type: skill` node as a harness-ready skill file

No parameter schema in public metadata yet.

context_skill_installBuild the file manifest that installs a vault skill locally

Build the file manifest that installs a vault skill locally

No parameter schema in public metadata yet.

context_structureThe nest's structure rules: allowed folders, node types, name formats, templates (`folder` for one folder's rule, `report` for what breaks them)

The nest's structure rules: allowed folders, node types, name formats, templates (`folder` for one folder's rule, `report` for what breaks them)

No parameter schema in public metadata yet.

context_getRead one node (`include_raw`, `verify_checksum`, `allow_rejected`)

Read one node (`include_raw`, `verify_checksum`, `allow_rejected`)

No parameter schema in public metadata yet.

context_listList nodes with folder / type / status / tag filters (`folder`, `recursive`, `include_retired`, `full`, `limit`)

List nodes with folder / type / status / tag filters (`folder`, `recursive`, `include_retired`, `full`, `limit`)

No parameter schema in public metadata yet.

context_foldersList the vault's folders and their document counts, without reading a single document (`folder`, `recursive`)

List the vault's folders and their document counts, without reading a single document (`folder`, `recursive`)

No parameter schema in public metadata yet.

context_searchSearch published nodes, best match first. `mode`: `lexical` (stemmed BM25, default), `semantic` (embeddings), `hybrid` (RRF of both, exact title/#tag matches pinned); `rerank` re-scores the top hits. Each hit carries `score` + per-signal `scores`

Search published nodes, best match first. `mode`: `lexical` (stemmed BM25, default), `semantic` (embeddings), `hybrid` (RRF of both, exact title/#tag matches pinned); `rerank` re-scores the top hits. Each hit carries `score` + per-signal `scores`

No parameter schema in public metadata yet.

context_embedBuild/refresh the embedding index for semantic/hybrid search — published nodes only, re-embeds only new/changed versions, prunes the rest (`rebuild` to start over)

Build/refresh the embedding index for semantic/hybrid search — published nodes only, re-embeds only new/changed versions, prunes the rest (`rebuild` to start over)

No parameter schema in public metadata yet.

context_querySelector query with graph traversal (`include_drafts`)

Selector query with graph traversal (`include_drafts`)

No parameter schema in public metadata yet.

context_resolveResolve a selector to full bodies within a token budget

Resolve a selector to full bodies within a token budget

No parameter schema in public metadata yet.

context_versionsList a document's version history

List a document's version history

No parameter schema in public metadata yet.

context_reconstructReconstruct a specific version

Reconstruct a specific version

No parameter schema in public metadata yet.

context_packsList packs with their `includes` and `excludes`

List packs with their `includes` and `excludes`

No parameter schema in public metadata yet.

context_verifyVerify every hash chain in the vault

Verify every hash chain in the vault

No parameter schema in public metadata yet.

context_forgetForget a node: erase its content from history, keep the hashes (verify still passes), leave a `status: forgotten` stub

Forget a node: erase its content from history, keep the hashes (verify still passes), leave a `status: forgotten` stub

No parameter schema in public metadata yet.

context_forget_logThe forget audit trail — never the forgotten content

The forget audit trail — never the forgotten content

No parameter schema in public metadata yet.

context_archiveArchive a node: out of lists and retrieval, history kept, recoverable

Archive a node: out of lists and retrieval, history kept, recoverable

No parameter schema in public metadata yet.

context_unarchiveBring an archived node back in the status it left

Bring an archived node back in the status it left

No parameter schema in public metadata yet.

context_moveMove a node to another folder, with its history and any PDF

Move a node to another folder, with its history and any PDF

No parameter schema in public metadata yet.

context_createCreate a node — own `id`, `publish: false`, initial `status`, `note`, full `skill` block

Create a node — own `id`, `publish: false`, initial `status`, `note`, full `skill` block

No parameter schema in public metadata yet.

context_updateUpdate a node — rename, set `status`, stamp a `version`, clear metadata with `null`

Update a node — rename, set `status`, stamp a `version`, clear metadata with `null`

No parameter schema in public metadata yet.

context_publishPublish a node; takes a `note`, returns the `chain_hash`

Publish a node; takes a `note`, returns the `chain_hash`

No parameter schema in public metadata yet.

context_deleteDelete a node and its history, recorded in the forget audit log (`purge: true` for none); returns the deleted node's `title`

Delete a node and its history, recorded in the forget audit log (`purge: true` for none); returns the deleted node's `title`

No parameter schema in public metadata yet.

context_importBulk create-and-publish from `documents` and/or existing `ids` — one checkpoint for the batch

Bulk create-and-publish from `documents` and/or existing `ids` — one checkpoint for the batch

No parameter schema in public metadata yet.

context_import_pdfImport a PDF as a `type: pdf` node — extracted text as the body, the PDF kept beside it and bound by SHA-256; pass `id` to version an existing one

Import a PDF as a `type: pdf` node — extracted text as the body, the PDF kept beside it and bound by SHA-256; pass `id` to version an existing one

No parameter schema in public metadata yet.

document_formatGet the document format spec (call before creating docs)

Get the document format spec (call before creating docs)

No parameter schema in public metadata yet.

read_indexReturn the context.yaml index

Return the context.yaml index

No parameter schema in public metadata yet.

read_packResolve and return a context pack with documents

Resolve and return a context pack with documents

No parameter schema in public metadata yet.

list_checkpointsList recent checkpoints

List recent checkpoints

No parameter schema in public metadata yet.

context_reviewControls the review gate. It can `list` held writes, `approve` or `reject` one by `id`, and turn the gate `off` or `on`.

Controls the review gate. It can `list` held writes, `approve` or `reject` one by `id`, and turn the gate `off` or `on`.

No parameter schema in public metadata yet.

vault_infoDeprecated; use context_init

Deprecated; use context_init

No parameter schema in public metadata yet.

read_documentDeprecated; use context_get

Deprecated; use context_get

No parameter schema in public metadata yet.

list_documentsDeprecated; use context_list

Deprecated; use context_list

No parameter schema in public metadata yet.

searchDeprecated; use context_search

Deprecated; use context_search

No parameter schema in public metadata yet.

resolveDeprecated; use context_resolve

Deprecated; use context_resolve

No parameter schema in public metadata yet.

read_versionDeprecated; use context_reconstruct

Deprecated; use context_reconstruct

No parameter schema in public metadata yet.

verify_integrityDeprecated; use context_verify

Deprecated; use context_verify

No parameter schema in public metadata yet.

create_documentDeprecated; use context_create

Deprecated; use context_create

No parameter schema in public metadata yet.

update_documentDeprecated; use context_update

Deprecated; use context_update

No parameter schema in public metadata yet.

publish_documentDeprecated; use context_publish

Deprecated; use context_publish

No parameter schema in public metadata yet.

delete_documentDeprecated; use context_delete

Deprecated; use context_delete

No parameter schema in public metadata yet.

stage_drift_suggestionCapture a drifted live file as a staged suggestion under `_suggestions/`

Capture a drifted live file as a staged suggestion under `_suggestions/`

No parameter schema in public metadata yet.

list_suggestionsList all staged suggestions for a document

List all staged suggestions for a document

No parameter schema in public metadata yet.

approve_suggestionApply a suggestion: patch, bump version, write new canonical bytes, archive

Apply a suggestion: patch, bump version, write new canonical bytes, archive

No parameter schema in public metadata yet.

reject_suggestionReject a suggestion: archive with required reason, emit a chain event

Reject a suggestion: archive with required reason, emit a chain event

No parameter schema in public metadata yet.

Sponsors

Configuration

CONTEXTNEST_VAULT_PATH

Absolute path to your vault. Optional: without it, the server uses a vault above the current directory, then the registry default.

Readme

Context Nest

Versioned, reviewed knowledge for your AI agents. Start solo, scale safely.

by PromptOwl | Website | Whitepaper | Specification | Discord

Context Nest turns scattered knowledge — your repos, docs, Slack threads, tribal know-how — into a structured, queryable brain your AI agents can use.

It's the same instinct as dumping your notes into Obsidian and pointing an LLM at them, with four things that pattern doesn't give you:


View the full README on GitHub

Details

Repository
github.com/promptowl/contextnest
Website
promptowl.ai/contextnest
Package
@promptowl/contextnest-mcp-server
Transport
STDIO, HTTP
Registry
MCP registry, active