zenodo-mcp-server

v0.1.1 pre-1.0

Search and resolve Zenodo datasets, software, and publications by DOI; trace versions and funding, list files, and preview text files via MCP. STDIO or Streamable HTTP.

zenodo.caseyjhand.com/mcp
claude mcp add --transport http zenodo-mcp-server https://zenodo.caseyjhand.com/mcp
codex mcp add zenodo-mcp-server --url https://zenodo.caseyjhand.com/mcp
{
  "mcpServers": {
    "zenodo-mcp-server": {
      "url": "https://zenodo.caseyjhand.com/mcp"
    }
  }
}
gemini mcp add --transport http zenodo-mcp-server https://zenodo.caseyjhand.com/mcp
{
  "mcpServers": {
    "zenodo-mcp-server": {
      "command": "bunx",
      "args": [
        "mcp-remote",
        "https://zenodo.caseyjhand.com/mcp"
      ]
    }
  }
}
{
  "mcpServers": {
    "zenodo-mcp-server": {
      "type": "http",
      "url": "https://zenodo.caseyjhand.com/mcp"
    }
  }
}
curl -X POST https://zenodo.caseyjhand.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"curl","version":"1.0.0"}}}'

Tools

6

zenodo_search_records

open-world

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.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "zenodo_search_records",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "query": {
      "description": "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.",
      "type": "string",
      "maxLength": 1000
    },
    "resource_type": {
      "description": "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).",
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "dataset",
          "event",
          "image",
          "image-diagram",
          "image-drawing",
          "image-figure",
          "image-other",
          "image-photo",
          "image-plot",
          "lesson",
          "model",
          "other",
          "physicalobject",
          "poster",
          "presentation",
          "publication",
          "publication-annotationcollection",
          "publication-article",
          "publication-book",
          "publication-conferencepaper",
          "publication-conferenceproceeding",
          "publication-datamanagementplan",
          "publication-datapaper",
          "publication-deliverable",
          "publication-dissertation",
          "publication-journal",
          "publication-milestone",
          "publication-other",
          "publication-patent",
          "publication-peerreview",
          "publication-preprint",
          "publication-proposal",
          "publication-report",
          "publication-section",
          "publication-softwaredocumentation",
          "publication-standard",
          "publication-taxonomictreatment",
          "publication-technicalnote",
          "publication-workingpaper",
          "software",
          "software-computationalnotebook",
          "video",
          "workflow"
        ]
      }
    },
    "community": {
      "description": "One community: its slug, UUID, or zenodo.org/communities/<slug> URL. Find slugs with zenodo_lookup_vocabulary (vocabulary: communities).",
      "type": "string",
      "maxLength": 200
    },
    "funder": {
      "description": "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).",
      "type": "string",
      "maxLength": 200
    },
    "award": {
      "description": "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).",
      "type": "string",
      "maxLength": 200
    },
    "creator_orcid": {
      "description": "Creator ORCID iD, e.g. 0000-0002-1825-0097; an https://orcid.org/ prefix is stripped and a trailing x uppercased.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{4}-\\d{4}-\\d{3}[\\dX]$"
    },
    "file_type": {
      "description": "File extensions, OR-ed (a single string is accepted): csv, zip, pdf, … Lowercased with any leading dot stripped.",
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[a-z0-9]{1,16}$",
        "description": "A file extension, e.g. csv."
      }
    },
    "license": {
      "description": "License id, e.g. cc-by-4.0, cc0-1.0, mit (lowercased). Find ids with zenodo_lookup_vocabulary (vocabulary: licenses).",
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9.+-]{0,63}$"
    },
    "access_status": {
      "description": "Access status: open, restricted, embargoed, or metadata-only. Case, spaces, hyphens, and underscores are ignored when matching (Metadata Only reads as metadata-only).",
      "type": "string",
      "enum": [
        "open",
        "restricted",
        "embargoed",
        "metadata-only"
      ]
    },
    "published_from": {
      "description": "Earliest publication date, YYYY, YYYY-MM, or YYYY-MM-DD; a partial date starts at its first day.",
      "type": "string",
      "pattern": "^\\d{4}(-(0[1-9]|1[0-2])(-(0[1-9]|[12]\\d|3[01]))?)?$"
    },
    "published_to": {
      "description": "Latest publication date, YYYY, YYYY-MM, or YYYY-MM-DD; a partial date ends at its last day.",
      "type": "string",
      "pattern": "^\\d{4}(-(0[1-9]|1[0-2])(-(0[1-9]|[12]\\d|3[01]))?)?$"
    },
    "all_versions": {
      "default": false,
      "description": "Include superseded versions; by default only the latest version is searched.",
      "type": "boolean"
    },
    "sort": {
      "description": "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.",
      "type": "string",
      "enum": [
        "bestmatch",
        "newest",
        "oldest",
        "mostviewed",
        "mostdownloaded",
        "updated-desc",
        "updated-asc"
      ]
    },
    "page": {
      "default": 1,
      "description": "Result page, starting at 1. page × size may not exceed 10,000.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "size": {
      "default": 10,
      "description": "Results per page (1–25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "required": [
    "all_versions",
    "page",
    "size"
  ],
  "additionalProperties": false
}
view source ↗

