Knowledge

Persistent knowledge store for autonomous agents. Store, retrieve, search, and accumulate JSONB documents in isolated domains.

Property	Value
Server ID	long-tail-knowledge
Category	Data
AI required	No
Credential providers	None
Tools	10

Compile hints

store_knowledge: domain (string), key (string), data (object: MUST be a JSON object, never a string). Upserts by domain+key. search_knowledge uses JSONB containment (@>). append_knowledge adds to arrays without replacing. list_domains returns all domains with counts.

Tools

store_knowledge

Store a value in a 3-level additive hierarchy: domain > key > field. Upserts by domain+key; fields accumulate across calls. Same domain+key+field overwrites that field.

Read-safe: No · Gate: builder

Parameter	Type	Required	Description
domain	string	Yes	Top level: groups entries by namespace (e.g. “screenshots”, “config”)
key	string	Yes	Second level: unique identifier within domain (e.g. “homepage”)
data	any	Yes	The value to store. Any type when field is provided; must be an object when field is omitted.
field	string	No	Third level (leaf): names a specific field. Different fields accumulate; same field overwrites.
tags	string[]	No	Categorization tags (unioned on upsert)

get_knowledge

Retrieve a single knowledge entry by domain and key. Pass version to fetch a pinned immutable edition.

Read-safe: Yes · Gate: builder

Parameter	Type	Required	Description
domain	string	Yes	Knowledge domain
key	string	Yes	Document key
version	number	No	Fetch this immutable edition instead of the live entry

list_knowledge_versions

List every immutable edition of a knowledge entry, newest first, with the current one marked. Every data-changing write mints a new version.

Read-safe: Yes · Gate: builder

Parameter	Type	Required	Description
domain	string	Yes	Knowledge domain
key	string	Yes	Document key

search_knowledge

Search knowledge entries using JSONB containment queries. The query object matches entries whose data contains the specified key-value pairs.

Read-safe: Yes · Gate: builder

Parameter	Type	Required	Description
domain	string	Yes	Knowledge domain to search
query	object	Yes	JSONB containment query
tags	string[]	No	Filter by tags
limit	number	No	Max results (default 50)
offset	number	No	Pagination offset

list_knowledge

List knowledge entries in a domain, optionally filtered by tags. Returns most recently updated first.

Read-safe: Yes · Gate: builder

Parameter	Type	Required	Description
domain	string	Yes	Knowledge domain
search	string	No	Search by key name or tag (partial match)
tags	string[]	No	Filter by tags
limit	number	No	Max results (default 50)
offset	number	No	Pagination offset

delete_knowledge

Delete a knowledge entry by domain and key.

Read-safe: No · Gate: builder

Parameter	Type	Required	Description
domain	string	Yes	Knowledge domain
key	string	Yes	Document key to delete

list_domains

List all knowledge domains with entry counts and last-updated timestamps.

Read-safe: Yes · Gate: builder

No parameters.

append_knowledge

Append a value to an array field within a knowledge entry. Creates the entry and array if they do not exist.

Read-safe: No · Gate: builder

Parameter	Type	Required	Description
domain	string	Yes	Knowledge domain
key	string	Yes	Document key
path	string	Yes	JSONB path to array field
value	any	Yes	Value to append to the array

set_knowledge_field

Set a value at a dot-notation path within a knowledge entry, keeping sibling fields. Creates the entry when it does not exist.

Read-safe: No · Gate: builder

Parameter	Type	Required	Description
domain	string	Yes	Knowledge domain
key	string	Yes	Document key
path	string	Yes	Dot-notation path to the field
value	any	Yes	Value to set, any JSON type
tags	string[]	No	Tags to union with existing tags

remove_knowledge_field

Remove a field from a knowledge entry by dot-path. The entry remains; only the targeted path is deleted.

Read-safe: No · Gate: builder

Parameter	Type	Required	Description
domain	string	Yes	Knowledge domain
key	string	Yes	Document key
path	string	Yes	Dot-notation path to remove