acatrove_status
ChatGPTValidate MCP connectivity to the configured AcaTrove instance.
add_evidence
ChatGPTRecord an impact-evidence item (interview, review, media article, syllabus use, talk, award, or other) on a publication you can edit.
add_project_member
ChatGPTInvite a person to a project by user_id or email. They join only after accepting. Counts against the project plan collaborator limit (the owner counts). Requires a management role on the project.
add_task_dependency
ChatGPTMake one project task depend on another (FS finish-to-start by default; SS, FF, SF also supported) with optional lag in days. Rejects cycles and duplicates. Requires a management role on the project.
ask_library
ChatGPTRetrieve the most relevant excerpts, each with its doc_name, from the authenticated user's document library for a question. Returns source excerpts only; AcaTrove does not write the answer. Covers the indexed text of the user's uploaded papers and documents. When excerpts is empty, retrieval_status says why: library_empty (no documents at all), library_not_indexed (documents exist but none has indexed text; see library_document_count), no_relevant_excerpts (indexed text exists but did not meet the calibrated relevance floor), model_abstained (excerpts cleared the floor but do not address the question), or unknown.
assign_task
ChatGPTSet or clear (assignee_user_id: null) the assignee of a project task, replacing any current assignee. Requires a management role on the project.
chat_with_document
ChatGPTRetrieve the relevant excerpt(s), each with its doc_name, from one specific document for a question. Returns source excerpts only; AcaTrove does not write the answer.
check_resource_availability
ChatGPTCheck scheduler availability, conflicts, policy, and training gates for a lab resource.
create_grant_application
ChatGPTStart a grant application (status "writing") for the authenticated user. Requires grant_title and funder; supports the grants:write scope. If a grant_id is supplied that already has an application, this updates that existing application (deadline/amount/project and application status) rather than creating a duplicate. An omitted deadline clears the existing application deadline. The response reports was_existing. An optional project_id must be a project the user can access, or the call is rejected.
create_note
ChatGPTSave a note to a project. Use this to capture insights, action items, or context from an AI conversation back into the AcaTrove workspace.
create_publication
ChatGPTCreate a publication in the authenticated user's AcaTrove library. Returns the saved record and the fields that were written. Requires the publications:write scope.
create_task
ChatGPTCreate a task inside one project.
delete_evidence
ChatGPTRemove one impact-evidence record from a publication. This is a recoverable delete — AcaTrove keeps the record so the user can restore it. Requires the publications:write scope.
delete_note
ChatGPTRemove a note from a project. This is a recoverable delete — AcaTrove keeps the record so the user can restore it — and the tool returns the note it removed. Requires the projects:write scope.
delete_publication
ChatGPTMove one of the authenticated user's publications to the AcaTrove Trash, where the user can restore it. Returns the record that was removed. Requires the publications:write scope.
delete_task
ChatGPTPermanently delete a project task and its dependency links. If other tasks depend on it, the call is refused until you retry with confirm_downstream_review: true, which flags those tasks for review. Requires a management role on the project.
fetch
ChatGPTFetch the full bibliographic record for a citation id. Implements the ChatGPT connector fetch contract.
fetch_open_access_full_text
ChatGPTDownload the legal open-access PDF of a publication (found through OpenAlex and Unpaywall by the publication's DOI), then store and index it so library search and chat can read the full paper. Replaces any file already attached. Fails with a clear reason when the publication has no DOI or no open-access copy exists; paywalls are never bypassed.
find_sources_for_passage
ChatGPTRetrieve the user's own papers relevant to a passage of text, as citable sources. Returns sources only; AcaTrove does not rewrite or edit the passage.
get_document_summary
ChatGPTRead a saved AI summary for a specific document, or generate and save a new summary version when none exists or refresh is requested. Generation uses the account's AI allowance.
get_note
ChatGPTRead one project note in full, including its body text. The note is addressed by project and note id together; a note in another project is not found. Requires the projects:read scope.
get_outline_template
ChatGPTRetrieve the outline template (sections, required parts, style notes) and the user's relevant sources for an academic document. Returns the template and sources only; AcaTrove does not generate the outline text.
get_project_status
ChatGPTFetch one project with milestones, current tasks, and task-status counts.
get_sample_lineage
ChatGPTFetch one sample with ancestors and direct descendants.
link_publications
ChatGPTLink up to 100 of your own publications to a project's library. A publication already linked to a different project is moved. Publications you do not own are skipped and listed.
link_source_to_project
ChatGPTLink an existing publication record to a project so the paper appears in that project context.
list_deadlines
ChatGPTList upcoming deadlines across all projects, grants, and tasks for the authenticated user.
list_documents
ChatGPTList all documents attached to a specific project.
list_evidence
ChatGPTList the impact evidence recorded on one publication (media coverage, syllabus use, talks, awards). An unknown publication id returns an error, not an empty list. Requires the publications:read scope.
list_lab_resources
ChatGPTList schedule-enabled lab equipment and resources.
list_lab_samples
ChatGPTList canonical lab samples from AcaTrove Lab Operations.
list_labs
ChatGPTList the AcaTrove labs the authenticated user belongs to, with their lab ids.
list_notes
ChatGPTList the notes saved to one project, newest first. An unknown project id returns an error, not an empty list — an empty notes array means the project exists and has no notes. Requires the projects:read scope.
list_projects
ChatGPTList the authenticated user research projects with optional filtering by status.
list_protocol_runs
ChatGPTList lab protocol/test runs from the AcaTrove lab test runner.
list_publications
ChatGPTList the authenticated user publications, including citation counts.
remove_project_member
ChatGPTRemove a collaborator from a project by collaborator link id (from the project team list). The project owner or a manager can remove others; any member can remove themselves.
search
ChatGPTSearch the authenticated user's authorized academic literature library. Implements the ChatGPT connector search contract: returns id/title/url for citations the user can access. Never returns full-text content, unauthorized records, or results from a different corpus.
search_across_workspace
ChatGPTSearch the full workspace — documents, publications, and projects — in a single query.
search_documents
ChatGPTSearch the authenticated user document library.
search_grants
ChatGPTSearch research funding opportunities across NIH, NSF, CORDIS, SBIR/STTR, and related grant sources. Note: current synced source coverage is weighted toward STEM/biomedical funders (NIH/NSF dominate; some humanities and federal sources are stale or unauthenticated), so results for humanities/social-science queries may be sparse or off-topic. Check each result’s source and the per-source status before relying on coverage.
search_library
ChatGPTSearch the authenticated user's authorized academic literature library and return ranked citation metadata (title, authors, journal, year, DOI, abstract, relevance score). Only returns citations the authenticated user can access — never raw full-text documents, unauthorized content, or results from a different corpus. An empty library search returns an explicit empty result.
search_references
ChatGPTSearch for relevant academic references to cite for a topic or passage.
summarize_lab_notebook
ChatGPTReturn a compact summary of lab notebook entry status and recent entries.
unlink_publications
ChatGPTRemove up to 100 publications from a project's library and its sections. The publications themselves are not deleted. You can unlink your own publications, or any publication if you own the project; others are skipped and listed.
update_project
ChatGPTUpdate a project's title and/or description. Requires the projects:write scope.
update_publication
ChatGPTUpdate fields on one of the authenticated user's publications (title, authors, journal, doi, abstract, status, publication_type). Returns the saved record plus the previous value of every field it changed, so the edit can be undone. Requires the publications:write scope.
update_task
ChatGPTChange a project task's title, description, status, progress, dates, or effort. Overwrites the fields you pass. Requires a management role on the project (an assignee may change only status and progress).