MCP Tools Reference

memstate_get({
  project_id: "myapp"
})

memstate_get({
  project_id: "myapp",
  keypath: "database",
  include_content: true
})

memstate_get({
  project_id: "myapp",
  keypath: "auth",
  at_revision: 42
})

{
  "memories": {
    "project.myapp.auth.provider": "SuperTokens Cloud with passwordless OTP",
    "project.myapp.auth.session": "JWT session management with refresh tokens",
    "project.myapp.auth.middleware": "API key auth for MCP, session auth for web"
  },
  "total_count": 3,
  "revision_number": 15
}

memstate_search({
  query: "how does authentication work",
  project_id: "myapp",
  limit: 3
})

{
  "results": [
    {
      "id": "mem_abc123",
      "summary": "Authentication via SuperTokens Cloud with passwordless OTP",
      "keypath": "auth.provider",
      "score": 0.92,
      "version": 2,
      "created_at": "2026-02-15T10:30:00Z"
    }
  ],
  "total_found": 1,
  "query": "how does authentication work"
}

memstate_remember({
  project_id: "myapp",
  content: "## Task Summary\n- Added OAuth with Google provider\n- Session management via SuperTokens Cloud\n- Key files: auth/oauth.go, middleware/auth.go",
  source: "agent"
})

memstate_remember({
  project_id: "myapp",
  content: "We decided to migrate from session-based auth to JWT tokens. Access tokens have a 1-hour expiry with refresh tokens stored in httpOnly cookies.",
  source: "meeting",
  context: "Architecture decision from sprint planning"
})

{
  "job_id": "job_abc123",
  "status": "pending",
  "message": "Ingestion job enqueued successfully"
}

memstate_set({
  project_id: "myapp",
  keypath: "config.database.port",
  value: "5432"
})

{
  "memory_id": "mem_abc123",
  "action": "created",
  "version": 1,
  "message": "Memory stored at config.database.port"
}

memstate_history({
  project_id: "myapp",
  keypath: "auth.provider"
})

{
  "versions": [
    {
      "id": "mem_abc123",
      "summary": "Session-based authentication",
      "version": 1,
      "created_at": "2026-01-15T08:00:00Z",
      "superseded_by": "mem_def456"
    },
    {
      "id": "mem_def456",
      "summary": "SuperTokens Cloud with passwordless OTP",
      "version": 2,
      "created_at": "2026-02-06T14:30:00Z",
      "superseded_by": null
    }
  ],
  "total_versions": 2
}

memstate_delete({
  project_id: "myapp",
  keypath: "config.old_setting"
})

memstate_delete({
  project_id: "myapp",
  keypath: "config",
  recursive: true
})

{
  "deleted_keypaths": [
    "project.myapp.config.port",
    "project.myapp.config.host",
    "project.myapp.config.old_setting"
  ],
  "deleted_count": 3,
  "message": "Soft-deleted 3 memory(ies) under keypath 'project.myapp.config'"
}

memstate_delete_project({
  project_id: "old-project"
})

{
  "project_id": "old-project",
  "deleted_keypaths": [
    "project.old-project.auth.provider",
    "project.old-project.config.port",
    "project.old-project.database.host"
  ],
  "deleted_count": 3,
  "message": "Soft-deleted project 'old-project' and 3 memory(ies)"
}