AgenticMemory MCP
Provides persistent memory for AI agents including short-term message storage, semantic search, context key-value pairs, long-term entries, and FIFO queues via 17 tools over SSE.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://mcp.agenticmemory.ai/sseWhat you can do with it
- Store and recall agent conversation history
- Perform semantic search on memory spaces
- Manage context key-value pairs
- Handle FIFO agent queues
Source and maintenance
- Maintenance checked
Protocol and capabilities
- Server
- agenticmemory 1.3.0
- MCP protocol
- 2025-06-18
- Tools
- 46 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {}
}Tools
46 advertised
memory_store
Store a message in conversation history. Use for remembering what just happened.
{
"type": "object",
"required": [
"spaceId",
"content"
],
"properties": {
"role": {
"type": "string",
"description": "Role: user, assistant, system, tool (default: user)"
},
"content": {
"type": "string",
"description": "Message content"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
}
}
}{
"type": "object",
"properties": {
"_id": {
"type": "string",
"description": "Message ID"
},
"seq": {
"type": "number",
"description": "Monotonic sequence number within the space"
},
"role": {
"type": "string",
"description": "Message role: user, assistant, system, or tool"
},
"content": {
"type": "string",
"description": "Message text"
},
"spaceId": {
"type": "string",
"description": "Owning memory space ID"
},
"metadata": {
"type": "object",
"description": "Optional caller-supplied metadata"
},
"createdAt": {
"type": "string",
"description": "ISO 8601 creation timestamp"
}
}
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}memory_store_batch
Store multiple messages at once.
{
"type": "object",
"required": [
"spaceId",
"messages"
],
"properties": {
"spaceId": {
"type": "string",
"description": "Memory space ID"
},
"messages": {
"type": "array",
"items": {
"type": "object",
"properties": {
"role": {
"type": "string"
},
"content": {
"type": "string"
}
}
},
"description": "Array of {role, content} messages"
}
}
}{
"type": "object",
"required": [
"messages"
],
"properties": {
"messages": {
"type": "array",
"items": {
"type": "object",
"properties": {
"_id": {
"type": "string",
"description": "Message ID"
},
"seq": {
"type": "number",
"description": "Monotonic sequence number within the space"
},
"role": {
"type": "string",
"description": "Message role: user, assistant, system, or tool"
},
"content": {
"type": "string",
"description": "Message text"
},
"spaceId": {
"type": "string",
"description": "Owning memory space ID"
},
"metadata": {
"type": "object",
"description": "Optional caller-supplied metadata"
},
"createdAt": {
"type": "string",
"description": "ISO 8601 creation timestamp"
}
}
},
"description": "The stored messages"
}
}
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}memory_recall
Recall recent messages from conversation history. Returns newest first.
{
"type": "object",
"required": [
"spaceId"
],
"properties": {
"limit": {
"type": "number",
"description": "Number of messages to return (default: 20)"
},
"before": {
"type": "string",
"description": "Cursor: return messages before this message ID"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
}
}
}{
"type": "object",
"required": [
"messages"
],
"properties": {
"messages": {
"type": "array",
"items": {
"type": "object",
"properties": {
"_id": {
"type": "string",
"description": "Message ID"
},
"seq": {
"type": "number",
"description": "Monotonic sequence number within the space"
},
"role": {
"type": "string",
"description": "Message role: user, assistant, system, or tool"
},
"content": {
"type": "string",
"description": "Message text"
},
"spaceId": {
"type": "string",
"description": "Owning memory space ID"
},
"metadata": {
"type": "object",
"description": "Optional caller-supplied metadata"
},
"createdAt": {
"type": "string",
"description": "ISO 8601 creation timestamp"
}
}
},
"description": "Recalled messages, newest first"
},
"encrypted": {
"type": "boolean",
"description": "True if the space is end-to-end encrypted (content is ciphertext)"
}
}
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}memory_clear
Clear all messages in a memory space.
{
"type": "object",
"required": [
"spaceId"
],
"properties": {
"spaceId": {
"type": "string",
"description": "Memory space ID"
}
}
}{
"type": "object",
"required": [
"cleared"
],
"properties": {
"cleared": {
"type": "boolean",
"description": "True when messages were cleared"
}
}
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}memory_search
Semantic search across past conversations. Finds by meaning, not keywords.
{
"type": "object",
"required": [
"spaceId",
"query"
],
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Filter by tags"
},
"limit": {
"type": "number",
"description": "Max results (default: 10)"
},
"query": {
"type": "string",
"description": "Natural language search query"
},
"scope": {
"type": "string",
"description": "Search scope: all | messages | entries | entities"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
},
"includeEntities": {
"type": "boolean",
"description": "Include entity matches in results"
}
}
}{
"type": "object",
"required": [
"results",
"count"
],
"properties": {
"count": {
"type": "number",
"description": "Number of results returned"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"_id": {
"type": "string",
"description": "Matched entry ID"
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"score": {
"type": "number",
"description": "Relevance score (higher is closer)"
},
"title": {
"type": "string",
"description": "Entry title"
},
"content": {
"type": "string",
"description": "Entry body"
}
}
},
"description": "Matching entries ranked by semantic relevance"
}
}
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}context_set
Set a key-value context entry. Stores structured data (JSON or string).
{
"type": "object",
"required": [
"spaceId",
"key",
"value"
],
"properties": {
"key": {
"type": "string",
"description": "Context key name"
},
"ttl": {
"type": "number",
"description": "Optional TTL in seconds"
},
"value": {
"description": "Value to store (string, number, object, array)"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
}
}
}{
"type": "object",
"required": [
"key"
],
"properties": {
"key": {
"type": "string",
"description": "The key that was set"
},
"value": {
"description": "The stored value (string, number, object, or array)"
}
}
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}context_get
Get a context value by key.
{
"type": "object",
"required": [
"spaceId",
"key"
],
"properties": {
"key": {
"type": "string",
"description": "Context key name"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
}
}
}{
"type": "object",
"required": [
"key"
],
"properties": {
"key": {
"type": "string",
"description": "The requested key"
},
"value": {
"description": "The stored value (string, number, object, or array)"
},
"encrypted": {
"type": "boolean",
"description": "True if the space is end-to-end encrypted (value is ciphertext)"
}
}
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}context_list
List all context keys and values in a space.
{
"type": "object",
"required": [
"spaceId"
],
"properties": {
"spaceId": {
"type": "string",
"description": "Memory space ID"
}
}
}{
"type": "object",
"required": [
"context"
],
"properties": {
"context": {
"type": "object",
"description": "Map of every context key to its stored value"
},
"encrypted": {
"type": "boolean",
"description": "True if the space is end-to-end encrypted (values are ciphertext)"
}
}
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}context_delete
Delete a context key.
{
"type": "object",
"required": [
"spaceId",
"key"
],
"properties": {
"key": {
"type": "string",
"description": "Context key to delete"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
}
}
}{
"type": "object",
"required": [
"deleted"
],
"properties": {
"deleted": {
"type": "boolean",
"description": "True when the key was deleted"
}
}
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}entries_list
List long-term memory entries. Filter by tags.
{
"type": "object",
"required": [
"spaceId"
],
"properties": {
"tags": {
"type": "string",
"description": "Comma-separated tags to filter by"
},
"limit": {
"type": "number",
"description": "Max entries (default: 20)"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
}
}
}{
"type": "object",
"required": [
"entries"
],
"properties": {
"entries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"_id": {
"type": "string",
"description": "Entry ID"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags for filtering"
},
"type": {
"type": "string",
"description": "Entry type: extraction, summary, decision, or artifact"
},
"title": {
"type": "string",
"description": "Entry title"
},
"content": {
"type": "string",
"description": "Entry body"
},
"createdAt": {
"type": "string",
"description": "ISO 8601 creation timestamp"
}
}
},
"description": "Matching long-term entries"
},
"encrypted": {
"type": "boolean",
"description": "True if the space is end-to-end encrypted (content is ciphertext)"
}
}
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}spaces_list
List all memory spaces owned by this API key.
{
"type": "object",
"properties": {}
}{
"type": "object",
"required": [
"spaces"
],
"properties": {
"spaces": {
"type": "array",
"items": {
"type": "object",
"properties": {
"_id": {
"type": "string",
"description": "Space ID (use as spaceId in other tools)"
},
"name": {
"type": "string",
"description": "Human-readable space name"
},
"slug": {
"type": "string",
"description": "URL-safe slug"
},
"usage": {
"type": "object",
"description": "Usage counters (message count, etc.)"
},
"config": {
"type": "object",
"description": "Space configuration (TTLs, limits, encoding)"
},
"createdAt": {
"type": "string",
"description": "ISO 8601 creation timestamp"
}
}
},
"description": "Every memory space owned by the caller"
}
}
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}spaces_create
Create a new memory space.
{
"type": "object",
"required": [
"name",
"slug"
],
"properties": {
"name": {
"type": "string",
"description": "Space name"
},
"slug": {
"type": "string",
"description": "URL-safe slug"
}
}
}{
"type": "object",
"required": [
"space"
],
"properties": {
"space": {
"type": "object",
"properties": {
"_id": {
"type": "string",
"description": "Space ID (use as spaceId in other tools)"
},
"name": {
"type": "string",
"description": "Human-readable space name"
},
"slug": {
"type": "string",
"description": "URL-safe slug"
},
"usage": {
"type": "object",
"description": "Usage counters (message count, etc.)"
},
"config": {
"type": "object",
"description": "Space configuration (TTLs, limits, encoding)"
},
"createdAt": {
"type": "string",
"description": "ISO 8601 creation timestamp"
}
}
}
}
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}queue_push
Enqueue a JSON envelope onto a FIFO queue in a memory space. Use to send work/events to other agents sharing the space.
{
"type": "object",
"required": [
"spaceId",
"queue",
"envelope"
],
"properties": {
"queue": {
"type": "string",
"description": "Queue name (lowercase alphanumeric plus . _ : -, max 64 chars)"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
},
"envelope": {
"type": "object",
"description": "JSON envelope to enqueue (opaque to the server)"
}
}
}{
"type": "object",
"required": [
"queued",
"queue",
"length"
],
"properties": {
"queue": {
"type": "string",
"description": "Queue name"
},
"length": {
"type": "number",
"description": "Queue length after the push"
},
"queued": {
"type": "boolean",
"description": "True when the envelope was enqueued"
}
}
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}queue_pop
Dequeue the oldest envelope from a FIFO queue (returns null if empty). Set wait (max 25s) to long-poll for the next envelope.
{
"type": "object",
"required": [
"spaceId",
"queue"
],
"properties": {
"wait": {
"type": "number",
"description": "Long-poll seconds, 0-25 (default: 0 = return immediately)"
},
"queue": {
"type": "string",
"description": "Queue name"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
}
}
}{
"type": "object",
"required": [
"queue"
],
"properties": {
"item": {
"type": [
"object",
"null"
],
"description": "The dequeued envelope, or null if the queue was empty"
},
"empty": {
"type": "boolean",
"description": "True when the queue was empty"
},
"queue": {
"type": "string",
"description": "Queue name"
},
"encrypted": {
"type": "boolean",
"description": "True if the space is end-to-end encrypted (item is ciphertext)"
}
}
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}queue_peek
Peek at a queue without consuming: returns length and the head envelope.
{
"type": "object",
"required": [
"spaceId",
"queue"
],
"properties": {
"queue": {
"type": "string",
"description": "Queue name"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
}
}
}{
"type": "object",
"required": [
"queue"
],
"properties": {
"head": {
"type": [
"object",
"null"
],
"description": "The head envelope without consuming it, or null if empty"
},
"queue": {
"type": "string",
"description": "Queue name"
},
"length": {
"type": "number",
"description": "Current queue length"
}
}
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}memory_bootstrap
Load full context in one call: recent messages, entries, context, scratchpad. Run this at session start.
{
"type": "object",
"required": [
"spaceId"
],
"properties": {
"query": {
"type": "string",
"description": "Semantic query for relevant entries"
},
"entries": {
"type": "number",
"description": "Number of entries to include (default: 10)"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
},
"messages": {
"type": "number",
"description": "Number of messages to include (default: 20)"
}
}
}{
"type": "object",
"properties": {
"state": {
"type": "object",
"description": "Current working state for the space"
},
"shared": {
"type": "object",
"description": "Shared world context visible to all agents in the space"
},
"entities": {
"type": "array",
"description": "Known entities in the space"
},
"llnPrimer": {
"type": "string",
"description": "LLN primer mode (inline, system, or none)"
},
"encryption": {
"type": "string",
"description": "Encryption mode: none, managed, or e2e"
},
"activeThreads": {
"type": "array",
"description": "Active conversation threads"
},
"recentEntries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"_id": {
"type": "string",
"description": "Entry ID"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags for filtering"
},
"type": {
"type": "string",
"description": "Entry type: extraction, summary, decision, or artifact"
},
"title": {
"type": "string",
"description": "Entry title"
},
"content": {
"type": "string",
"description": "Entry body"
},
"createdAt": {
"type": "string",
"description": "ISO 8601 creation timestamp"
}
}
},
"description": "Most recent long-term entries"
},
"recentMessages": {
"type": "array",
"items": {
"type": "object",
"properties": {
"_id": {
"type": "string",
"description": "Message ID"
},
"seq": {
"type": "number",
"description": "Monotonic sequence number within the space"
},
"role": {
"type": "string",
"description": "Message role: user, assistant, system, or tool"
},
"content": {
"type": "string",
"description": "Message text"
},
"spaceId": {
"type": "string",
"description": "Owning memory space ID"
},
"metadata": {
"type": "object",
"description": "Optional caller-supplied metadata"
},
"createdAt": {
"type": "string",
"description": "ISO 8601 creation timestamp"
}
}
},
"description": "Most recent messages"
},
"contextEncoding": {
"type": "string",
"description": "Context encoding mode (json or lln)"
},
"semanticEntries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"_id": {
"type": "string",
"description": "Entry ID"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags for filtering"
},
"type": {
"type": "string",
"description": "Entry type: extraction, summary, decision, or artifact"
},
"title": {
"type": "string",
"description": "Entry title"
},
"content": {
"type": "string",
"description": "Entry body"
},
"createdAt": {
"type": "string",
"description": "ISO 8601 creation timestamp"
}
}
},
"description": "Entries matched by the optional semantic query"
}
}
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}memory_bootstrap_batch
Parallel bulk fetch: named context keys, entities, and optional semantic results in one call.
{
"type": "object",
"required": [
"spaceId"
],
"properties": {
"keys": {
"type": "array",
"items": {
"type": "string"
},
"description": "Context keys to fetch"
},
"query": {
"type": "string",
"description": "Semantic query (with semantic=true)"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
},
"entities": {
"type": "array",
"items": {
"type": "string"
},
"description": "Entity names to fetch"
},
"semantic": {
"type": "boolean",
"description": "Include semantic search results"
},
"entriesLimit": {
"type": "number",
"description": "Max entries to include"
}
}
}{
"type": "object",
"properties": {}
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}scratchpad_set
Set the scratchpad content for a memory space (ephemeral working memory).
{
"type": "object",
"required": [
"spaceId",
"data"
],
"properties": {
"data": {
"description": "Scratchpad data (any JSON-serializable value)"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
}
}
}{
"type": "object",
"properties": {}
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}scratchpad_get
Get the scratchpad content from a memory space.
{
"type": "object",
"required": [
"spaceId"
],
"properties": {
"spaceId": {
"type": "string",
"description": "Memory space ID"
}
}
}{
"type": "object",
"properties": {}
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}spaces_get
Get a single memory space (config, usage counters).
{
"type": "object",
"required": [
"spaceId"
],
"properties": {
"spaceId": {
"type": "string",
"description": "Memory space ID"
}
}
}{
"type": "object",
"properties": {
"space": {
"type": "object",
"properties": {
"_id": {
"type": "string",
"description": "Space ID (use as spaceId in other tools)"
},
"name": {
"type": "string",
"description": "Human-readable space name"
},
"slug": {
"type": "string",
"description": "URL-safe slug"
},
"usage": {
"type": "object",
"description": "Usage counters (message count, etc.)"
},
"config": {
"type": "object",
"description": "Space configuration (TTLs, limits, encoding)"
},
"createdAt": {
"type": "string",
"description": "ISO 8601 creation timestamp"
}
}
}
}
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}space_export
Export all data in a space (all primitives, schema v2) as a restorable payload.
{
"type": "object",
"required": [
"spaceId"
],
"properties": {
"spaceId": {
"type": "string",
"description": "Memory space ID"
}
}
}{
"type": "object",
"properties": {}
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}space_import
Restore a space from an export payload. Mode: empty-only (default), merge, or replace.
{
"type": "object",
"required": [
"spaceId",
"payload"
],
"properties": {
"mode": {
"enum": [
"empty-only",
"merge",
"replace"
],
"type": "string",
"description": "Import mode (default empty-only)"
},
"payload": {
"type": "object",
"description": "Export payload (from space_export)"
},
"spaceId": {
"type": "string",
"description": "Target memory space ID"
}
}
}{
"type": "object",
"properties": {}
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}entry
Single-entry operations on the tagged/versioned journal: add, get, update, versions, restore.
{
"type": "object",
"required": [
"spaceId",
"action"
],
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags (add/update)"
},
"type": {
"type": "string",
"description": "Entry type: extraction | summary | decision | artifact (add)"
},
"title": {
"type": "string",
"description": "Entry title (add)"
},
"action": {
"enum": [
"add",
"get",
"update",
"versions",
"restore"
],
"type": "string",
"description": "Operation"
},
"reason": {
"type": "string",
"description": "Reason for the update (update)"
},
"source": {
"type": "string",
"description": "Source attribution (add/update)"
},
"content": {
"type": "string",
"description": "Entry body (add/update)"
},
"entryId": {
"type": "string",
"description": "Entry ID (required for get/update/versions/restore)"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
},
"version": {
"type": "number",
"description": "Version number to restore (restore)"
}
}
}{
"type": "object",
"properties": {}
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}entries_add_batch
Append multiple journal entries in one call.
{
"type": "object",
"required": [
"spaceId",
"entries"
],
"properties": {
"entries": {
"type": "array",
"items": {
"type": "object"
},
"description": "Array of {title, content, type?, tags?, source?} entries"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
}
}
}{
"type": "object",
"properties": {}
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}entity
Entity (knowledge-graph node) operations: upsert (create), get, update, delete.
{
"type": "object",
"required": [
"spaceId",
"action",
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Entity name"
},
"role": {
"type": "string",
"description": "Entity role (upsert)"
},
"knows": {
"type": "array",
"items": {
"type": "string"
},
"description": "Facts this entity knows (upsert/update)"
},
"action": {
"enum": [
"upsert",
"get",
"update",
"delete"
],
"type": "string",
"description": "Operation"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
},
"doesNotKnow": {
"type": "array",
"items": {
"type": "string"
},
"description": "Facts this entity does NOT know (upsert/update)"
}
}
}{
"type": "object",
"properties": {}
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}entities_list
List entities in a memory space, optionally filtered.
{
"type": "object",
"required": [
"spaceId"
],
"properties": {
"spaceId": {
"type": "string",
"description": "Memory space ID"
},
"namePrefix": {
"type": "string",
"description": "Filter by name prefix"
},
"knowsContains": {
"type": "string",
"description": "Filter: entities that know this fact"
}
}
}{
"type": "object",
"properties": {}
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}thread
Thread (conversation grouping) operations: create, get, update, delete.
{
"type": "object",
"required": [
"spaceId",
"action"
],
"properties": {
"name": {
"type": "string",
"description": "Thread name (create/update)"
},
"action": {
"enum": [
"create",
"get",
"update",
"delete"
],
"type": "string",
"description": "Operation"
},
"status": {
"type": "string",
"description": "Thread status (update)"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
},
"summary": {
"type": "string",
"description": "Thread summary (update)"
},
"metadata": {
"type": "object",
"description": "Metadata (create)"
},
"threadId": {
"type": "string",
"description": "Thread ID (required for get/update/delete)"
}
}
}{
"type": "object",
"properties": {}
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}threads_list
List threads in a memory space, optionally filtered by status.
{
"type": "object",
"required": [
"spaceId"
],
"properties": {
"status": {
"type": "string",
"description": "Filter by status"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
}
}
}{
"type": "object",
"properties": {}
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}state_get
Get a space's single JSON state snapshot.
{
"type": "object",
"required": [
"spaceId"
],
"properties": {
"spaceId": {
"type": "string",
"description": "Memory space ID"
}
}
}{
"type": "object",
"properties": {}
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}state_set
Replace a space's single JSON state snapshot.
{
"type": "object",
"required": [
"spaceId",
"state"
],
"properties": {
"state": {
"type": "object",
"description": "The full state object (replaces existing)"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
}
}
}{
"type": "object",
"properties": {}
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}shared_memory
Shared world-memory (one-write, all-see) operations: set, get, list, delete.
{
"type": "object",
"required": [
"spaceId",
"action"
],
"properties": {
"key": {
"type": "string",
"description": "Shared key (required for set/get/delete)"
},
"ttl": {
"type": "number",
"description": "TTL in seconds (set)"
},
"value": {
"description": "Value to set (set)"
},
"action": {
"enum": [
"set",
"get",
"list",
"delete"
],
"type": "string",
"description": "Operation"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
}
}
}{
"type": "object",
"properties": {}
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}queue_lease
Non-destructive lease (at-least-once): take the oldest envelope with a visibility timeout. Returns {item, leaseToken, deadline}. Ack with queue_ack, requeue with queue_nack.
{
"type": "object",
"required": [
"spaceId",
"queue"
],
"properties": {
"wait": {
"type": "number",
"description": "Long-poll seconds, 0-25 (default 0)"
},
"queue": {
"type": "string",
"description": "Queue name"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
},
"visibilitySeconds": {
"type": "number",
"description": "Visibility timeout before auto-requeue"
}
}
}{
"type": "object",
"properties": {}
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}queue_ack
Acknowledge a leased envelope (deletes it permanently).
{
"type": "object",
"required": [
"spaceId",
"queue",
"leaseToken"
],
"properties": {
"queue": {
"type": "string",
"description": "Queue name"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
},
"leaseToken": {
"type": "string",
"description": "Lease token from queue_lease"
}
}
}{
"type": "object",
"properties": {}
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}queue_nack
Negative-acknowledge a leased envelope (requeues it to the tail).
{
"type": "object",
"required": [
"spaceId",
"queue",
"leaseToken"
],
"properties": {
"queue": {
"type": "string",
"description": "Queue name"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
},
"leaseToken": {
"type": "string",
"description": "Lease token from queue_lease"
}
}
}{
"type": "object",
"properties": {}
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}queue_dlq
Dead-letter queue operations: push a failed envelope, or list DLQ items.
{
"type": "object",
"required": [
"spaceId",
"queue",
"action"
],
"properties": {
"limit": {
"type": "number",
"description": "Max items (list)"
},
"queue": {
"type": "string",
"description": "Queue name"
},
"action": {
"enum": [
"push",
"list"
],
"type": "string",
"description": "Operation"
},
"offset": {
"type": "number",
"description": "Offset (list)"
},
"reason": {
"type": "string",
"description": "Failure reason (push)"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
},
"envelope": {
"type": "object",
"description": "Envelope to dead-letter (push)"
}
}
}{
"type": "object",
"properties": {}
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}stream_append
Append an entry to a stream (XADD). Returns the entry ID.
{
"type": "object",
"required": [
"spaceId",
"stream",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "Entry data (flat object)"
},
"maxlen": {
"type": "number",
"description": "Approximate max stream length (trim)"
},
"stream": {
"type": "string",
"description": "Stream name"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
}
}
}{
"type": "object",
"properties": {}
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}stream_read
Ranged read from a stream (XRANGE/XREVRANGE).
{
"type": "object",
"required": [
"spaceId",
"stream"
],
"properties": {
"end": {
"type": "string",
"description": "End ID (default +)"
},
"count": {
"type": "number",
"description": "Max entries"
},
"start": {
"type": "string",
"description": "Start ID (default -)"
},
"stream": {
"type": "string",
"description": "Stream name"
},
"reverse": {
"type": "boolean",
"description": "Read newest-first (XREVRANGE)"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
}
}
}{
"type": "object",
"properties": {}
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}stream_info
Stream info: length and consumer groups (XLEN + XINFO GROUPS).
{
"type": "object",
"required": [
"spaceId",
"stream"
],
"properties": {
"stream": {
"type": "string",
"description": "Stream name"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
}
}
}{
"type": "object",
"properties": {}
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}stream_delete
Delete a stream entirely (hot + durable) — irreversible.
{
"type": "object",
"required": [
"spaceId",
"stream"
],
"properties": {
"stream": {
"type": "string",
"description": "Stream name"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
}
}
}{
"type": "object",
"properties": {}
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}stream_group
Consumer-group operations on a stream: create, destroy, read (XREADGROUP), ack (XACK), pending (XPENDING), claim (XCLAIM/XAUTOCLAIM).
{
"type": "object",
"required": [
"spaceId",
"stream",
"action",
"group"
],
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Entry IDs (ack/claim)"
},
"from": {
"type": "string",
"description": "Start position for create (default $ = new entries only, use 0 for all)"
},
"count": {
"type": "number",
"description": "Max entries (read/pending/claim)"
},
"group": {
"type": "string",
"description": "Consumer group name"
},
"start": {
"type": "string",
"description": "Autoclaim scan start (claim)"
},
"action": {
"enum": [
"create",
"destroy",
"read",
"ack",
"pending",
"claim"
],
"type": "string",
"description": "Operation"
},
"stream": {
"type": "string",
"description": "Stream name"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
},
"consumer": {
"type": "string",
"description": "Consumer name (read/pending/claim)"
},
"minIdleMs": {
"type": "number",
"description": "Min idle ms before claim (claim)"
},
"waitSeconds": {
"type": "number",
"description": "Long-poll seconds ≤25 (read)"
}
}
}{
"type": "object",
"properties": {}
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}kv_hash
Hash operations (Redis-hash semantics, write-through durable): set, get (whole hash), keys, get_field, del_field, delete, setnx (atomic set-if-absent), cas (atomic compare-and-set).
{
"type": "object",
"required": [
"spaceId",
"name",
"action"
],
"properties": {
"name": {
"type": "string",
"description": "Hash name"
},
"field": {
"type": "string",
"description": "Single field (get_field/del_field/setnx/cas)"
},
"value": {
"description": "Value (setnx/cas)"
},
"action": {
"enum": [
"set",
"get",
"keys",
"get_field",
"del_field",
"delete",
"setnx",
"cas"
],
"type": "string",
"description": "Operation"
},
"fields": {
"type": "object",
"description": "Fields to set (set)"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
},
"expected": {
"description": "Expected current value (cas — omit to require absent)"
},
"deleteField": {
"type": "boolean",
"description": "CAS: delete the field instead of setting (cas)"
}
}
}{
"type": "object",
"properties": {}
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}kv_string
String operations with optional TTL (survives rebuild): set, get (includes remaining ttlMs), delete.
{
"type": "object",
"required": [
"spaceId",
"name",
"action"
],
"properties": {
"name": {
"type": "string",
"description": "String key name"
},
"value": {
"type": "string",
"description": "Value to set (set)"
},
"action": {
"enum": [
"set",
"get",
"delete"
],
"type": "string",
"description": "Operation"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
},
"ttlSeconds": {
"type": "number",
"description": "TTL in seconds (set)"
}
}
}{
"type": "object",
"properties": {}
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}kv_set
Set operations (Redis-set semantics): add, members (with size), contains, remove, delete.
{
"type": "object",
"required": [
"spaceId",
"name",
"action"
],
"properties": {
"name": {
"type": "string",
"description": "Set name"
},
"action": {
"enum": [
"add",
"members",
"contains",
"remove",
"delete"
],
"type": "string",
"description": "Operation"
},
"member": {
"type": "string",
"description": "Single member (contains)"
},
"members": {
"type": "array",
"items": {
"type": "string"
},
"description": "Members (add/remove)"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
}
}
}{
"type": "object",
"properties": {}
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}usage_get
Get current usage vs plan limits for the authenticated tenant.
{
"type": "object",
"properties": {}
}{
"type": "object",
"properties": {}
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}webhook
Per-space webhook subscriptions: create, list, delete.
{
"type": "object",
"required": [
"spaceId",
"action"
],
"properties": {
"url": {
"type": "string",
"description": "Webhook URL (create)"
},
"action": {
"enum": [
"create",
"list",
"delete"
],
"type": "string",
"description": "Operation"
},
"events": {
"type": "array",
"items": {
"type": "string"
},
"description": "Event types to subscribe to (create)"
},
"filter": {
"type": "object",
"description": "Event filter (create)"
},
"hookId": {
"type": "string",
"description": "Webhook ID (delete)"
},
"secret": {
"type": "string",
"description": "Signing secret (create)"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
}
}
}{
"type": "object",
"properties": {}
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}knowledge
Knowledge-base operations: create (with documents), list, delete, query (smart retrieval).
{
"type": "object",
"required": [
"spaceId",
"action"
],
"properties": {
"kbId": {
"type": "string",
"description": "KB ID (delete/query)"
},
"name": {
"type": "string",
"description": "KB name (create)"
},
"slug": {
"type": "string",
"description": "KB slug (create/query)"
},
"limit": {
"type": "number",
"description": "Max results (query)"
},
"query": {
"type": "string",
"description": "Query text (query)"
},
"action": {
"enum": [
"create",
"list",
"delete",
"query"
],
"type": "string",
"description": "Operation"
},
"spaceId": {
"type": "string",
"description": "Memory space ID"
},
"documents": {
"type": "array",
"items": {
"type": "object"
},
"description": "Documents to index (create)"
},
"description": {
"type": "string",
"description": "KB description (create)"
}
}
}{
"type": "object",
"properties": {}
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1998 ms
- 95th percentile latency
- 1998 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1998 ms · metadata changed · 46 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport sse agenticmemory-mcp https://mcp.agenticmemory.ai/sseCline
{
"mcpServers": {
"agenticmemory-mcp": {
"type": "sse",
"url": "https://mcp.agenticmemory.ai/sse",
"disabled": false
}
}
}Gemini CLI
gemini mcp add --transport sse agenticmemory-mcp https://mcp.agenticmemory.ai/sseLet your agent find its tools
Find servers like AgenticMemory MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.