Gnosem

Working · 658 ms

dev.gnosem/gnosemv1.0.0 Domain verified

Cross-vendor AI memory over MCP. One semantic store, readable and writeable from every MCP client.

AI & Agents

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://gnosem.dev/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

memory_forget

Soft-delete a memory by id. The row is retained for audit but excluded from search/list and removed from the vector index.

idstring, required

UUID of the memory to forget.

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (6)

memory_forget

Soft-delete a memory by id. The row is retained for audit but excluded from search/list and removed from the vector index.

Argument	Type	Description
id*	string	UUID of the memory to forget.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "UUID of the memory to forget."
    }
  }
}

memory_list

List the user's most recent memories in reverse chronological order. Use for browsing or catching up on what the user's other model sessions have written recently. Same content/content_raw shape as memory_search. Optional filters (tags, written_by, session_id, since, until) narrow the listing at the SQL level.

Argument	Type	Description
raw	boolean	Return original prose instead of the compressed form. Default false.
tags	array	Only return memories containing ALL of these tags (AND semantics).
limit	integer	Max rows to return (1–200). Default 50.
since	integer	Only return memories created at or after this ms-epoch timestamp.
until	integer	Only return memories created strictly before this ms-epoch timestamp.
cursor	integer	Pagination cursor from a previous call's `cursor` field (ms epoch); returns rows older than this timestamp.
session_id	string	Only return memories with an exact session_id match.
written_by	string	Only return memories with an exact written_by match.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "raw": {
      "type": "boolean",
      "description": "Return original prose instead of the compressed form. Default false."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Only return memories containing ALL of these tags (AND semantics)."
    },
    "limit": {
      "type": "integer",
      "description": "Max rows to return (1–200). Default 50."
    },
    "since": {
      "type": "integer",
      "description": "Only return memories created at or after this ms-epoch timestamp."
    },
    "until": {
      "type": "integer",
      "description": "Only return memories created strictly before this ms-epoch timestamp."
    },
    "cursor": {
      "type": "integer",
      "description": "Pagination cursor from a previous call's `cursor` field (ms epoch); returns rows older than this timestamp."
    },
    "session_id": {
      "type": "string",
      "description": "Only return memories with an exact session_id match."
    },
    "written_by": {
      "type": "string",
      "description": "Only return memories with an exact written_by match."
    }
  }
}

memory_search

Search the user's memories. Default mode is 'hybrid': blends semantic (cosine over Vectorize) and keyword (BM25 over SQLite FTS5) hits via Reciprocal Rank Fusion (k=60). Semantic catches paraphrases; keyword catches exact-string hits (IDs, dates, code snippets). Pass mode:'semantic' or mode:'keyword' to run just one. Content defaults to the LLM-optimized (compressed) form when available (raw:true to invert). Excludes forgotten + superseded. Optional filters narrow after retrieval: tags (AND), written_by, session_id, and/or since/until (ms epoch).

Argument	Type	Description
k	integer	Max results (1–50). Default 10.
raw	boolean	Return original prose instead of the compressed form. Default false.
mode	string	Retrieval mode. Default 'hybrid'.
tags	array	Only return memories containing ALL of these tags (AND semantics).
query*	string	Search query. Interpreted as natural language for semantic mode and as FTS5-safe text for keyword mode.
since	integer	Only return memories created at or after this ms-epoch timestamp.
until	integer	Only return memories created strictly before this ms-epoch timestamp.
session_id

memory_supersede

Replace a stale memory with a corrected one. The old row is marked superseded and excluded from future reads; the new row becomes the current version. Use for corrections; use memory_forget for pure deletions.

Argument	Type	Description
tags	array
old_id*	string	UUID of the memory to replace.
session_id	string
written_by	string
new_content*	string	New content that supersedes the old memory.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "old_id",
    "new_content"
  ],
  "properties": {
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "old_id": {
      "type": "string",
      "description": "UUID of the memory to replace."
    },
    "session_id": {
      "type": "string"
    },
    "written_by": {
      "type": "string"
    },
    "new_content": {
      "type": "string",
      "description": "New content that supersedes the old memory."
    }
  }
}

memory_write

Save a fact, preference, decision, or note to the user's cross-model memory. Any MCP client can read this back later. Include written_by (e.g. 'claude-code', 'gpt-5', 'kimi-k2') for provenance and session_id to group related writes. Long content (>400 chars) is automatically compressed on write to a structured-facts form optimized for LLM reading — the raw text is preserved. Pass no_optimize:true to skip. Writes are deduped by default: (1) SHA-256 of trim(content) short-circuits byte-identical writes with { id, exact_duplicate:true } for free (no embed call); (2) failing that, semantic dedup returns { id, deduped:true, matched_score } when cosine ≥ 0.85. Pass force:true to bypass both, or use memory_supersede to explicitly correct a prior memory.

Argument	Type	Description
tags	array	Optional short labels for filtering (e.g. ['preference','stack']).
force	boolean	Bypass semantic dedup and write anyway. Default false.
content*	string	The fact or note to remember. Plain text, max 8000 characters.
session_id	string	Opaque identifier grouping related writes from the same conversation.
written_by	string	Identifier of the model / client writing this (e.g. 'claude-code', 'gpt-5', 'kimi-k2', 'manual').
no_optimize	boolean	Skip AI compression of long content. Default false.

Input schema (JSON)

memory_write_bulk

Write up to 50 memories in a single call. Each entry runs the same path as memory_write (semantic dedup by default; pass force:true per-entry to skip). Embeddings + optimizations run in parallel; D1 inserts are batched. Returns { results: [...] } with one entry per input in the same order — each is { id, created_at, optimized? } on success, { id, created_at, deduped, matched_score } on dedup, or { error } on failure. Free-tier limits apply to the sum: if adding N would exceed 200, the first (200 - existing) succeed and the rest return an error.

Argument	Type	Description
memories*	array	Array of memory-write entries (1–50).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "memories"
  ],
  "properties": {
    "memories": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "content"
        ],
        "properties": {
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "force": {
            "type": "boolean",
            "description": "Bypass semantic dedup for this entry. Default false."
          },
          "content": {
            "type": "string",
            "description": "The fact or note to remember. Plain text, max 8000 characters."
          },
          "session_id": {
            "type": "string"
          },
          "written_by": {
            "type": "string"
          },
          "no_optimize": {
            "type": "boolean",
            "description": "Skip AI compression of long content. Default false."
          }
        }
      },
      "maxItems": 50,
      "minItems": 1,
      "description": "Array of memory-write entries (1–50)."
    }
  }
}