Search BioRender's library of scientific templates, find your files, and generate custom first-draft figures with AI. Results and previews appear right in your conversation, and every item links back to BioRender so you can open and keep editing.
custom-figure-confirm-previewDEPRECATED — do not call this. custom-figure-get-session finalizes the preview-generation credit handshake by itself when it returns preview images, so the generation is already settled by the time you could call this. Kept only so existing callers keep working; it is idempotent, so calling it anyway is a safe no-op.
jobIdstringcustom-figure-create-sessionStart a custom figure draft session from a text prompt and optional canvas context. This begins asynchronous preview generation. Poll custom-figure-get-preview-job until it reports "completed", then call custom-figure-get-session to fetch the completed previews — that call finalizes the generation, so nothing further is required. Pass canvasContext as either an image ({ type: "image", imageBase64 }) or a BioRender template ({ type: "template", templateId }).
promptstringcanvasContextobjectcustom-figure-get-preview-jobGet preview-generation job status for a custom figure draft session.
jobIdstringcustom-figure-get-sessionFetch a custom figure draft session. Completed previews may be returned as MCP images, while the JSON summary omits base64 image bytes. When a preview has been saved as a BioRender figure, the response includes that figure with a signed upload-backed imageUrl (rendered directly by the app UI) and an editor url — share the url so the user can open it in the editor.
sessionIdstringincludeImagesbooleanmaxImagesintegersearch-biorenderSearch BioRender for the user's own/shared files (figures) AND the public template library together. Results are returned under 1 MB and displayed in an interactive BioRender-styled UI when the client supports MCP Apps. Use this for any request to find or browse BioRender content — e.g. "show me my files and templates about mitochondria", "find BioRender content on X". Each result includes a title and a detailUrl that opens it in the BioRender app.
analyticsobjectquerystringincludeThumbnailsbooleanTrueperPagenumber10sourcesarray['files', 'templates']search-iconsSearch BioRender's scientific icon library. Supports single or batch queries (up to 10). Returns icons with display names, names, and asset type information. To use the icons in figures, users should navigate to app.biorender.com.
querystringSearch query (string) or array of queries (up to 10) for batch search. Examples: "cell culture" or ["cell culture", "centrifuge", "PCR"]
pagenumberPage number for pagination
0perPagenumberItems per page for pagination
20search-templatesSearch BioRender's template library. This is a search-only tool - returns templates with titles, descriptions, and detailUrl links where users can preview templates. To customize and use templates in figures, users should navigate to the template's detailUrl which will redirect them to the BioRender application (app.biorender.com). When presenting results to users, format each template link as markdown: [Template Title](detailUrl).
analyticsobjectpaginationobjectquerystringSearch query for templates
searchOptionsobject