Figshare integration
Figshare is a research repository where researchers and institutions publish datasets, figures, papers, software and other outputs with DOIs. Search and read published public articles, collections and projects with their files and versions; manage your own items: create and update articles, attach linked files, set authors, categories, embargoes and private sharing links, reserve DOIs and publish; build collections and projects with notes and collaborators; and, for institution accounts, read groups, accounts, roles and curation reviews and comment on reviews. Not exposed: file byte uploads and downloads (both go through separate Figshare file hosts; every file record carries its download_url), OAuth token routes, institution account provisioning and role changes, HR feed and custom-field file uploads, the Symplectic Elements integration routes, and the deprecated confidentiality and group custom-field routes. Authentication is a Figshare personal token (Applications page of your account) sent as Authorization: token <TOKEN>; public read tools also answer without one.
Say what should happen.
The workflow builds itself.
What you can do with Figshare
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Article, 18 operations
add_collection_articlesAdd collection articlesPOSTAdds articles to one of the token's collections, keeping the existing ones, by article id.create_articleCreate articlePOSTCreates a new private article (draft item) in the token's account.create_project_articleCreate project articlePOSTCreates a new private article inside a project the token's account belongs to. Only title is required; it accepts the same metadata as create_article. Returns the new article's API URL in location.delete_articleDelete articleDELETEDeletes one of the token's articles, identified by article_id.delete_project_articleDelete project articleDELETEDeletes one article of a project the token's account belongs to.get_articleGet articleGETReturns the full private record of one of the token's articles, published or not: metadata, status, authors, categories, files, embargo, license, funding, DOI and versions.get_project_articleGet project articleGETReturns the full private record of one article of a project the token's account belongs to.get_public_articleGet public articleGETReturns the full public record of a published article: title, description, authors, categories, tags, license, funding, DOI, citation, files with their download_url, custom fields and version information.list_collection_articlesList collection articlesGETLists the articles contained in one of the token's collections, as light article records.list_institution_articlesList institution articlesGETLists articles of the token's own institution, filtered by publication or modification date, status, resource DOI or item type. The account must be an institution administrator.list_my_articlesList my articlesGETLists the articles (items) owned by the token's account, private drafts and published items alike, as light records with id, title, DOI and URLs.list_project_articlesList project articlesGETLists the articles of a project the token's account belongs to, as light article records.list_public_articlesList public articlesGETLists published public articles (datasets, figures, papers, software and other item types) across Figshare, newest first by default.list_public_collection_articlesList public collection articlesGETLists the published articles contained in a public collection, as light article records.list_public_project_articlesList public project articlesGETLists the published articles of a public project, as light article records.partially_update_articlePartially update articlePATCHChanges only the metadata fields sent on one of the token's articles (title, description, tags, categories, authors, license, funding and so on), leaving the others as they are.remove_collection_articleRemove collection articleDELETERemoves one article from one of the token's collections. The article itself is not deleted.replace_collection_articlesReplace collection articlesPUTReplaces all articles of one of the token's collections with the article ids given.
Category, 10 operations
add_article_categoriesAdd article categoriesPOSTAdds categories to one of the token's articles, keeping the existing ones, by category id (from list_categories or list_account_categories).add_collection_categoriesAdd collection categoriesPOSTAdds categories to one of the token's collections, keeping the existing ones, by category id.list_account_categoriesList account categoriesGETLists the categories available to the token's account (its institution's categories, including parent categories).list_article_categoriesList article categoriesGETLists the categories (subject classifications) of one of the token's articles.list_categoriesList categoriesGETLists every public Figshare category (subject classification), with its id, title, parent id and source id. Pass category ids to create_article or add_article_categories.list_collection_categoriesList collection categoriesGETLists the categories (subject classifications) of one of the token's collections.remove_article_categoryRemove article categoryDELETERemoves one category from one of the token's articles.remove_collection_categoryRemove collection categoryDELETERemoves one category from one of the token's collections.replace_article_categoriesReplace article categoriesPUTReplaces all categories of one of the token's articles with the category ids given (from list_categories or list_account_categories).replace_collection_categoriesReplace collection categoriesPUTReplaces all categories of one of the token's collections with the category ids given.
Author, 9 operations
add_article_authorsAdd article authorsPOSTAdds authors to one of the token's articles, keeping the existing ones. Each author is given by id (an existing Figshare author) or by name for someone without an account.add_collection_authorsAdd collection authorsPOSTAdds authors to one of the token's collections, keeping the existing ones. Each author is given by id (an existing Figshare author) or by name.get_authorGet authorGETReturns one author's details: full name, first and last name, ORCID, institution, group, job title and whether the author is active and public.list_article_authorsList article authorsGETLists the authors of one of the token's articles, with their id, full name, ORCID and whether they are active.list_collection_authorsList collection authorsGETLists the authors of one of the token's collections, with their id, full name, ORCID and whether they are active.remove_article_authorRemove article authorDELETERemoves one author from one of the token's articles.remove_collection_authorRemove collection authorDELETERemoves one author from one of the token's collections.replace_article_authorsReplace article authorsPUTReplaces the whole author list of one of the token's articles. Each author is given by id (an existing Figshare author) or by name for someone without an account.replace_collection_authorsReplace collection authorsPUTReplaces the whole author list of one of the token's collections. Each author is given by id (an existing Figshare author) or by name.
File, 9 operations
add_article_fileAdd article filePOSTAdds a file to one of the token's articles. Send link to attach a file that stays hosted elsewhere (nothing is uploaded, the file is a link).delete_article_fileDelete article fileDELETEDeletes one file from one of the token's articles.get_article_fileGet article fileGETReturns one file of one of the token's articles: name, size, status, MD5 checksums, upload details and download_url.get_project_article_fileGet project article fileGETReturns one file of one article of a project the token's account belongs to.get_public_article_fileGet public article fileGETReturns one file of a published public article: name, size, MIME type, MD5 checksums and download_url.list_article_filesList article filesGETLists the files of one of the token's articles: name, size, status, MD5 checksums, whether it is only a link, and its download_url.list_project_article_filesList project article filesGETLists the files of one article of a project the token's account belongs to, with name, size, status, checksums and download_url.list_public_article_filesList public article filesGETLists the files of a published public article: name, size, MIME type, MD5 checksums, whether the file is only a link, and its download_url.list_public_article_version_filesList public article version filesGETLists the files of one published version of a public article: name, size, MIME type, MD5 checksums and download_url.
Search, 9 operations
search_authorsSearch authorsPOSTSearches Figshare authors by free text, ORCID, institution or group, and whether they are active or public. Returns author ids to use in an article's authors list.search_fundingSearch fundingPOSTSearches the funding sources (grants and funders) known to Figshare by free text, to reference them in an article's funding_list.search_institution_accountsSearch institution accountsPOSTSearches the institution accounts the token's account administers by free text, email, institution user id or active status.search_my_articlesSearch my articlesPOSTSearches the token's own articles by free text and filters (item type, DOI, handle, project, resource DOI, dates). Returns a page of light article records.search_my_collectionsSearch my collectionsPOSTSearches the token's own collections by free text and filters (DOI, handle, resource DOI, dates). Returns a page of light collection records.search_my_projectsSearch my projectsPOSTSearches the projects the token's account owns or collaborates on, by free text and filters (institution, group, dates).search_public_articlesSearch public articlesPOSTSearches published public articles by free text and filters (item type, institution, group, DOI, handle, project, publication or modification date). Returns a page of light article records; get_public_article returns the full record.search_public_collectionsSearch public collectionsPOSTSearches published public collections by free text and filters (institution, group, DOI, handle, resource DOI, publication or modification date). Returns a page of light collection records.search_public_projectsSearch public projectsPOSTSearches published public projects by free text and filters (institution, group, publication or modification date). Returns a page of light project records.
Collection, 7 operations
create_collectionCreate collectionPOSTCreates a new private collection in the token's account, optionally with its articles, authors, categories, tags, funding and references. Returns the new collection's id in entity_id and its API URL in location.delete_collectionDelete collectionDELETEDeletes one of the token's collections, identified by collection_id.get_collectionGet collectionGETReturns the full private record of one of the token's collections: metadata, authors, categories, funding, DOI, articles count and version information.get_public_collectionGet public collectionGETReturns the full public record of a published collection: title, description, authors, categories, tags, funding, DOI, citation, article count and version information.list_my_collectionsList my collectionsGETLists the collections owned by the token's account, private and published, as light records with id, title, DOI and URL.list_public_collectionsList public collectionsGETLists published public collections (curated groups of articles) across Figshare, filtered by institution, group, DOI, handle, resource DOI or publication and modification dates.partially_update_collectionPartially update collectionPATCHChanges only the metadata fields sent on one of the token's collections, leaving the others as they are.
Private link, 7 operations
create_article_private_linkCreate article private linkPOSTCreates a private link that lets anyone holding it view one of the token's unpublished articles. Links expire after 365 days unless expires_date says otherwise. Returns the link's API location and its shareable html_location.create_collection_private_linkCreate collection private linkPOSTCreates a private link that lets anyone holding it view one of the token's unpublished collections. Links expire after 365 days unless expires_date says otherwise. Returns the link's API location and its shareable html_location.disable_article_private_linkDisable article private linkDELETEDisables a private link of one of the token's articles, so it no longer gives access.disable_collection_private_linkDisable collection private linkDELETEDisables a private link of one of the token's collections, so it no longer gives access.get_collection_private_linkGet collection private linkGETReturns one private link of one of the token's collections: its URL, expiry date and whether it is active.list_article_private_linksList article private linksGETLists the private sharing links of one of the token's articles, with each link's id, URL, expiry date and whether it is active.list_collection_private_linksList collection private linksGETLists the private sharing links of one of the token's collections, with each link's id, URL, expiry date and whether it is active.
Project, 7 operations
create_projectCreate projectPOSTCreates a new private project (a shared space for related articles and collaborators) in the token's account. Returns the new project's id in entity_id and its API URL in location.delete_projectDelete projectDELETEDeletes a project. Only possible when the project is not public and has no public articles. Deleting an individual project moves its articles back to each owner's own items; deleting a group project deletes its articles and files too.get_projectGet projectGETReturns the full private record of a project the token's account belongs to: title, description, funding, collaborators, role, quota and usage.get_public_projectGet public projectGETReturns the public record of a published project: title, description, funding, collaborators, figshare URL and creation and modification dates.list_my_projectsList my projectsGETLists the projects the token's account owns or collaborates on, as light records with id, title, role and storage.list_public_projectsList public projectsGETLists published public projects (groups of related articles with collaborators) across Figshare, filtered by institution, group or publication and modification dates.partially_update_projectPartially update projectPATCHChanges only the metadata fields sent on a project the token's account owns, leaving the others as they are.
Version, 5 operations
get_public_article_versionGet public article versionGETReturns the full public record of one published version of an article, as get_public_article does for the latest version.get_public_collection_versionGet public collection versionGETReturns the full public record of one published version of a collection.list_public_article_versionsList public article versionsGETLists the published versions of a public article, each with its version number and API URL. Pass a version number to get_public_article_version.list_public_collection_versionsList public collection versionsGETLists the published versions of a public collection. Pass a version number to get_public_collection_version.partially_update_article_versionPartially update article versionPATCHChanges only the supplementary fields or internal metadata sent on one published version of one of the token's articles.
Note, 4 operations
create_project_noteCreate project notePOSTAdds a note (text of at least 3 characters) to a project the token's account belongs to. Returns the note's API URL in location.delete_project_noteDelete project noteDELETEDeletes one note of a project the token's account belongs to.get_project_noteGet project noteGETReturns one note of a project the token's account belongs to, with its full text.list_project_notesList project notesGETLists the notes of a project the token's account belongs to, with author, abstract and dates.
Account, 3 operations
get_accountGet accountGETReturns the account the token belongs to: id, name, email, institution, group, storage quota and usage, ORCID and whether it is active.get_institution_accountGet institution accountGETReturns one institution account the token's account administers: name, email, group, quota and usage, institution user id and whether it is active.list_institution_accountsList institution accountsGETLists the institution accounts the token's account administers (assigned and inherited), filtered by active status, email, institution user id or id range.
Collaborator, 3 operations
invite_project_collaboratorInvite project collaboratorPOSTInvites a user to a project as viewer or collaborator, by Figshare user id or by email, with an optional message.list_project_collaboratorsList project collaboratorsGETLists the collaborators of a project and the users invited to it, with their user id, name, role and status.remove_project_collaboratorRemove project collaboratorDELETERemoves a collaborator from a project the token's account owns.
Embargo, 3 operations
delete_article_embargoDelete article embargoDELETELifts the embargo of one of the token's articles.get_article_embargoGet article embargoGETReturns the embargo settings of one of the token's articles: whether it is embargoed, until when, at article or file level, title, reason and access options.get_public_article_version_embargoGet public article version embargoGETReturns the embargo settings of one published version of a public article: whether it is embargoed, until when, at article or file level, and the embargo title, reason and access options.
Publish, 3 operations
publish_articlePublish articlePOSTPublishes one of the token's articles, creating a new public version with a DOI. If the whole article is under embargo it is published only when the embargo expires or is lifted. Returns the API URL of the article in location.publish_collectionPublish collectionPOSTPublishes one of the token's collections, creating a new public version with a DOI. Returns the collection's API URL in location.publish_projectPublish projectPOSTPublishes a project the token's account owns. Possible only once every item inside it is public.
Comment, 2 operations
add_curation_review_commentAdd curation review commentPOSTAdds a comment to one curation review of the token's institution.list_curation_review_commentsList curation review commentsGETLists the comments left on one curation review, each with the commenting account id, comment type, text and dates.
Embargo option, 2 operations
list_group_embargo_optionsList group embargo optionsGETLists the embargo access options available to one group of the token's institution.list_institution_embargo_optionsList institution embargo optionsGETLists the embargo access options the token's institution offers, each with its id (to pass in embargo_options), type (logged_in, ip_range or administrator) and IP range name.
Export, 2 operations
create_article_reportCreate article reportPOSTRequests a new XLSX report of the token's articles. Figshare allows one report per day; poll list_article_reports for its status and download_url.list_article_reportsList article reportsGETLists the article reports (XLSX exports of the account's articles) requested so far, with their status and download_url once ready.
Institution, 2 operations
get_institutionGet institutionGETReturns the institution the token's account belongs to: its id and name, plus its domain where set.list_altmetric_institutionsList altmetric institutionsGETLists the institutions available for Altmetric reporting on Figshare, with their id, name and custom repository domain.
License, 2 operations
list_account_licensesList account licensesGETLists the licenses available to the token's account, including any custom licenses its institution adds to the public ones.list_licensesList licensesGETLists the public licenses an item can carry (CC BY 4.0, CC0, MIT and others), with the numeric value to pass as license when creating or updating an article.
Reserve doi, 2 operations
reserve_article_doiReserve article doiPOSTReserves a DOI for one of the token's unpublished articles, so it can be cited before publication. Returns the reserved DOI.reserve_collection_doiReserve collection doiPOSTReserves a DOI for one of the token's unpublished collections, so it can be cited before publication. Returns the reserved DOI.
Reserve handle, 2 operations
reserve_article_handleReserve article handlePOSTReserves a Handle for one of the token's unpublished articles (for institutions that use Handles). Returns the reserved Handle.reserve_collection_handleReserve collection handlePOSTReserves a Handle for one of the token's unpublished collections (for institutions that use Handles). Returns the reserved Handle.
Review, 2 operations
get_curation_reviewGet curation reviewGETReturns one curation review of the token's institution, with its status, assignee, request number, resolution comment, dates and the full record of the item under review.list_curation_reviewsList curation reviewsGETLists the curation reviews (pre-publication reviews of items) of the token's institution, filtered by group, article or status.
Role, 2 operations
list_institution_account_rolesList institution account rolesGETLists the roles one institution account holds, as an object keyed by group id whose values are the role lists (id, name, category).list_institution_rolesList institution rolesGETLists the roles that can be assigned in the token's institution and its groups.
Filter by, 1 operation
find_institution_articles_by_resourceFind institution articles by resourceGETFinds the public articles of one institution that match a resource id and a file name, for example to check whether a record harvested from another repository is already on Figshare. Both filters are required.
Group, 1 operation
list_institution_groupsList institution groupsGETLists the groups of the token's institution that the account administers (directly or inherited), with id, name, parent and resource id.
Item type, 1 operation
list_item_typesList item typesGETLists the item types (figure, dataset, media, software, preprint and more) available to a group, or Figshare's default item types when no group is given.
Leave, 1 operation
leave_projectLeave projectPOSTRemoves the token's account from a project it collaborates on. The project's owner cannot leave it.
User, 1 operation
get_institution_userGet institution userGETReturns the user behind one institution account: name, URL name, ORCID, job title and whether the user is active and public.
Showing the first 120 of 134 endpoints. The rest are in the product, searchable from the workflow builder and from chat.
Use Figshare from Claude Code, Cursor or Codex
Connect Figshare in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Figshare operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect Figshare
- Create your workspace
Sign up free. Nothing to install.
- Connect Figshare once
Add your Figshare connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
Figshare integration FAQ
What can you do with the Figshare integration?
LiveContext exposes 134 operations on Figshare, covering article, category, author and file.
