zenodo_search_records - zenodo-mcp-server

Search Zenodo's open research repository — datasets, software releases, publications, and other deposits — by keyword query plus filters for resource type, community, funder, grant, creator ORCID, file type, license, access status, and publication date. Returns one summary per deposit (ids, DOIs, title, type, version, creators, license, access, file totals, usage counts) plus facet counts over the full match set, every filter applied. Query terms are OR-ed unless joined with AND, quoted phrases match exactly, and field syntax works on record fields (metadata.title:"…", metadata.subjects.subject:"…"). Only the latest version of each deposit is searched unless all_versions is true, and only the first 10,000 matches are reachable by paging. Resolve community, funder, and grant names to ids with zenodo_lookup_vocabulary first; open one deposit in full with zenodo_get_record.

Name	Required	Description
`page`	No	Result page, starting at 1. page × size may not exceed 10,000.
`size`	No	Results per page (1–25).
`sort`	No	Sort order: bestmatch, newest, oldest, mostviewed, mostdownloaded, updated-desc, updated-asc. Case, spaces, hyphens, and underscores are ignored when matching (MostViewed reads as mostviewed). Defaults to bestmatch with a query, newest without.
`award`	No	One grant: an award id <funder-ror>::<number> (00k4n6c32::101135562), a bare grant number, or a CORDIS award DOI (10.3030/101135562). Find ids with zenodo_lookup_vocabulary (vocabulary: awards).
`query`	No	Keyword query. Terms are OR-ed unless joined with AND; "quoted phrases" match exactly; field syntax such as metadata.title:"…" or doi:"10.5281/zenodo.N" works. Escape a literal / as \/. A bare DOI or record URL is rejected; open it with zenodo_get_record instead. Omit to browse with filters only.
`funder`	No	One funder: a ROR id (01cwqze88), a ROR URL, or a Crossref Funder DOI (10.13039/100000002). Resolve a funder name with zenodo_lookup_vocabulary (vocabulary: funders).
`license`	No	License id, e.g. cc-by-4.0, cc0-1.0, mit (lowercased). Find ids with zenodo_lookup_vocabulary (vocabulary: licenses).
`community`	No	One community: its slug, UUID, or zenodo.org/communities/<slug> URL. Find slugs with zenodo_lookup_vocabulary (vocabulary: communities).
`file_type`	No	File extensions, OR-ed (a single string is accepted): csv, zip, pdf, … Lowercased with any leading dot stripped.
`all_versions`	No	Include superseded versions; by default only the latest version is searched.
`published_to`	No	Latest publication date, YYYY, YYYY-MM, or YYYY-MM-DD; a partial date ends at its last day.
`access_status`	No	Access status: open, restricted, embargoed, or metadata-only. Case, spaces, hyphens, and underscores are ignored when matching (Metadata Only reads as metadata-only).
`creator_orcid`	No	Creator ORCID iD, e.g. 0000-0002-1825-0097; an https://orcid.org/ prefix is stripped and a trailing x uppercased.
`resource_type`	No	Resource type ids, OR-ed (a single string is accepted): dataset, software, publication, publication-article, image-photo, … Any case; a subtype may also be written in the <type>::<id> form zenodo_lookup_vocabulary shows as its search value (publication::publication-article). A top-level type includes its subtypes. Look ids up with zenodo_lookup_vocabulary (vocabulary: resource_types).
`published_from`	No	Earliest publication date, YYYY, YYYY-MM, or YYYY-MM-DD; a partial date starts at its first day.

Name

Required

Description

Default

page

Result page, starting at 1. page × size may not exceed 10,000.

size

Results per page (1–25).

sort

Sort order: bestmatch, newest, oldest, mostviewed, mostdownloaded, updated-desc, updated-asc. Case, spaces, hyphens, and underscores are ignored when matching (MostViewed reads as mostviewed). Defaults to bestmatch with a query, newest without.

award

