Linko

Adds a book to the signed-in user's Linko library by catalog identity. It searches the catalog by title, optionally narrowed by author or ISBN, and creates a Book resource only when exactly one catalog match is found. It never saves a discovered web page URL as the book. When several or no books match, it returns candidates or a clarification request and creates nothing; a call with a candidate's title and book_id adds that book.

add_book

Adds a non-book web link or an existing named resource to the signed-in user's Linko library through Linko's add-to-library flow. Incomplete metadata of an existing link may be refreshed and replaced. Books are added with add_book (title, author, ISBN or catalog book_id), not as a link to a book page. The book_id argument remains available for backwards compatibility.

add_resource

Reports how Linko organized notes and resources the user just saved: state, topics, tags and the related note Linko found. Reports only items in the linked account.

linko_save_status

Saves a private Linko note for the signed-in user from plain text, markdown or structured block content, optionally with tags and topics and a resource. It suits text the user asked to save as it stands; when the exact wording isn't confirmed, draft_note shows the user an editable draft instead. Notes saved through this tool are always private. A request_id UUID makes a save safe to retry: the same request_id returns the same note, and each new note has its own. Calls without a request_id remain supported but are not safe to retry automatically. Saving is separate from background organization, reported in organize.state. Exact tag, topic and resource IDs disambiguate names.

create_note

Shows a note draft in Linko's editor, where the user can review, edit and save it themselves. It suits keeping something from the conversation when the user hasn't confirmed the exact text, or has asked to review or edit a note before saving. It saves nothing: the user saves from the editor, always privately. create_note is for text the user has already confirmed as it should be saved.

draft_note

Edits an existing Linko note for the signed-in user by note_id: title, content, visibility, tags and topics, and resource assignment. Existing content and assignments can be replaced. Visibility changes (private) are for when the user asks to change who can see the note; the private parameter describes what each value means.

edit_note

Finds the user's notes and resources to mention in a message.

linko_mentions

Finds the user's own notes related to one of their notes.

linko_related

Opens the user's Linko library to browse and search their notes and saved resources. The user chooses which records to add to this conversation; opening shares none of them and saves nothing. query and kind open a filtered view. Resources hold Linko's descriptions and source links, not necessarily the full article or book text. For a note the user wants to review before it is saved, draft_note shows an editable draft. Text-only hosts receive the first page of results as text.

open_linko

Lists tags and topics in the linked account, including empty personal tags, or filters by exact name, ID or kind. Returns IDs, tag/topic kinds, direct parents and account-specific note/resource counts. An empty library returns an empty list, without substituting recommended public topics. has_more reports further pages.

list_tags_and_topics