ResearchShelf
research_shelfTrack and manage research papers gathered during browsing: list, confirm, score, remove, and export citations in BibTeX, RIS, or JSON.
Instructions
Manage the research shelf — an in-memory tracker for papers inspected during research.
Papers are automatically added when the following tools resolve a paper, RFC, or citable repository: arxiv, semantic_scholar, ietf, github (for repos with CITATION.cff), and web_fetch_incisive (via its DOI fast path). Use this tool to review, score, confirm, or remove tracked entries, and to export citations in BibTeX, RIS, or JSON format.
Actions: list, confirm, remove, score, note, export, import, clear.
Query formats:
list: section name (active, retracted, all) — default active
confirm/note: DOI of the paper (note takes DOI + space + note text)
remove: comma-separated DOIs
score: DOI + space + integer (e.g. "10.1234/foo 8")
export: format name (bibtex, ris, json), optionally "with_retracted" (e.g. "bibtex with_retracted")
import: JSON export string (merges with current shelf)
clear: ignored
The shelf survives context compaction within the same session. For cross-session persistence, use export json to save the shelf to a memory file, then import it in a future session.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | For confirm/score/note: the DOI of the paper. For remove: comma-separated DOIs to remove. For score: DOI followed by space and integer value (e.g. '10.1234/foo 8'). For note: DOI followed by space and note text. For list: section name (active, retracted, all) — default active. For export: format name (bibtex, ris, json), optionally followed by 'with_retracted' to include retracted entries (e.g. 'bibtex with_retracted'). For import: the JSON string to import. For clear: ignored (pass any value). | |
| action | Yes | The operation to perform. list: show all tracked papers. confirm: mark a paper as confirmed/useful. remove: batch remove papers by DOI (comma-separated). score: set an integer score for a paper. note: set a freetext note on a paper. export: export shelf in bibtex, ris, or json format. import: import shelf from a JSON export string. clear: remove all entries from the shelf. |