MCP tools

Generated from packages/server/src/modules/agents/mcp/tools.ts. Re-run via npm run gen:mcp (also runs as part of npm run prebuild). Do not edit by hand.

Kryton’s MCP server exposes 33 tools. Each is invocable by any AI agent that has been issued a Kryton API key with the appropriate scope.

add_favorite

Star a note (add it to favorites). No-op if already favorited.

Scope: read-write

Parameters:

Name	Type	Required	Description
path	string	yes	Note path to favorite (e.g. ‘folder/my-note.md’)

append_to_note

Append markdown content to the end of an existing note. Adds a leading blank line if the note doesn’t end in one.

Scope: read-write

Parameters:

Name	Type	Required	Description
path	string	yes	Note path to append to
content	string	yes	Markdown content to append

create_folder

Create a new folder in the knowledge base.

Scope: read-write

Parameters:

Name	Type	Required	Description
path	string	yes	Path for the new folder (e.g. ‘projects/new-folder’)

create_note

Create a new markdown note.

Scope: read-write

Parameters:

Name	Type	Required	Description
path	string	yes	Path for the new note (e.g. ‘folder/new-note.md’)
content	string	yes	Markdown content for the note

create_note_from_template

Create a new note from an existing template.

Scope: read-write

Parameters:

Name	Type	Required	Description
templateName	string	yes	Name of the template to use
notePath	string	yes	Path for the new note

delete_folder

Delete an empty folder. Use trash for notes; deleting a non-empty folder fails.

Scope: read-write

Parameters:

Name	Type	Required	Description
path	string	yes	Folder path to delete

delete_note

Delete a note by its path.

Scope: read-write

Parameters:

Name	Type	Required	Description
path	string	yes	Path of the note to delete

empty_trash

Permanently delete every note currently in trash. NOT REVERSIBLE.

Scope: read-write

Parameters: none.

get_backlinks

Get all notes that contain wiki-links pointing to the given path.

Scope: read-only

Parameters:

Name	Type	Required	Description
path	string	yes	Path of the note to find backlinks for

get_daily_note

Get today’s daily note. Returns the note content if it exists, or indicates it doesn’t exist yet.

Scope: read-only

Parameters: none.

get_graph

Get the full wiki-link graph with nodes (notes) and edges (links between them).

Scope: read-only

Parameters: none.

get_note_metadata

Get a note’s title + modifiedAt + size without pulling the full content. Cheap discovery.

Scope: read-only

Parameters:

Name	Type	Required	Description
path	string	yes	Note path

list_daily_notes

List all daily notes (Daily/YYYY-MM-DD.md), newest first.

Scope: read-only

Parameters:

Name	Type	Required	Description
limit	number	no	Max daily notes to return (default 30)

list_favorites

List the paths of notes the user has starred / favorited.

Scope: read-only

Parameters: none.

list_folders

List the folder structure of the knowledge base.

Scope: read-only

Parameters: none.

list_notes

List all notes in the knowledge base. Returns paths and titles.

Scope: read-only

Parameters: none.

list_notes_by_tag

List notes that contain a given tag. Returns paths + titles.

Scope: read-only

Parameters:

Name	Type	Required	Description
tag	string	yes	Tag name without the leading ’#’ (e.g. ‘project’, ‘idea’)

list_recent_notes

List notes sorted by most-recently-modified first. Useful for ‘what was I working on’ queries.

Scope: read-only

Parameters:

Name	Type	Required	Description
limit	number	no	Max notes to return (default 20)

list_shares

List shares the current user owns (notes they’ve shared with others).

Scope: read-only

Parameters: none.

list_shares_with_me

List notes other users have shared with the current user.

Scope: read-only

Parameters: none.

list_tags

List all tags used across notes with their counts.

Scope: read-only

Parameters: none.

list_templates

List available note templates.

Scope: read-only

Parameters: none.

list_trash

List notes currently in trash.

Scope: read-only

Parameters: none.

read_note

Read a note’s markdown content by its path.

Scope: read-only

Parameters:

Name	Type	Required	Description
path	string	yes	Note path relative to notes root (e.g. ‘folder/my-note.md’)

remove_favorite

Unstar a note. No-op if not currently favorited.

Scope: read-write

Parameters:

Name	Type	Required	Description
path	string	yes	Note path to unfavorite

rename_folder

Rename or move a folder. All notes inside move with it; wiki-links update.

Scope: read-write

Parameters:

Name	Type	Required	Description
oldPath	string	yes	Current folder path (e.g. ‘projects/old-name’)
newPath	string	yes	New folder path

rename_note

Rename or move a note. Updates wiki-links + tag/search indexes atomically.

Scope: read-write

Parameters:

Name	Type	Required	Description
oldPath	string	yes	Current note path (e.g. ‘folder/old-name.md’)
newPath	string	yes	New note path (e.g. ‘folder/new-name.md’ or ‘other/folder/old-name.md’)

restore_from_trash

Restore a previously-deleted note from trash back to its original location.

Scope: read-write

Parameters:

Name	Type	Required	Description
path	string	yes	Note path as it appears in list_trash

search

Full-text search across all notes. Returns matching paths, titles, and snippets.

Scope: read-only

Parameters:

Name	Type	Required	Description
query	string	yes	Search query string

share_note

Share a note (or folder) with another user by their user id. Permission is ‘read’ or ‘readwrite’.

Scope: read-write

Parameters:

Name	Type	Required	Description
path	string	yes	Note or folder path to share
sharedWithUserId	string	yes	Recipient’s user id
permission	string	yes	’read’ or ‘readwrite’
isFolder	boolean	no	True if sharing a folder (default false)

unshare_note

Revoke an existing share by its id (get the id from list_shares).

Scope: read-write

Parameters:

Name	Type	Required	Description
shareId	string	yes	Share id returned by list_shares

update_note

Update a note’s content (full replacement). Read the note first to get current content.

Scope: read-write

Parameters:

Name	Type	Required	Description
path	string	yes	Path of the note to update
content	string	yes	New markdown content (replaces entire note)

write_daily_note

Create or replace today’s daily note (at Daily/YYYY-MM-DD.md). Use append_to_note instead if you want to add to existing content without overwriting.

Scope: read-write

Parameters:

Name	Type	Required	Description
content	string	yes	Full markdown content for today’s daily note