zenodo_get_record

open-world

Resolve one Zenodo deposit from a record id, a Zenodo DOI (10.5281/zenodo.N), a concept DOI or concept record id (resolves to the latest version), another DOI deposited on Zenodo, or a zenodo.org or doi.org URL, and return its full metadata: description, creators with ORCIDs and ROR affiliations, license, access and embargo, funding and grants, related identifiers, communities, version position, usage counts, and the first 25 files. Optionally includes a formatted citation. A miss (an unknown id, a deleted record with its removal tombstone, restricted metadata, or a DOI not registered on Zenodo) returns found: false with guidance instead of an error.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "zenodo_get_record",
    "arguments": {
      "id": "<id>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "The deposit to resolve: a record id (22705923), a Zenodo DOI (10.5281/zenodo.22705923, doi: prefix and any case accepted), a concept DOI or concept record id such as 10.5281/zenodo.591564 (resolves to the latest version), another DOI registered to a Zenodo record, or a zenodo.org/records or doi.org URL."
    },
    "citation_style": {
      "description": "Include a formatted citation of the resolved version: bibtex, csl-json, or a text style (apa, chicago-author-date, harvard-cite-them-right, ieee, modern-language-association, nature). Case, spaces, hyphens, and underscores are ignored when matching (BibTeX, APA, CSL JSON). Omit for none.",
      "type": "string",
      "enum": [
        "bibtex",
        "csl-json",
        "apa",
        "chicago-author-date",
        "harvard-cite-them-right",
        "ieee",
        "modern-language-association",
        "nature"
      ]
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}
view source ↗

zenodo_list_versions

open-world

List every version of a Zenodo deposit's version series, newest first, with each version's record id, DOI, version label, publication date, file totals, and usage counts. Accepts any identifier zenodo_get_record accepts; a concept DOI and any single version's DOI list the same series. Use it to find the version a paper cited or the current release. A miss (an unknown id, a deleted record with its removal tombstone, restricted metadata, or a DOI not registered on Zenodo) returns found: false with guidance instead of an error.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "zenodo_list_versions",
    "arguments": {
      "id": "<id>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "Any version or concept identifier of the deposit: a record id (22705923), a Zenodo DOI (10.5281/zenodo.22705923) or concept DOI (10.5281/zenodo.591564), another DOI registered to a Zenodo record, or a zenodo.org/records or doi.org URL."
    },
    "page": {
      "default": 1,
      "description": "Result page, starting at 1. page × size may not exceed 10,000.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "size": {
      "default": 25,
      "description": "Versions per page (1–25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "required": [
    "id",
    "page",
    "size"
  ],
  "additionalProperties": false
}
view source ↗

zenodo_list_files

open-world

