Gnosis MCP

1---
2name: manage
3description: CRUD operations for knowledge base docs — add, delete, update metadata, embed. Requires GNOSIS_MCP_WRITABLE=true.
4disable-model-invocation: true
5---
6 
7# Documentation Manager
8 
9CRUD operations for your knowledge base via Gnosis MCP.
10 
11## Usage
12```
13/gnosis:manage add path/to/doc.md                 # Index a document
14/gnosis:manage delete path/to/doc.md               # Remove a document
15/gnosis:manage update path/to/doc.md --tags api,auth  # Update metadata
16/gnosis:manage embed path/to/docs/                 # Bulk embed a directory
17/gnosis:manage search-related path/to/doc.md       # Find related docs
18```
19 
20## Action: $ARGUMENTS
21 
22---
23 
24## `add` — Index a Document
25 
261. **Read the file** from the provided path
272. **Extract metadata**: title (first H1), category (from frontmatter or directory)
283. **Upsert to Gnosis**:
29 
30```
31Tool: mcp__gnosis__upsert_doc
32Arguments:
33  path: "{relative_path}"
34  content: "{file_content}"
35  title: "{extracted_title}"
36  category: "{category}"
37  tags: ["{tag1}", "{tag2}"]
38```
39 
404. **Verify** the doc is retrievable:
41```
42Tool: mcp__gnosis__get_doc
43Arguments:
44  path: "{relative_path}"
45```
46 
475. **Report** path, title, chunk count.
48 
49---
50 
51## `delete` — Remove a Document
52 
531. **Delete from Gnosis**:
54```
55Tool: mcp__gnosis__delete_doc
56Arguments:
57  path: "{relative_path}"
58```
59 
602. **Verify** deletion (get_doc should return empty).
613. **Report** what was removed.
62 
63---
64 
65## `update` — Update Metadata
66 
671. **Parse flags**: `--title`, `--category`, `--tags`, `--audience`
682. **Update via Gnosis**:
69 
70```
71Tool: mcp__gnosis__update_metadata
72Arguments:
73  path: "{relative_path}"
74  title: "{new_title}"
75  category: "{new_category}"
76  tags: ["{tag1}", "{tag2}"]
77```
78 
793. **Report** updated fields.
80 
81---
82 
83## `embed` — Bulk Embed Directory
84 
85Index all markdown files in a directory:
86 
871. **List markdown files** in the target path
882. **For each file**, read and upsert:
89```
90Tool: mcp__gnosis__upsert_doc
91Arguments:
92  path: "{relative_path}"
93  content: "{file_content}"
94  title: "{title}"
95  category: "{category}"
96```
973. **Report** total files processed and chunk counts.
98 
99---
100 
101## `search-related` — Find Related Documents
102 
1031. **Query the link graph**:
104```
105Tool: mcp__gnosis__get_related
106Arguments:
107  path: "{relative_path}"
108```
109 
1102. **Format results** as a list of related docs with relationship types.
111 
112## Notes
113 
114- All write operations require `GNOSIS_MCP_WRITABLE=true`
115- Gnosis auto-chunks documents at H2 boundaries (~4000 chars per chunk)
116- Content hashing prevents re-indexing unchanged files during bulk embed
117- Frontmatter (title, category, audience, tags) is extracted automatically
118