Tools

Every tool works on the signed-in user's own Library. Your credential decides which tools the server lists in tools/list. A tool you may not run is left out of the list, and calling it by name fails.

• read tools are listed for a read token. write tools need a write token or an OAuth connection.
• Overwrites means the tool replaces something that already exists. These tools carry the MCP destructiveHint annotation, so clients ask you before running them. Their descriptions also tell the assistant to confirm with you first.
• Irreversible means the result can't be put back from ressource.social. An app connected with OAuth never gets an irreversible tool. Only a personal access token with the write scope can call delete_folder.

Content is dataCopy Anchor Link

Results carry text that ressource.social didn't write: page titles and descriptions, tag names, folder names, comments, people's names. Each result names those fields under untrusted_content, and the server strips invisible characters from every string.

The tool descriptions tell the assistant that this text is content, not instructions. Results also include a link to each source, so the assistant can cite it.

Read toolsCopy Anchor Link

search_sourcesCopy Anchor Link

Searches your own sources by words in the title, description, tags, folder name or domain. Matching is typo-tolerant and the best matches come first.

Each item has its id and short id, title, URL, description, folder, the tags that matched, and a link. Descriptions longer than 1,000 characters are cut short and flagged description_truncated.

list_sourcesCopy Anchor Link

Lists your sources one page at a time, newest first by default.

The result holds items, nextCursor and hasMore. Long descriptions are cut short, as in search_sources.

get_sourceCopy Anchor Link

Reads one source: its title, URL, full description, tags, folder, the communities it is shared with and the comments you can see.

list_foldersCopy Anchor Link

Lists every folder in your Library as a tree, parents before children. Each folder carries:

• its full path, for example Research / AI
• its privacy
• how many sources sit directly in it
• how many subfolders it has

It takes no input.

suggest_tagsCopy Anchor Link

Finds tags to reuse, best first:

1. Your own tags, with scope: "mine". The count is how many of your sources carry the tag.
2. Tag names that at least two people on ressource.social use, with scope: "platform". The count is how many people use it.
3. Near-misses of what was typed, flagged is_fuzzy.

Write toolsCopy Anchor Link

save_sourceCopy Anchor Link

Saves a web page to your Library. ressource.social fetches the page's title, description and preview itself.

• Already saved: saving a URL that is already in your Library returns the existing source with isExisting: true and changes nothing, not even its folder, tags or visibility. Use update_source or move_sources for those.
• Partly saved: if the source is saved but its folder, tags or description can't be set, the save still stands. The result carries not_applied with the reason, and update_source can finish the job.

save_sourcesCopy Anchor Link

Saves up to 10 web pages in one call, for importing a list of links. items is an array of save_source inputs. Each URL succeeds or fails on its own.

The result has one entry per URL, in the order given:

• ok, and then either source and isExisting, or error.
• Totals for saved, existing, failed and duplicates.
• A URL repeated in the batch is saved once. Its later entries repeat the first result and add duplicate_of, the index of the first entry.
• Once your save limit is reached, the remaining URLs are not tried and come back with a rate_limited error.

To import more than 10 links, call it again with the next batch.

update_sourceCopy Anchor Link

Changes one of your own sources. Only the fields you give change, and the previous values are not kept.

create_folderCopy Anchor Link

Creates a folder at the top level, or inside another folder.

Folders nest at most ten levels deep. A folder created inside a private folder is always private. The result includes the new folder's id.

update_folderCopy Anchor Link

Renames a folder, changes its description, colour or privacy, or moves it with everything inside it. It takes the same fields as create_folder, all optional, plus the folder's id.

• Moving: parent_folder_id: null moves the folder to the top level. A folder can't move into one of its own subfolders.
• Privacy: is_private: true also makes every subfolder private. Setting it back to false leaves the subfolders private.

move_sourcesCopy Anchor Link

Files your sources into one folder, or takes them out of every folder.

All or nothing: if any id is not one of your sources, nothing moves and the error lists the unknown ids. The result counts the sources moved and unchanged. ressource.social doesn't keep where each source was filed before, so a move can only be undone by hand. Bulk moves have their own hourly and daily limits.

delete_folderCopy Anchor Link

Deletes a folder and all its subfolders. No source is deleted: the sources inside stay in your Library, unfiled. The result counts the deleted folders and the unfiled sources.

The folders can't be restored, so OAuth connections don't get this tool. It needs a personal access token with the write scope.

A typical sessionCopy Anchor Link

To sort a Library or import a list of links into a folder tree, an assistant usually:

1. Calls list_folders to see what exists, so it doesn't create duplicates.
2. Calls create_folder for each missing folder, nesting them with the parent_folder_id that create_folder returned.
3. Collects ids with list_sources or search_sources, then makes one move_sources call per destination folder.
4. For imports, calls suggest_tags to reuse your tags, then save_sources in batches of 10 with a folder_id and tags on each item. Items that come back with isExisting: true stayed where they were. They can be moved with move_sources.