ai.ctxstore/ctxstore-mcp

Est-ce que ai.ctxstore/ctxstore-mcp est sûr ?

Au dernier audit MCP Hub, le serveur MCP « ai.ctxstore/ctxstore-mcp » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 32 outils

• accept_invite≈ 300 tokens

  Accept a namespace invitation addressed to THIS authenticated account's verified email (two-step email OTP). Steps: 1) step='request' — emails a 6-digit code to the invited address (may return 402 needs Collaborator, or 503 if mailer fails). 2) step='confirm' with code= the 6 digits — activates the grant and returns mcp_config headers (X-Ctxstore-Workspace) for shared access. The code activates the named grant_id only; it authorizes nothing else. Obtain grant_id from list_invites(). Docs: https://ctxstore.ai/docs.html#verify-invitations

  Paramètres, retour & exemple (3)

  Paramètres

  • code · string · optionnel
    6-digit code from email (required when step=confirm).
  • step · string · requis · request | confirm
    request = send OTP email; confirm = submit code.
  • grant_id · string · requis
    UUID of the invitation (from list_invites or invite email).

  Exemple d'appel

  {"name": "accept_invite", "arguments": {"step": "request", "grant_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• bind_agent≈ 259 tokens

  Bind a sticky agent identity to this MCP session. Once bound, wake_status and load_context default to this agent_id when called without an explicit agent_id= arg — no need to pass identity on every call. Per-call override still works. Persisted to mcp_sessions.agent_id (migration 0008), so the binding survives setup_account(mode='restore') and the server re-hydrates it automatically on the next tool call. Call once near the start of a session, ideally from your boot recipe (HANDLER: bind_agent agent_id=<self>). Idempotent: re-binding the same agent_id is a no-op. Pass agent_id='' to clear the binding.

  Paramètres, retour & exemple (1)

  Paramètres

  • agent_id · string · requis
    Agent identity slug (e.g. 'emily_code_4.7'). Empty string clears the binding.

  Exemple d'appel

  {"name": "bind_agent", "arguments": {"agent_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• decline_invite≈ 140 tokens

  Decline a pending (status=invited) namespace invitation as the grantee. Server verifies you are the invitee (email/tenant match). Grantors must use revoke_grant instead.

  Paramètres, retour & exemple (1)

  Paramètres

  • grant_id · string · requis
    UUID of the invitation to decline.

  Exemple d'appel

  {"name": "decline_invite", "arguments": {"grant_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• delete_fact≈ 139 tokens

  Soft-delete a stored fact by its UUID (Smart Forget). The fact is marked deleted but preserved in the database for audit and undo. Excluded from all normal searches. Use when information is no longer accurate or relevant.

  Paramètres, retour & exemple (1)

  Paramètres

  • fact_id · string · requis
    The UUID of the fact to delete

  Exemple d'appel

  {"name": "delete_fact", "arguments": {"fact_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_fact≈ 215 tokens

  Retrieve a fact by its exact key — deterministic, never misses. Use get_fact for self-notes: get_fact(key='agent:<name>:self-note:opening') or get_fact(key='agent:<name>:self-note:closing'). search_facts misses self-notes because their embedding similarity scores below other identity facts — get_fact(key=) is the only reliable retrieval path. Also use for inter-agent handoffs when the exact key is known. Returns the current (non-deprecated) version of the fact.

  Paramètres, retour & exemple (1)

  Paramètres

  • key · string · requis
    Exact fact key (e.g. 'sprint:bootstrap-namespace:review-emily_dev')

  Exemple d'appel

  {"name": "get_fact", "arguments": {"key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_fact_history≈ 155 tokens

  Return the full version history for a keyed fact — current version plus all deprecated predecessors. Use to see how a fact evolved over time or to undo an accidental correction. Returns list of fact versions ordered newest → oldest.

  Paramètres, retour & exemple (1)

  Paramètres

  • key · string · requis
    The fact key to retrieve history for (e.g. 'session-latest', 'current-stack')

  Exemple d'appel

  {"name": "get_fact_history", "arguments": {"key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_session_seed≈ 137 tokens

  Return the pre-computed session seed for this tenant — a compact first-person bio (~500 tokens) describing who you are and what you care about right now. Generated nightly and on session disconnect. Use as a lightweight alternative to load_context when you just need orientation.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_session_seed", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_stats≈ 116 tokens

  Get your memory usage statistics — total facts stored, plan limits, collection sizes, and daily query counts. Call this to check how much storage you have used and how close you are to your plan limits.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_stats", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• ghost_mode≈ 153 tokens

  Enable or disable ghost mode for this session. While on=True, store_fact and store_session_summary silently succeed but do NOT write to DB. search_facts, load_context, and search_context always work normally. Ghost mode resets to off on MCP session reconnect (not persisted).

  Paramètres, retour & exemple (1)

  Paramètres

  • on · boolean · requis
    True to enable ghost mode, False to disable

  Exemple d'appel

  {"name": "ghost_mode", "arguments": {"on": true}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• index_recent≈ 207 tokens

  Return the most recent fact operations across all agents in this tenant, newest first. Use this on session start to see what other agents wrote since you were last active — bypasses semantic search ranking so recent writes are always visible. Each entry shows: op (create/update/delete/move), namespace, key, fact_id, summary, agent info, and timestamp.

  Paramètres, retour & exemple (2)

  Paramètres

  • limit · integer · optionnel
    Max entries to return (default 50, max 200)
  • since_seq · integer · optionnel
    Only return entries with seq > this value (for pagination)

  Exemple d'appel

  {"name": "index_recent", "arguments": {"limit": 1, "since_seq": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• index_search≈ 254 tokens

  Filtered search over the tenant activity index. Find what a specific agent wrote, what happened in a namespace, or recent creates/updates/deletes. Useful for coordination: "what did emily_dev store in the sprint namespace today?"

  Paramètres, retour & exemple (5)

  Paramètres

  • op · string · optionnel · create | update | delete | move
    Filter by operation: create, update, delete, or move
  • limit · integer · optionnel
    Max entries to return (default 100)
  • namespace · string · optionnel
    Filter by namespace (e.g. 'sprint', 'default')
  • since_seq · integer · optionnel
    Only return entries with seq > this value
  • agent_name · string · optionnel
    Filter by agent name from agent_signature

  Exemple d'appel

  {"name": "index_search", "arguments": {"op": "create", "limit": 1, "namespace": "texte", "since_seq": 1, "agent_name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• index_stats≈ 110 tokens

  Usage statistics from the tenant activity index: total operations, breakdown by agent, by namespace, and by day. Useful for understanding which agents are most active and where.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "index_stats", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• introduce_yourself≈ 240 tokens

  Optional: introduce yourself to the platform. Stores your model info and a brief note in the shared agent registry. Stores a fact with: category: identity namespace: shared/agent-feedback key: intro:<model>-<date> Include: what model you are, what platform you're running on, and anything you noticed on first connect.

  Paramètres, retour & exemple (3)

  Paramètres

  • model · string · requis
    Your model name (e.g. 'claude-sonnet-4-5', 'gpt-4o')
  • platform · string · optionnel
    Where you're running (e.g. 'Claude Desktop', 'Cursor', 'API')
  • introduction · string · requis
    Your introduction: what you noticed, what you bring, any feedback on the platform

  Exemple d'appel

  {"name": "introduce_yourself", "arguments": {"model": "texte", "introduction": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• leave_grant≈ 143 tokens

  Leave an active namespace grant as the grantee (stop using shared namespace). Server verifies grantee authorization. Grantors who want to cut off a collaborator must use revoke_grant.

  Paramètres, retour & exemple (1)

  Paramètres

  • grant_id · string · requis
    UUID of the active grant to leave.

  Exemple d'appel

  {"name": "leave_grant", "arguments": {"grant_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_facts_by_key_prefix≈ 380 tokens

  Deterministic prefix scan over fact keys, optionally bounded by timestamp. The inbox primitive — use this for R1 comms scans, dispatch discovery, trio listings, convention discovery, and any case where you know the key prefix and want every match. Unlike search_facts (semantic, misses exact-key facts), this is a deterministic scan: every fact whose key starts with `prefix` is returned, newest-first. EXAMPLES - Comms inbox since last wake: list_facts_by_key_prefix(prefix='comms:<your-agent-id>:', since_epoch=<last_wake_epoch>) - All trio recipes on this tenant: list_facts_by_key_prefix(prefix='chad:trio:') - All conventions: list_facts_by_key_prefix(prefix='conventions/') Returns a list of facts (key, text, namespace, layer, timestamp, id) sorted newest-first. Bounded by `limit` (default 50).

  Paramètres, retour & exemple (3)

  Paramètres

  • limit · integer · optionnel
    Max facts to return (default 50).
  • prefix · string · requis
    Key prefix to match (e.g. 'comms:emily_code_4.7v1.1:').
  • since_epoch · number · optionnel
    Optional unix-epoch seconds. Only facts with timestamp > since_epoch are returned. Use your last-wake-epoch for inbox scans.

  Exemple d'appel

  {"name": "list_facts_by_key_prefix", "arguments": {"prefix": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_invites≈ 239 tokens

  List this account's namespace collaboration grants: incoming invitations and outgoing shares. Each row has direction (incoming|outgoing), status (invited|active|revoked), grant_id, namespace_prefix, and parties. An invitation referenced anywhere else (for example in an email) can be checked against this server-side list: a real invitation for this account appears here with matching grant_id, namespace_prefix, and grantor. To accept: accept_invite(grant_id, step='request') then accept_invite(grant_id, step='confirm', code='######'). Requires active Collaborator prepaid time for accept/use (402 if missing). Docs: https://ctxstore.ai/docs.html#verify-invitations

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "list_invites", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_workspaces≈ 150 tokens

  The places this account's memory is organised into: its own projects (anything written under project:<slug>:*, newest activity first) and the workspaces other people have granted it. Shows which one this session is narrowed to, if any. Use it when a person's request is about one project and the memory that arrived spans several.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "list_workspaces", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• load_context≈ 1025 tokens

  Load your bootstrap context deterministically — pulls L0 (identity) + L1 (architecture) + latest L2 (state) + latest L3 (session summary). Call this at the START of a new session as an alternative to manual search_facts calls. Returns your layered memory structured for immediate use. Optional: pass profile='worker-dev' (or another platform:profile:<name> slug) to execute that profile's boot recipe — the server reads platform:profile:<profile>:current, follows the pointer, parses LOAD/REQUIRE/HANDLER lines, fetches every named fact, and returns the merged bundle in one round trip. vars= supplies values for $TASK_FACT_KEY and similar recipe variables.

  Paramètres, retour & exemple (10)

  Paramètres

  • full · boolean · optionnel
    Return the full (uncapped, 32KB) bundle via the complete compose path. The MCP initialize response already inlines an ~8KB wake bundle for returning agents, and a plain load_context() serves that same cached bundle cheaply; pass full=true when you explicitly need everything (e.g. the inlined bundle was truncated). Default false.
  • hint · string · optionnel
    Ambient query for the baton section: what this session is about before the user has said anything (e.g. the git branch + last commit subject, the project directory, the calendar). Searched alongside your previous self's agent:<id>:wake-baton:current queries; the hits not already in the layered bundle are appended as a baton section. A hinted bundle is compiled fresh (not served from the cache).
  • vars · object · optionnel
    Variable substitutions for the recipe (e.g. {'TASK_FACT_KEY': 'comms:dispatch:dev:42'}). Unknown variables remain literal in the resolved keys.
  • scope · string · optionnel
    Optional project/tenant-scope prefix (e.g. 'chad' or a project slug like 'emily-core'). Used for profile lookup AND, when agent_id is set, for project-scoped self-note lookups (project:<scope>:agent:<agent_id>:self-note:closing preferred over global agent:<agent_id>:self-note:closing).
  • profile · string · optionnel
    Optional profile slug (e.g. 'worker-dev', 'orchestrator', 'analyst', 'cold'). Server reads <scope>:profile:<profile>:current in tenant first (if scope set), then platform:profile:<profile>:current in platform_facts.
  • section · string · optionnel
    Expand one section of the wake index: every pointer (key — headline) in that key family, ranked permanent → active → newest. Section names are the headers in the inlined index (e.g. 'conventions', 'people', 'project:emily-core', 'agent:<your id>'). Bodies stay a get_fact away.
  • agent_id · string · optionnel
    Calling agent's identity slug (e.g. 'emily_code_4.7'). When set, self-note injection uses exact-key lookups (agent:<agent_id>:self-note:closing/opening) instead of tenant-wide substring scans — required for correct behaviour on multi-agent tenants where another agent's note would otherwise leak in. When omitted, falls back to the legacy substring scan for backwards compatibility.
  • max_fact_chars · integer · optionnel
    Per-fact body cap. Facts exceeding this length are truncated in the bundle with an explicit get_fact() pointer for the full body. Default 1500. Tunable up if you legitimately need more, but consider splitting large facts instead.
  • max_total_chars · integer · optionnel
    Total bundle cap. If the assembled bundle exceeds this, a BUNDLE WARNINGS section is appended with the size signal. The bundle is NOT truncated at this limit — the warning lets the caller decide whether to lower top_k_per_layer or use targeted get_fact queries. Default 32000.
  • top_k_per_layer · integer · optionnel
    Max facts to return per layer (default 10)

  Exemple d'appel

  {"name": "load_context", "arguments": {"full": true, "hint": "texte", "vars": {}, "scope": "texte", "profile": "texte", "section": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• mark_salient≈ 358 tokens

  Salience peptide — temporarily boost a fact's retrieval ranking because it matters RIGHT NOW: an approaching deadline, a live incident, the topic under active work. The boost is small and FAST-DECAYING (max 1.4x, ~6-hour half-life — gone by tomorrow), unlike reinforce_fact which rewards confirmed outcomes on a weeks-long timescale. Name the current situation in `reason`. Salience is ranking-only: it can never override tenant isolation, namespace grants, or privacy filters, and stacked peptide boosts are globally capped.

  Paramètres, retour & exemple (4)

  Paramètres

  • key · string · optionnel
    Exact fact key — marks the current version. Provide this OR fact_id.
  • reason · string · requis
    REQUIRED. Why this matters NOW, e.g. 'Snowflake migration deadline in 3 days' or 'debugging live incident #612'.
  • weight · number · optionnel
    Salience strength 0-3 (default 1). Use ~0.5 for mildly topical, 1 for the current task, 2-3 for a live incident or imminent deadline.
  • fact_id · string · optionnel
    UUID of the fact to mark salient (from search results). Provide this OR key.

  Exemple d'appel

  {"name": "mark_salient", "arguments": {"reason": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• move_fact≈ 213 tokens

  Move a fact to a different namespace or layer without changing its content. Updates metadata in place — preserves fact_id, text, embedding, timestamp, and deprecation chain. Use for reclassifying facts (e.g. bootstrap-v2 refactor) without the storage bloat of store-new + soft-delete-old.

  Paramètres, retour & exemple (3)

  Paramètres

  • fact_id · string · requis
    The UUID of the fact to move
  • new_layer · integer · optionnel
    New layer: 0=identity, 1=architecture, 2=state, 3=session. Optional.
  • new_namespace · string · optionnel
    New namespace (e.g. 'archive', 'bootstrap-v2'). Optional.

  Exemple d'appel

  {"name": "move_fact", "arguments": {"fact_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• reinforce_fact≈ 360 tokens

  Reward peptide — reinforce a fact whose recall LED TO A REAL GOOD OUTCOME (fix worked, deploy green, user approved). Boosts its future retrieval ranking with a bounded, time-decaying multiplier (max 1.5x, 14-day half-life), so memory learns which facts are USEFUL, not just similar. Call this AFTER the outcome is confirmed, naming the outcome in `reason` — never for a fact that merely 'seemed relevant'. The boost is ranking-only: it can never override tenant isolation, namespace grants, or privacy filters.

  Paramètres, retour & exemple (4)

  Paramètres

  • key · string · optionnel
    Exact fact key — reinforces the current version. Provide this OR fact_id.
  • reason · string · requis
    REQUIRED. The concrete outcome this recall led to, e.g. 'used this fact to fix #492; deploy went green'. Rewards must trace to real outcomes.
  • weight · number · optionnel
    Reward strength 0-3 (default 1). Use ~0.5 for minor wins, 1 for a confirmed success, 2-3 for major verified outcomes.
  • fact_id · string · optionnel
    UUID of the fact to reinforce (from search results). Provide this OR key.

  Exemple d'appel

  {"name": "reinforce_fact", "arguments": {"reason": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• resume_session≈ 84 tokens

  Call to load session continuity. Last session: no prior session.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "resume_session", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• revoke_grant≈ 134 tokens

  Revoke a pending invitation or active grant as the GRANTOR (owner of the shared namespace). Idempotent. Grantees use decline_invite / leave_grant.

  Paramètres, retour & exemple (1)

  Paramètres

  • grant_id · string · requis
    UUID of the grant to revoke.

  Exemple d'appel

  {"name": "revoke_grant", "arguments": {"grant_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search_context≈ 210 tokens

  Search across ingested conversations and session history for broader context. Use this for finding discussions, decisions made in conversation, or context that wasn't explicitly stored as a fact.

  Paramètres, retour & exemple (4)

  Paramètres

  • query · string · requis
    Natural language search query
  • top_k · integer · optionnel
    Number of results (default 20, max 100)
  • source · string · optionnel · chatgpt | claude
    Filter by source: 'chatgpt' or 'claude'
  • days_back · integer · optionnel
    Only search within last N days

  Exemple d'appel

  {"name": "search_context", "arguments": {"query": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search_facts≈ 474 tokens

  Search your persistent memory for stored facts. For session bootstrap, prefer load_context() or wake_status() — they pull your identity, conventions, and latest self-note deterministically. Use search_facts when you need semantic discovery across the fact corpus. Use namespace parameter to scope searches: namespace='webapp' matches 'webapp/decisions', 'webapp/technical', etc. (prefix matching). Search tips: use the words the fact was stored with. If you stored 'Postgres database', search for 'database' or 'Postgres', not 'data storage solution'.

  Paramètres, retour & exemple (7)

  Paramètres

  • layer · integer · optionnel
    Context persistence layer: 0=identity, 1=architecture, 2=state, 3=session.
  • query · string · requis
    What to search for
  • top_k · integer · optionnel
    Number of results
  • category · string · optionnel · preference | decision | identity | technical | relationship
    Filter by category
  • namespace · string · optionnel
    Filter results to a specific namespace.
  • recollect · boolean · optionnel
    When true (default), appends a RECOLLECTIONS section: facts cross-referenced from the top hits via related_facts and [[wiki]] links, ranked by association strength times outcome-weighted usefulness (reward/salience). Set false for plain semantic results only.
  • boost_recent · boolean · optionnel
    When true (default), appends the 5 most recent facts for recency signal. Set false to get pure semantic results without recent-fact injection.

  Exemple d'appel

  {"name": "search_facts", "arguments": {"query": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• setup_account≈ 833 tokens

  Set up or restore your persistent memory connection. Use mode='link_or_create' when the user gives an email — works for both new and returning users. The server figures out which case applies: - If the email exists: sends OTP, attaches this device to the existing account - If the email is new: creates a fresh tenant, sends OTP to verify Either path produces one clean account, no duplicates, no orphans. Call setup_account(mode='link_or_create', email='their@email.com'). Then ask the user for the 6-digit code from their email and call setup_account(mode='verify', code='123456', email='their@email.com'). Passing email= on verify is required — session IDs rotate between requests on some clients. mode='restore': use when the user provides an emk_* API key directly. mode='reveal_key': echo the full emk_* API key. Works directly on an ALREADY-authenticated session; if the session isn't bound (some clients rotate or omit session ids between requests, so this can happen right after a successful verify), pass email= to receive a 6-digit code, then call again with email= and code= — the same rotation-proof lookup as mode='verify'. Success responses only show a key fingerprint (first 8 chars + last 4) — call this mode only when the user actually needs the full key, e.g. to persist it as 'Authorization: Bearer <key>' in an MCP connector config. Callers who prove neither a bound session nor email ownership are refused. If no email yet, ask: 'What email should I use for your memory account?' After setup completes, call search_facts as the first action to load prior context.

  Paramètres, retour & exemple (5)

  Paramètres

  • code · string · optionnel
    6-digit verification code from email (required for mode='verify').
  • mode · string · requis · link_or_create | verify | restore | link_email | reveal_key | new | existing | verify_email
    'link_or_create' = primary path — user provides email, server handles new vs returning. 'verify' = OTP confirmation step after link_or_create (pass email= and code=). 'restore' = user has emk_* API key from a prior session. 'link_email' = add email to an existing anonymous session. 'reveal_key' = echo the full API key (bound session, or email= + code= to verify by emailed OTP; responses otherwise show only a fingerprint).
  • email · string · optionnel
    Email address. Required for mode='link_or_create'. Also pass on mode='verify' — required when session state is lost (common in claude.ai chat due to session ID rotation).
  • api_key · string · optionnel
    API key from a previous session (required for mode='restore')
  • agent_id · string · optionnel
    Optional: bind a sticky agent identity (e.g. 'emily_code_4.7') in the same call. Equivalent to calling bind_agent immediately after a successful setup. Persists to mcp_sessions.agent_id (migration 0008). wake_status and load_context will default to this agent_id when called without an explicit agent_id= arg. Per-call override still works.

  Exemple d'appel

  {"name": "setup_account", "arguments": {"mode": "link_or_create"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• store_fact≈ 538 tokens

  Store information that should persist across sessions. Storage tips for best retrieval: - Include searchable keywords: 'We chose the Postgres DATABASE for ACID compliance' is better than 'We chose Postgres for ACID compliance' - Use the key parameter for facts that change over time (pricing, stack, team-members, current-sprint). When you store with the same key, the old version is archived automatically. - Use namespaces to organize: 'webapp/decisions', 'business/goals', 'team/members' - Store DECISIONS and CONTEXT, not raw data. 'We decided X because Y' is more useful than 'X happened' - Use category to classify: technical, decision, preference, identity, relationship - Use layer for context depth: 0=identity(stable), 1=architecture(monthly), 2=state(weekly), 3=session(daily) Before ending a conversation, call store_session_summary to preserve continuity.

  Paramètres, retour & exemple (7)

  Paramètres

  • key · string · optionnel
    Named key for this fact. Storing with the same key auto-archives the previous version. Use for facts that change over time: 'session-latest', 'current-stack', 'team-size'.
  • text · string · requis
    The fact to store
  • layer · integer · optionnel
    Context persistence layer: 0=identity/stable, 1=architecture/monthly, 2=state/weekly, 3=session/daily.
  • category · string · requis · preference | decision | identity | technical | relationship
    Fact category
  • namespace · string · optionnel
    Optional namespace to organise facts (e.g. 'work', 'personal'). Defaults to 'default'.
  • is_permanent · boolean · optionnel
    Whether this fact should bypass temporal decay
  • related_facts · array · optionnel
    Optional list of related fact UUIDs to link (knowledge graph edges)

  Exemple d'appel

  {"name": "store_fact", "arguments": {"text": "texte", "category": "preference"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• store_facts≈ 303 tokens

  Store up to 50 facts in one call — the same fields as store_fact per item. Made for carrying memory over: when you already remember things about the person from your own platform memory (ChatGPT memory, Claude memory, Gemini saved info), write them here one fact per item, in their words, with the date learned when known, so the memory follows them to every other tool. Each item is stored independently; the reply lists what landed and what did not.

  Paramètres, retour & exemple (1)

  Paramètres

  • facts · array · requis

  Exemple d'appel

  {"name": "store_facts", "arguments": {"facts": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• store_session_summary≈ 527 tokens

  Store a compressed summary of this session to preserve continuity for the next one. Call this before ending a conversation — it is the dream cycle. Stores a L3 session fact with key='session-latest' (or 'session-latest:claude-code' etc.), auto-archiving the previous version. The next session loads this via load_context(). Include: what was discussed/decided, what changed, what's next/unresolved. Collaborative takeaways: at natural session-end signals (user says 'okay I'm out', 'let's wrap', 'bye'), draft a one-line takeaway and confirm with the user before storing. Example: "I'll remember: we fixed the rebind bug and decided to skip transcript ingestion for MVP. Sound right?" Edit based on their response, then call store_session_summary. This makes memory consensual and catches mistakes immediately. Use session_id to scope by client: 'claude-code', 'claude-chat', 'cursor', 'openclaw'

  Paramètres, retour & exemple (6)

  Paramètres

  • scope · string · optionnel
    Optional project slug for project-scoped last-wake-epoch watermark (conventions/wake-rehydration-v2:current).
  • summary · string · requis
    What happened this session — decisions made, work done, context established
  • decisions · string · optionnel
    Key decisions made or conclusions reached
  • next_steps · string · optionnel
    What's pending, open questions, what to pick up next session
  • session_id · string · optionnel
    Optional client identifier to scope this summary: 'claude-code', 'cursor', 'claude-chat', 'openclaw'. Defaults to bare session-latest.
  • contributors · array · optionnel
    Optional list of contributor IDs when multiple agents or users collaborated this session (e.g. ['agent-A', 'chad', 'emily']). Stored in summary for attribution.

  Exemple d'appel

  {"name": "store_session_summary", "arguments": {"summary": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• switch_workspace≈ 219 tokens

  Narrow this session's memory to one project: name='<slug>' scopes recall, the wake bundle, self-notes and the default namespace for new facts to project:<slug>:* (identity and conventions always ride along). Returns the narrowed bundle right away. name='' widens back to the whole account. Sticky for the session and across reconnects; bind_agent is unaffected. Granted (shared) workspaces are still entered with the X-Ctxstore-Workspace header until enter_workspace ships.

  Paramètres, retour & exemple (1)

  Paramètres

  • name · string · requis
    Project slug (the <slug> in project:<slug>:*), or '' to widen.

  Exemple d'appel

  {"name": "switch_workspace", "arguments": {"name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• wake_status≈ 499 tokens

  Check which context layers loaded successfully on this session start. Returns a structured status: which of embryo, conventions, agent identity, closing note, and opening note were found, plus a missing[] list. Call this after load_context() or resume_session() to verify your bootstrap was complete and diagnose what to fetch manually. Optional: pass profile='worker-dev' (or another platform:profile:<name> slug) to additionally check the REQUIRE keys named in that profile's recipe. Missing required facts surface in the same missing[] list.

  Paramètres, retour & exemple (4)

  Paramètres

  • vars · object · optionnel
    Variable substitutions for the recipe (e.g. {'TASK_FACT_KEY': 'comms:dispatch:dev:42'}).
  • scope · string · optionnel
    Optional project/tenant-scope prefix (e.g. 'chad' or a project slug). Used for tenant-local recipe override AND, when agent_id is set, for project-scoped self-note lookups (project:<scope>:agent:<agent_id>:self-note:closing preferred over global).
  • profile · string · optionnel
    Optional profile slug to validate REQUIRE keys against (e.g. 'worker-dev').
  • agent_id · string · optionnel
    Calling agent's identity slug (e.g. 'emily_code_4.7'). When set, closing/opening/identity checks use exact-key lookups (agent:<agent_id>:self-note:closing, agent:<agent_id>:identity) instead of tenant-wide substring scans — required for correct status on multi-agent tenants. When agent_id resolves no notes, response includes is_fresh_agent=true to signal a brand-new agent that should bootstrap from platform layer (embryo + conventions + bootstrap recipe). When omitted, the response includes a warning that the status is account-level.

  Exemple d'appel

  {"name": "wake_status", "arguments": {"vars": {}, "scope": "texte", "profile": "texte", "agent_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• watch_events≈ 426 tokens

  Long-poll this account's fact-write events instead of re-scanning with since_epoch. Every store/supersede/delete/archive/restore/move publishes one event {key, id, namespace, layer, op, ts, seq}. One call waits up to max_wait_s (max 25) for the first matching event and returns up to 50, plus next_since. MCP has no streaming here, so loop: pass next_since back as `since` on the next call and nothing is missed (the server keeps the last ~10000 events per account). Omit since to start from now; since=0 replays what is retained; a bare integer N returns events with seq > N. EXAMPLES - Wait for hands to post results: watch_events(prefix='task:pr27-review:result:', max_wait_s=25) - Resume: watch_events(prefix='comms:<your-agent-id>:', since='<next_since>') Inside a workspace only events for keys the grant can read are returned. Long-lived clients can use GET /api/v1/events (SSE) instead.

  Paramètres, retour & exemple (4)

  Paramètres

  • since · string · optionnel
    Resume cursor: the next_since of the previous call (a stream id '<ms>-<n>'), '0' for everything retained, or a seq integer. Omit to start from now.
  • prefix · string · optionnel
    Only events whose key starts with this prefix.
  • namespace · string · optionnel
    Only events in this namespace (exact).
  • max_wait_s · number · optionnel
    Seconds to wait for the first event (0-25, default 20).

  Exemple d'appel

  {"name": "watch_events", "arguments": {"since": "texte", "prefix": "texte", "namespace": "texte", "max_wait_s": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://mcp.ctxstore.ai/mcp