add_to_knowledge
ChatGPTQueue an existing workspace file for credit-metered semantic Knowledge indexing. Use list_knowledge to poll status; retrying the same path is safe.
analyze_image
ChatGPTAsk Beeblio's metered vision model about a saved project JPEG, PNG, WebP, or GIF.
cancel_analysis_job
ChatGPTRequest cancellation of a queued or running project analysis job.
compile_latex
ChatGPTCompile a saved .tex file with its project assets. On success, replaces that source's deterministic PDF in 4-Reports/Compiled and returns a 15-minute download URL. Supply the current source ETag; compiler failures return diagnostics.
copy_path
ChatGPTCopy a project file or folder to a new path without overwriting. First call inspect_path and pass its version. Shares and Knowledge entries are not copied.
create_directory
ChatGPTCreate a project directory at a new relative path.
create_form
ChatGPTGenerate a Beeblio survey from a validated definition in 2-Data. Use ifNotExists for creation or the current ETag for replacement; existing response CSV remains in place.
create_project
ChatGPTCreate a research project and starter workspace. Reuse idempotencyKey when retrying a lost response.
edit_document
ChatGPTReplace one exact passage or insert at unique anchors in an existing project text file. Requires its current ETag; rejects ambiguous anchors and protected formats.
export_document
ChatGPTConvert a saved Markdown file into a new PDF, DOCX, DOCX with live Zotero fields, DOCX with Mendeley Cite controls, LaTeX bundle, or portable Markdown artifact under 4-Reports. Exports never overwrite.
fetch_demographic_data
ChatGPTFetch World Bank country indicator records into a create-only project JSON file.
fetch_openalex_works
ChatGPTFetch full OpenAlex records by searches or work IDs and save JSON pages in project analysis files. Outputs are create-only.
get_account_profile
ChatGPTIdentify the Beeblio account represented by this connection.
get_analysis_job
ChatGPTPoll an analysis job for status, logs, and generated output paths.
get_credit_usage
ChatGPTRead the connected account's current credit balance, included and top-up balances, usage mix for a selected range, and recent credit activity. No projectId is needed.
get_download_url
ChatGPTCreate a direct, 15-minute download URL for an owned project file, including an exported DOCX, PDF, or ZIP. Give the URL to the user when they ask for the file. For a folder, use get_folder_download_url.
get_folder_download_url
ChatGPTPackage a project folder as a ZIP and return a direct, 15-minute download URL. Give the URL to the user when they ask for the folder. For a single file, use get_download_url.
get_form_definition
ChatGPTRead a Beeblio .form.html survey as a validated JSON definition with its ETag.
get_latex_diagnostics
ChatGPTCheck a saved .tex source for missing includes, bibliography, and figures. This is a bounded source check, not a real LaTeX compile.
get_latex_source_bundle
ChatGPTPackage a saved .tex source, its referenced files, and an available compiled PDF as a ZIP. Returns missing dependency warnings and a 15-minute download URL.
get_paper
ChatGPTLook up a paper by DOI, PMID, or OpenAlex ID through OpenAlex.
get_project
ChatGPTRead the name, description, and timestamps of an owned project.
inspect_path
ChatGPTGet a file ETag or a folder tree version before rename, move, or copy. Versions change when the source changes.
list_artifacts
ChatGPTList visible files in references, data, analysis, reports, or figures.
list_files
ChatGPTList visible files in a project directory. Use the returned cursor for the next page.
list_knowledge
ChatGPTList files indexed in this project's Knowledge, including indexing status, errors, and citation keys.
list_projects
ChatGPTFind your active Beeblio research projects and their projectId slugs.
list_skills
ChatGPTDiscover Beeblio's research skill instructions, including skills authored by this account.
move_path
ChatGPTMove an existing project file or folder to a new path without overwriting. First call inspect_path and pass its version. Public share and Knowledge paths follow the move.
read_excalidraw
ChatGPTRead a compact digest of shapes, labels, and connectors from a saved Excalidraw scene with its ETag.
read_matrix
ChatGPTRead columns and a page of citation-key rows and cells from a typed .matrix file with its ETag.
read_office
ChatGPTRead bounded workbook cells and formulas or paginated document and presentation text from a project Office file. Supports DOCX, PPTX, XLS/XLSX, ODT/ODS/ODP, and RTF, not visual layout.
read_skill
ChatGPTRead one Beeblio research skill by slug as reference instructions for the external agent.
read_skill_resource
ChatGPTRead a text reference or script from a packaged Beeblio skill directory. Paths are relative to that skill.
read_text_file
ChatGPTRead a bounded slice of a project text file, with an ETag and nextOffset.
rename_path
ChatGPTRename an existing project file or folder without overwriting. First call inspect_path and pass its version. Public share and Knowledge paths follow the move.
save_citation
ChatGPTLook up a verified DOI, PMID, or OpenAlex ID and add its citation to references.bib. Retries deduplicate the paper.
save_paper_pdf
ChatGPTSave the verified open-access PDF from a search result into 1-References and link it from references.bib. Pass the complete paper handle returned by search_literature; arbitrary PDF URLs are not accepted.
search_bibliography
ChatGPTFind citation keys and metadata in a project's references.bib.
search_files
ChatGPTFind visible project files and folders by path text. The search scans at most 2,000 entries and reports when incomplete.
search_knowledge
ChatGPTSearch indexed project documents for a grounded answer with exact workspace file, page, excerpt, and bibliography citations. This uses credits and may contact the configured AI provider.
search_literature
ChatGPTSearch OpenAlex, Crossref, and PubMed for research papers. This contacts public literature providers.
stat_file
ChatGPTGet a file's size and current ETag before reading or safely replacing it.
submit_analysis_job
ChatGPTStart a disposable Python or shell analysis job against saved project files. Use get_analysis_job to poll. Generated outputs may be written under 2-Data/derived, 3-Analysis, or 4-Reports. Credit metered.
transcribe_audio
ChatGPTTranscribe saved audio to a new TXT, Markdown, SRT, or VTT project file with optional diarization and word timings. Credit metered.
update_excalidraw
ChatGPTApply typed shape, text, and connector operations to a saved Excalidraw scene. Use ifNotExists for creation or its current ETag for updates.
update_matrix
ChatGPTApply typed operations to a .matrix file. Use ifNotExists for creation or the current ETag for updates; generic text writes are blocked.
upload_artifact
ChatGPTSave a ChatGPT-provided file, including a sandbox-generated chart or dataset, to a new path in an owned Beeblio project. Accepts files up to 25 MB under 1-References, 2-Data/derived, 3-Analysis, or 4-Reports; never overwrites. Pass the actual ChatGPT file as file, not a copied URL.
upsert_bibliography_entry
ChatGPTAdd a manually described reference with DOI/identity deduplication. Supply the current bibliography ETag.
validate_mermaid
ChatGPTValidate raw Mermaid flowchart or graph source and return a syntax error if invalid.
write_text_file
ChatGPTCreate or replace a project text file. Provide ifNotExists for creation or the current expectedEtag for replacement.