Figshare API
Figshare REST API for discovering public research articles, datasets, files, authors, and institutional repository records.
Connect this API to an AI agent Browse all specs
What you can do with Figshare API via MCP
Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.
| Method | Path | Operation | Description |
|---|---|---|---|
| GET | /articles |
get_articles | List public Figshare articles Method: GET Path: /articles IMPORTANT: This function has 0 REQUIRED parameter(s) and 4 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Query Parameters: OPTIONAL: - page: Page number - page_size: Page size - order: Ordering field - order_direction: Ordering direction |
| GET | /articles/{article_id} |
get_articles_article_id | Get a public Figshare article Method: GET Path: /articles/{article_id} IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - article_id: Figshare article ID |
| GET | /articles/{article_id}/files |
get_articles_article_id_files | List files attached to an article Method: GET Path: /articles/{article_id}/files IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - article_id: Figshare article ID |
| GET | /account/articles |
get_account_articles | List articles for the authenticated account Method: GET Path: /account/articles IMPORTANT: This function has 0 REQUIRED parameter(s) and 2 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Query Parameters: OPTIONAL: - page: Page number - page_size: Page size |
Usage guide
Public Figshare records can be read without authentication. Create a Figshare personal token only for private or write operations, send it as `Authorization: token YOUR_FIGSHARE_TOKEN`, and keep it server-side. This specification focuses on public discovery and metadata reads. Official documentation: https://docs.figshare.com/
How to use this spec
- Create a free VX Agents account (sandbox tools included).
- Open the marketplace and connect “Figshare API” to an agent.
- Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.