description: Reference for all nine Narnia MCP tools. Search sessions, browse checkpoints, read conversation history, and open the Narnia web UI from any MCP-enabled AI assistant.¶

MCP Tools¶

Narnia exposes nine MCP tools for working with your local Copilot CLI session history. Use them from any AI assistant that supports the Model Context Protocol — including GitHub Copilot CLI, Claude Desktop, Cursor, and VS Code.

Tool Reference¶

Tool	Purpose	Key Parameters
`list_recent_sessions`	List most recently updated sessions	`limit`
`search_sessions`	FTS5 full-text search	`query`, `limit`
`get_session_details`	Full metadata for one session	`sessionId`
`get_session_checkpoints`	All checkpoints for a session	`sessionId`
`get_session_turns`	Paginated conversation turns	`sessionId`, `offset`, `limit`
`get_session_workspace`	Git root and artifact file list	`sessionId`
`list_sessions_by_repository`	Filter by git repository	`repo`
`list_sessions_by_cwd`	Filter by working directory	`cwd`
`open_narnia_ui`	Start web UI and open browser	(none)

Common Workflow¶

After a machine restart, start by listing recent sessions or searching by project name:

list_recent_sessions — scan what was running recently
search_sessions — narrow down by keyword or repo name
get_session_details — confirm the right session before resuming
get_session_checkpoints — read the last checkpoint to restore context

All tools return JSON. Results are read-only — Narnia never modifies your session data.