Page through a Zenodo deposit's file manifest (key, size, MIME type, MD5, download URL, previewability), optionally filtered by a substring of the file key, or list the members inside one of its .zip files by setting archive_key. Restricted and embargoed files return the access status and embargo date with no entries. Read a small text file or ZIP member with zenodo_read_file.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "zenodo_list_files",
    "arguments": {
      "id": "<id>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "The deposit: a record id (22705923), a Zenodo DOI (10.5281/zenodo.22705923), another DOI registered to a Zenodo record, or a zenodo.org/records or doi.org URL. A concept id lists the latest version’s files."
    },
    "archive_key": {
      "description": "Exact file key of a .zip in this record (from the manifest) to list its members instead of the manifest. Omit to list the manifest.",
      "type": "string",
      "maxLength": 1000
    },
    "key_contains": {
      "description": "Case-insensitive substring filter on file keys (manifest) or member paths (archive), applied before paging.",
      "type": "string",
      "maxLength": 200
    },
    "offset": {
      "default": 0,
      "description": "Entries to skip before this page.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 50,
      "description": "Entries per page (1–200).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "required": [
    "id",
    "offset",
    "limit"
  ],
  "additionalProperties": false
}
view source ↗

zenodo_read_file

open-world

Read a bounded UTF-8 excerpt (up to 64 KiB per call) of one text file in a Zenodo deposit — a README, CITATION.cff, CSV head, notebook, or script — or of one member inside a .zip file, without downloading the archive. Continue a top-level file from next_offset. A file with a text MIME type or extension is read directly; an extensionless file Zenodo types application/octet-stream (LICENSE, COPYING, Makefile) is read and returned only when its content is UTF-8 text. Binary files, restricted files, and other types return metadata and the download URL without content. File content is depositor-supplied and carries the deposit’s license.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "zenodo_read_file",
    "arguments": {
      "id": "<id>",
      "key": "<key>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "The deposit: a record id (22705923), a Zenodo DOI (10.5281/zenodo.22705923), another DOI registered to a Zenodo record, or a zenodo.org/records or doi.org URL. A concept id reads from the latest version."
    },
    "key": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1000,
      "description": "Exact file key from zenodo_list_files, e.g. README.md or data/results.csv."
    },
    "archive_member": {
      "description": "Member path inside the .zip named by key (from zenodo_list_files with archive_key). Omit to read the file itself.",
      "type": "string",
      "maxLength": 1000
    },
    "offset_bytes": {
      "default": 0,
      "description": "Byte offset to start reading a top-level file at; use next_offset to continue. Must be 0 for an archive member.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "max_bytes": {
      "default": 16384,
      "description": "Maximum bytes to read (256–65536).",
      "type": "integer",
      "minimum": 256,
      "maximum": 65536
    }
  },
  "required": [
    "id",
    "key",
    "offset_bytes",
    "max_bytes"
  ],
  "additionalProperties": false
}
view source ↗

zenodo_lookup_vocabulary

open-world

Resolve names to the ids zenodo_search_records filters on, and browse Zenodo's reference vocabularies: communities (slug), funders (ROR id), awards and grants (award id), licenses (license id), and resource types (type id). Search by name, acronym, or keyword; awards can be scoped to one funder. Each entry names the zenodo_search_records parameter its id feeds.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "zenodo_lookup_vocabulary",
    "arguments": {
      "vocabulary": "<vocabulary>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "vocabulary": {
      "description": "Which vocabulary to search: communities, funders, awards (grants), licenses, or resource_types. Case, spaces, hyphens, and underscores are ignored when matching, and the singular (funder, license, resource type) and grants are accepted.",
      "type": "string",
      "enum": [
        "communities",
        "funders",
        "awards",
        "licenses",
        "resource_types"
      ]
    },
    "query": {
      "description": "Name, acronym, or keyword, e.g. \"SYMBA\", \"wellcome\", \"mit\", \"journal article\". For resource_types every word must appear in the type id or label. Omit to browse the vocabulary.",
      "type": "string",
      "maxLength": 200
    },
    "funder": {
      "description": "awards only: scope grants to one funder, given as a ROR id (00k4n6c32), a ROR URL, or a Crossref Funder DOI (10.13039/100000002). Resolve a funder name to its ROR id with vocabulary funders first.",
      "type": "string",
      "maxLength": 200
    },
    "page": {
      "default": 1,
      "description": "Result page, starting at 1.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "size": {
      "default": 10,
      "description": "Entries per page (1–25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "required": [
    "vocabulary",
    "page",
    "size"
  ],
  "additionalProperties": false
}
view source ↗