Requires a signed-in Scite account on a premium subscription. Anonymous sessions can’t use these tools, because a collection needs an owner.
Two kinds of collection
MCP creates DOI-list collections.
add_dois_to_collection and remove_dois_from_collection work on both kinds; create_collection and update_collection handle DOI-list collections only.
For a saved-search collection, adding a DOI force-includes it so it appears even when the query wouldn’t return it, and removing a DOI excludes it so it doesn’t appear even when the query would.
A collection is a set of papers. A dashboard is a report on a collection. They aren’t the same thing — see the glossary.
Access levels
Every collection tool checks the caller’s access level.
The creator becomes ADMIN. You reach VIEWER by owning the collection, being shared on it, being in an organization it’s shared with, or, if it’s shared publicly, holding the link.
Notes and files are team-internal. Only members (the owner, users it’s shared with, and the organization it’s shared with) can see them. A public link exposes the papers only, never the notes or files.
The slug
Every tool exceptcreate_collection and search_collections identifies a collection by its slug. You get one from create_collection or search_collections; there’s no way to look one up by name directly.
Create
create_collection takes a name (required), and optionally a description, a dois list to seed it, is_shared_with_org, and is_shared_publicly.
unmatchedDoiCount, so check it rather than assuming every DOI landed. An empty dois list creates an empty collection.
The two sharing settings are independent, both default to false, and can be combined:
Only set
is_shared_publicly when the user has asked to share publicly or asked for a link to send someone.
The response carries id, slug, name, description, organizationSlug, doiQueryType, accessType, and DOI counts.
Read
get_collection takes a slug and returns the collection’s identity, sharing, access level, and DOI counts. Requires VIEWER.
For members, it also returns noteCount and fileCount. Pass include_notes: true to embed an index of up to 25 notes (id, title, author, timestamps, no bodies); notesTruncated: true means there are more.
It returns DOI counts, not the DOI list. To see the papers, call search_literature with collection_slug.
search_collections lists the collections you can access, with an optional q to filter by a case-insensitive substring of the name. It returns {collections: [...], total: N}, each with id, slug, name, accessType, totalDoiCount, and fileCount.
fileCount is absent when your license doesn’t allow uploads, so an absent count means unknown, not empty.
Update
update_collection takes a slug plus any of name, description, dois, is_shared_with_org, and is_shared_publicly. Requires EDITOR or ADMIN; changing either sharing setting requires ADMIN.
It’s a partial update, but the dois field behaves differently from the rest:
- Omit
doisand the DOI list is left alone. - Supply
doisand it replaces the entire list.
- Omit it to leave the current setting unchanged. This is the default; omitting
is_shared_publiclynever breaks a link someone is still using. - Set it to
trueto grant sharing. Foris_shared_publicly, do this only when the user has asked to share publicly or asked for a link. - Set it to
falseto revoke that grant. Foris_shared_publicly, do this only when the user has asked to stop sharing the link.
Change membership
add_dois_to_collection and remove_dois_from_collection both take a slug and a non-empty dois array. Both require EDITOR or ADMIN, and both are idempotent — adding a DOI already present is ignored, as is removing one that isn’t there.
Delete
delete_collection takes a slug and requires ADMIN. It returns {deleted: true, slug: "..."}.
Notes
Notes are free-text Markdown the team keeps on a collection: reading lists, synthesis, decisions, open questions. Read them before answering a question about a collection, since they carry context the papers don’t.list_collection_notes returns full bodies, newest first, with total. text_search matches a note’s title or body as it renders, so Markdown markup doesn’t block a match: “mindfulness” finds mind**fulness**.
body, a title, or both. Omit title and one is derived from the body’s first line. body_format is MARKDOWN (default) or PLAIN. Bodies are limited to 20,000 characters and titles to 500.
update_collection_note is a partial update, but a supplied body replaces the whole body. To append, read the note first and send the combined text. Nobody can edit or delete a teammate’s note on any Scite surface.
Files
Files are documents the team has uploaded to a collection: PDFs, images, spreadsheets, slides, and text.List and check limits
list_collection_files returns metadata, newest first: id, filename, contentType, byteSize, uploadedBy, createdAt, and lastUpdated. A file marked suspended: true is withheld and can’t be read or deleted.
Every response carries limits: the per-file and per-collection caps, the allowed content types, and how much is used. Check it before uploading.
Upload
Send the contents in exactly one of two fields:contentfor text formats (Markdown, CSV, HTML, SVG, plain text), sent as-is.content_base64for binary formats (PDF, images, Office documents), as raw base64 with nodata:prefix.
collection_name instead of slug to create a new private collection for the file. The response then includes createdCollection with its slug. Never send both. Organizations whose license disables user uploads can’t use this tool.
Read
Two ways to read a file:get_collection_file_download_urlreturns a signed link to the raw bytes, withurl,filename,expiresIn(seconds), anddownloadHost. Fetch it when you’re ready to use it; it expires in minutes. Freshly uploaded files are unavailable until a malware scan finishes. A blocked fetch todownloadHostis usually a client network allowlist, not a missing file.read_collection_fileextracts text server-side, for clients that can’t fetch URLs. It handles PDFs with a text layer, Word, spreadsheets, slide decks (one page per slide), plain text, Markdown, CSV, and HTML. Passqueryfor the most relevant passages, orpageto read one page, sheet, or slide.max_tokensdefaults to 2,000.
read_collection_file returns PNG, JPEG, GIF, and WebP files whole as image content blocks. A spreadsheet called with neither page nor query returns an outline: per sheet, the row count, sample rows, and per-column statistics.
Delete
delete_collection_note and delete_collection_file are permanent, with no undo through MCP. Both carry destructiveHint, so confirm with the user before calling them.
Searching within a collection
Once a collection exists,search_literature can search inside it. Pass the slug as collection_slug and combine it with term and any other filter.
Related
- Collections guide: the same operations over HTTP
- Literature tools:
search_literatureand itscollection_slugfilter - Glossary: collection, dashboard, and access terminology
