# Vist

A shared Second Brain for you and your LLMs. Notes, tasks, and project context—perfectly synced.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add vist/app

# Browse available tools
npx -y smithery tool list vist/app

# Get full schema for a tool
npx -y smithery tool get vist/app complete_task

# Call a tool
npx -y smithery tool call vist/app complete_task '{}'
```

## Direct MCP Connection

Endpoint: `https://app--vist.run.tools`

## Tools (17)

- `complete_task` — Mark a task as completed. After completing a task, call update_project_state to keep the project context current.
- `create_note` — Create a new note in the user's knowledge base. Requires a title and markdown content. Optionally assign to a folder an…
- `create_task` — Create a new task. Supports priority (low/medium/high), due dates, labels, and optional linking to a source note.
- `get_note` — Get a single note by ID, including its full content, labels, and folder.
- `get_task` — Get a single task by ID, including its status, priority, due date, and labels.
- `list_folders` — Get all folders for the user. Optionally include note counts per folder.
- `list_notes` — Get notes, optionally filtered by folder. Returns titles, IDs, and metadata (not full content).
- `list_tasks` — Returns raw JSON task data for programmatic use. For displaying tasks to the user, use show_task_list instead which ren…
- `load_context` — Loads the full agent persona, current project state, and session context. IMPORTANT: You MUST call this tool before any…
- `query_memory` — Search across agent memories using semantic vector search. Returns ranked results with relevance scores. Useful for fin…
- `record_memory` — Record or update a memory for persistent agent context. Use for decisions (decision_log), stable facts (learned_facts),…
- `search_knowledge_base` — Search across the user's notes and tasks using full-text search. Returns results ranked by relevance with snippets. Use…
- `show_task_list` — Displays the interactive Task List UI to the user. Supports filtering by query, label, status (incomplete/completed/all…
- `sync_agent_memory` — Fast retrieval of memory delta for AI agents. Returns memories prioritized by relevance within token budget. Use for in…
- `update_note` — Update an existing note. Only provided fields are changed.
- `update_project_state` — Update structured project state memory. Merges provided sections with existing content — omitted sections are preserved…
- `update_task` — Update a task's description, due date, priority, or labels. Use complete_task to mark tasks as done.

```bash
# Get full input/output schema for a tool
npx -y smithery tool get vist/app <tool-name>
```