One grant: an award id <funder-ror>::<number> (00k4n6c32::101135562), a bare grant number, or a CORDIS award DOI (10.3030/101135562). Find ids with zenodo_lookup_vocabulary (vocabulary: awards).

query

Keyword query. Terms are OR-ed unless joined with AND; "quoted phrases" match exactly; field syntax such as metadata.title:"…" or doi:"10.5281/zenodo.N" works. Escape a literal / as \/. A bare DOI or record URL is rejected; open it with zenodo_get_record instead. Omit to browse with filters only.

funder

One funder: a ROR id (01cwqze88), a ROR URL, or a Crossref Funder DOI (10.13039/100000002). Resolve a funder name with zenodo_lookup_vocabulary (vocabulary: funders).

license

License id, e.g. cc-by-4.0, cc0-1.0, mit (lowercased). Find ids with zenodo_lookup_vocabulary (vocabulary: licenses).

community

One community: its slug, UUID, or zenodo.org/communities/<slug> URL. Find slugs with zenodo_lookup_vocabulary (vocabulary: communities).

file_type

File extensions, OR-ed (a single string is accepted): csv, zip, pdf, … Lowercased with any leading dot stripped.

all_versions

Include superseded versions; by default only the latest version is searched.

published_to

Latest publication date, YYYY, YYYY-MM, or YYYY-MM-DD; a partial date ends at its last day.

access_status

Access status: open, restricted, embargoed, or metadata-only. Case, spaces, hyphens, and underscores are ignored when matching (Metadata Only reads as metadata-only).

creator_orcid

Creator ORCID iD, e.g. 0000-0002-1825-0097; an https://orcid.org/ prefix is stripped and a trailing x uppercased.

resource_type

Resource type ids, OR-ed (a single string is accepted): dataset, software, publication, publication-article, image-photo, … Any case; a subtype may also be written in the <type>::<id> form zenodo_lookup_vocabulary shows as its search value (publication::publication-article). A top-level type includes its subtypes. Look ids up with zenodo_lookup_vocabulary (vocabulary: resource_types).

published_from

Earliest publication date, YYYY, YYYY-MM, or YYYY-MM-DD; a partial date starts at its first day.

Name	Required	Description
`cap`	No	Page size applied.
`hits`	No	Matching deposits on this page.
`page`	No	Page returned.
`size`	No	Page size applied.
`error`	No	Present when the call failed. Absent on success.
`shown`	No	Hits returned on this page.
`total`	No	Exact number of matching records.
`facets`	No	Facet counts over the full match set (every filter applied, so they agree with total), not just this page.
`notice`	No	Guidance on empty results, the 10,000-result window, or further pages.
`has_more`	No	True when another reachable page follows.
`next_page`	No	The next page number, when has_more.
`reachable`	No	Matches reachable by paging: min(total, 10,000).
`truncated`	No	True when more reachable matches follow this page.
`totalCount`	No	Exact number of matching records.
`allVersions`	No	Whether superseded versions were searched.
`appliedSort`	No	The sort order applied.
`effectiveQuery`	No	The exact q sent to Zenodo.

Name

Required

Description

Default

cap

Page size applied.

hits

Matching deposits on this page.

page

Page returned.

size

Page size applied.

error

Present when the call failed. Absent on success.

shown

Hits returned on this page.

total

Exact number of matching records.

facets

Facet counts over the full match set (every filter applied, so they agree with total), not just this page.

notice

Guidance on empty results, the 10,000-result window, or further pages.

has_more

True when another reachable page follows.

next_page

The next page number, when has_more.

reachable

Matches reachable by paging: min(total, 10,000).

truncated

True when more reachable matches follow this page.

totalCount

Exact number of matching records.

allVersions

Whether superseded versions were searched.

appliedSort

The sort order applied.

effectiveQuery

The exact q sent to Zenodo.

zenodo-mcp-server

Search Zenodo records

Input Schema

Output Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources