zenodo-mcp-server

Added value: +{
+  "description": "A continuations[].cursor from an earlier zenodo_get_record response, passed unchanged with that continuation’s id as id. Returns that field’s next window (8,000 characters of text, or the next page of entries) as window, in place of record. Omit to get the record.",
+  "maxLength": 500,
+  "type": "string"
+}

Previous value: -"Maximum file entries shown (25)."New value: +"Without cursor: maximum file entries shown (25). With cursor: the window size (8,000 characters, or the field’s page of entries)."

Added value: +{
+  "description": "Every field this response cut short, each with a cursor for the rest. Absent when nothing was cut; files are paged with zenodo_list_files instead.",
+  "items": {
+    "additionalProperties": false,
+    "description": "One field cut short in this response.",
+    "properties": {
+      "cursor": {
+        "description": "Pass as cursor, with this entry’s id, to get the next window of this field.",
+        "type": "string"
+      },
+      "field": {
+        "description": "The field that was cut.",
+        "enum": [
+          "description",
+          "additional_descriptions",
+          "creators",
+          "contributors",
+          "keywords",
+          "funding",
+          "related_identifiers",
+          "communities"
+        ],
+        "type": "string"
+      },
+      "id": {
+        "description": "Record id the cursor is bound to; pass it as id beside the cursor, whatever id form this call took.",
+        "type": "string"
+      },
+      "index": {
+        "description": "Position of the additional description whose text was cut (0 = first). Present only for an additional description’s text.",
+        "type": "number"
+      },
+      "shown": {
+        "description": "Characters or entries of the field returned so far, counted from its start; the cursor resumes here.",
+        "type": "number"
+      },
+      "total": {
+        "description": "Full length of the field in characters, or its total entries.",
+        "type": "number"
+      },
+      "unit": {
+        "description": "characters for description text, entries for a list (additional_descriptions without index is the list).",
+        "enum": [
+          "characters",
+          "entries"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "field",
+      "unit",
+      "shown",
+      "total",
+      "id",
+      "cursor"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Previous value: -"Machine-readable failure mode. Declared by this tool: `invalid_identifier`: id matches no accepted form, or is a GitHub-badge latestdoi id or a non-zenodo.org host. `record_unavailable`: Zenodo could not serve this record: HTTP 500 after one retry, HTTP 500 while resolving a non-Zenodo DOI, or no complete response within the time budget (its gateway cuts off near 30 s, which deposits with about 10,000 or more files hit). `rate_limited`: Zenodo answered HTTP 429, or this server's shared Zenodo request budget is spent for the current window. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `invalid_identifier`: id matches no accepted form, or is a GitHub-badge latestdoi id or a non-zenodo.org host. `invalid_cursor`: cursor is not one this tool returned in continuations, belongs to another record, or the record was edited after the cursor was issued. `record_unavailable`: Zenodo could not serve this record: HTTP 500 after one retry, HTTP 500 while resolving a non-Zenodo DOI, or no complete response within the time budget (its gateway cuts off near 30 s, which deposits with about 10,000 or more files hit). `rate_limited`: Zenodo answered HTTP 429, or this server's shared Zenodo request budget is spent for the current window. Other values are possible when a failure originates below the handler."

Previous value: -[
-  "invalid_identifier",
-  "record_unavailable",
-  "rate_limited"
-]New value: +[
+  "invalid_identifier",
+  "invalid_cursor",
+  "record_unavailable",
+  "rate_limited"
+]

Previous value: -"The record. Present when found."New value: +"The record. Present when found and no cursor was passed."

Added value: +{
+  "description": "Total additional descriptions.",
+  "type": "number"
+}

Previous value: -"Up to 5 additional descriptions."New value: +"First 5 additional descriptions, in record order (index 0 first)."

Added value: +{
+  "description": "Full plain-text length in characters.",
+  "type": "number"
+}

Previous value: -"Plain text, capped at 1,000 characters."New value: +"Plain text, first 1,000 characters."

Added value: +{
+  "description": "True when text was cut at 1,000 characters; continuations carries a cursor for the rest.",
+  "type": "boolean"
+}

Previous value: -[
-  "text"
-]New value: +[
+  "text",
+  "length",
+  "truncated"
+]

Previous value: -"Up to 25 communities holding this record."New value: +"First 25 communities holding this record."

Added value: +{
+  "description": "Total communities holding this record.",
+  "type": "number"
+}

Previous value: -"Description converted from HTML to plain text, capped at 4,000 characters; absent when the record has none."New value: +"Description converted from HTML to plain text, first 4,000 characters; absent when the record has none."

Previous value: -"True when the description was cut at 4,000 characters. Present with description."New value: +"True when the description was cut at 4,000 characters; continuations carries a cursor for the rest. Present with description."

Previous value: -"Up to 50 funding entries (funders and grants)."New value: +"First 50 funding entries (funders and grants)."

Added value: +{
+  "description": "Total funding entries.",
+  "type": "number"
+}

Added value: +{
+  "description": "Total subject keywords.",
+  "type": "number"
+}

Previous value: -"Up to 50 subject keywords."New value: +"First 50 subject keywords."

Previous value: -[
-  "recid",
-  "title",
-  "additional_descriptions",
-  "creators",
-  "creator_count",
-  "contributors",
-  "contributor_count",
-  "keywords",
-  "rights",
-  "access",
-  "funding",
-  "related_identifiers",
-  "related_identifier_count",
-  "communities",
-  "versions",
-  "files",
-  "zenodo_url"
-]New value: +[
+  "recid",
+  "title",
+  "additional_descriptions",
+  "additional_description_count",
+  "creators",
+  "creator_count",
+  "contributors",
+  "contributor_count",
+  "keywords",
+  "keyword_count",
+  "rights",
+  "access",
+  "funding",
+  "funding_count",
+  "related_identifiers",
+  "related_identifier_count",
+  "communities",
+  "community_count",
+  "versions",
+  "files",
+  "zenodo_url"
+]

Previous value: -"File entries shown."New value: +"Without cursor: file entries shown. With cursor: characters or entries in the window."

Previous value: -"True when the record has more files than the 25 shown."New value: +"Without cursor: true when anything was cut, files past the 25 shown or any field in continuations. With cursor: true when continuations lists a next step, because the field continues past this window or an additional description on this page was cut."

Added value: +{
+  "additionalProperties": false,
+  "description": "The next window of the field the cursor continues. Present when found and a cursor was passed, in place of record.",
+  "properties": {
+    "additional_descriptions": {
+      "description": "Up to 5 additional descriptions starting at offset, each text cut at 1,000 characters. Present when field is additional_descriptions and unit is entries.",
+      "items": {
+        "additionalProperties": false,
+        "description": "One additional description.",
+        "properties": {
+          "length": {
+            "description": "Full plain-text length in characters.",
+            "type": "number"
+          },
+          "text": {
+            "description": "Plain text, first 1,000 characters.",
+            "type": "string"
+          },
+          "truncated": {
+            "description": "True when text was cut at 1,000 characters; continuations carries a cursor for the rest.",
+            "type": "boolean"
+          },
+          "type": {
+            "description": "Description type, e.g. Notes or Methods.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "text",
+          "length",
+          "truncated"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "communities": {
+      "description": "Up to 25 communities starting at offset. Present when field is communities.",
+      "items": {
+        "additionalProperties": false,
+        "description": "One community.",
+        "properties": {
+          "slug": {
+            "description": "Community slug — feeds zenodo_search_records community.",
+            "type": "string"
+          },
+          "title": {
+            "description": "Community title.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "slug"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "contributors": {
+      "description": "Up to 25 contributors starting at offset. Present when field is contributors.",
+      "items": {
+        "additionalProperties": false,
+        "description": "A creator or contributor.",
+        "properties": {
+          "affiliations": {
+            "description": "Affiliations as deposited.",
+            "items": {
+              "additionalProperties": false,
+              "description": "One affiliation.",
+              "properties": {
+                "name": {
+                  "description": "Affiliation name.",
+                  "type": "string"
+                },
+                "ror": {
+                  "description": "Affiliation ROR id, when linked.",
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "name": {
+            "description": "Display name as deposited.",
+            "type": "string"
+          },
+          "orcid": {
+            "description": "ORCID iD, when the depositor supplied one.",
+            "type": "string"
+          },
+          "role": {
+            "description": "Contributor role, e.g. Editor (contributors only).",
+            "type": "string"
+          },
+          "type": {
+            "description": "personal or organizational.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "name",
+          "affiliations"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "creators": {
+      "description": "Up to 25 creators starting at offset. Present when field is creators.",
+      "items": {
+        "additionalProperties": false,
+        "description": "A creator or contributor.",
+        "properties": {
+          "affiliations": {
+            "description": "Affiliations as deposited.",
+            "items": {
+              "additionalProperties": false,
+              "description": "One affiliation.",
+              "properties": {
+                "name": {
+                  "description": "Affiliation name.",
+                  "type": "string"
+                },
+                "ror": {
+                  "description": "Affiliation ROR id, when linked.",
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "name": {
+            "description": "Display name as deposited.",
+            "type": "string"
+          },
+          "orcid": {
+            "description": "ORCID iD, when the depositor supplied one.",
+            "type": "string"
+          },
+          "role": {
+            "description": "Contributor role, e.g. Editor (contributors only).",
+            "type": "string"
+          },
+          "type": {
+            "description": "personal or organizational.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "name",
+          "affiliations"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "field": {
+      "description": "The field this window continues.",
+      "enum": [
+        "description",
+        "additional_descriptions",
+        "creators",
+        "contributors",
+        "keywords",
+        "funding",
+        "related_identifiers",
+        "communities"
+      ],
+      "type": "string"
+    },
+    "funding": {
+      "description": "Up to 50 funding entries starting at offset. Present when field is funding.",
+      "items": {
+        "additionalProperties": false,
+        "description": "One funding entry.",
+        "properties": {
+          "award_acronym": {
+            "description": "Award acronym.",
+            "type": "string"
+          },
+          "award_doi": {
+            "description": "Award DOI, e.g. 10.3030/101135562.",
+            "type": "string"
+          },
+          "award_id": {
+            "description": "Award id (<funder-ror>::<number>) — feeds zenodo_search_records award.",
+            "type": "string"
+          },
+          "award_number": {
+            "description": "Grant number.",
+            "type": "string"
+          },
+          "award_program": {
+            "description": "Funding program.",
+            "type": "string"
+          },
+          "award_title": {
+            "description": "Award title.",
+            "type": "string"
+          },
+          "award_url": {
+            "description": "Award landing page URL.",
+            "type": "string"
+          },
+          "funder_id": {
+            "description": "Funder ROR id.",
+            "type": "string"
+          },
+          "funder_name": {
+            "description": "Funder name.",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "index": {
+      "description": "Position of the additional description whose text this window continues (0 = first). Present only for an additional description’s text.",
+      "type": "number"
+    },
+    "keywords": {
+      "description": "Up to 50 subject keywords starting at offset. Present when field is keywords.",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "offset": {
+      "description": "Characters or entries of the field before this window.",
+      "type": "number"
+    },
+    "related_identifiers": {
+      "description": "Up to 50 related identifiers starting at offset. Present when field is related_identifiers.",
+      "items": {
+        "additionalProperties": false,
+        "description": "One related identifier.",
+        "properties": {
+          "identifier": {
+            "description": "The related identifier (DOI, arXiv id, URL, PMID, …).",
+            "type": "string"
+          },
+          "relation": {
+            "description": "Relation type id, e.g. issupplementto or cites.",
+            "type": "string"
+          },
+          "resource_type": {
+            "description": "Resource type id of the related item.",
+            "type": "string"
+          },
+          "scheme": {
+            "description": "Identifier scheme, e.g. doi, arxiv, url.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "identifier"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "shown": {
+      "description": "Characters or entries in this window.",
+      "type": "number"
+    },
+    "text": {
+      "description": "Up to 8,000 characters of the field’s plain text, starting at offset. Present when unit is characters.",
+      "type": "string"
+    },
+    "total": {
+      "description": "Full length of the field in characters, or its total entries.",
+      "type": "number"
+    },
+    "unit": {
+      "description": "characters for a text window, entries for a list window.",
+      "enum": [
+        "characters",
+        "entries"
+      ],
+      "type": "string"
+    }
+  },
+  "required": [
+    "field",
+    "unit",
+    "offset",
+    "shown",
+    "total"
+  ],
+  "type": "object"
+}

Previous value: -"Entries per page (1–200)."New value: +"Entries per page, at most 200 per call; larger values return 200."

Previous value: -200New value: +10000

Previous value: -"Page size applied."New value: +"Page size applied (at most 200)."

Previous value: -"Page size applied."New value: +"Page size applied: limit, or 200 when limit asked for more."

Previous value: -"File access notes, empty-filter guidance, listing caps, or paging guidance."New value: +"File access notes, empty-filter guidance, listing caps, the 200-per-call limit cap, or paging guidance."

Previous value: -"Result page, starting at 1. page × size may not exceed 10,000."New value: +"Result page, starting at 1. Zenodo pages through only the first 10,000 versions, so the last reachable page is 10,000 ÷ size rounded up (400 at size 25)."

Previous value: -"Versions per page (1–25)."New value: +"Versions per page, at most 25 per call; larger values return 25."

Previous value: -25New value: +10000

Previous value: -"Page size applied."New value: +"Page size applied (at most 25)."

Previous value: -"Machine-readable failure mode. Declared by this tool: `invalid_identifier`: id matches no accepted form, or is a GitHub-badge latestdoi id or a non-zenodo.org host. `result_window_exceeded`: page × size exceeds 10,000. `record_unavailable`: Zenodo could not serve this record or its versions page: HTTP 500 after one retry, HTTP 500 while resolving a non-Zenodo DOI, or no complete record response within the time budget (its gateway cuts off near 30 s, which deposits with about 10,000 or more files hit). `upstream_timeout`: The versions page got no complete response within its time budget. `rate_limited`: Zenodo answered HTTP 429, or this server's shared Zenodo request budget is spent for the current window. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `invalid_identifier`: id matches no accepted form, or is a GitHub-badge latestdoi id or a non-zenodo.org host. `result_window_exceeded`: The page starts past the first 10,000 versions: (page − 1) × size is 10,000 or more, counting a size above 25 as 25. `record_unavailable`: Zenodo could not serve this record or its versions page: HTTP 500 after one retry, HTTP 500 while resolving a non-Zenodo DOI, or no complete record response within the time budget (its gateway cuts off near 30 s, which deposits with about 10,000 or more files hit). `upstream_timeout`: The versions page got no complete response within its time budget. `rate_limited`: Zenodo answered HTTP 429, or this server's shared Zenodo request budget is spent for the current window. Other values are possible when a failure originates below the handler."

Previous value: -"Guidance on paging or a page past the end."New value: +"Guidance on paging, the 25-per-call size cap, or a page past the end."

Previous value: -"Page size applied."New value: +"Page size applied: size, or 25 when size asked for more."

Previous value: -"Result page, starting at 1."New value: +"Result page, starting at 1. Only the first 10,000 entries of a list are reachable, so the last reachable page is 10,000 ÷ size rounded up (400 at size 25)."

Previous value: -"Entries per page (1–25)."New value: +"Entries per page, at most 25 per call; larger values return 25."

Previous value: -25New value: +10000

Previous value: -[
-  {
-    "not": {
-      "required": [
-        "error"
-      ]
-    },
-    "required": [
-      "vocabulary",
-      "total",
-      "page",
-      "size",
-      "has_more",
-      "entries",
-      "truncated",
-      "shown",
-      "cap",
-      "totalCount"
-    ]
-  },
-  {
-    "required": [
-      "error"
-    ]
-  }
-]New value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "vocabulary",
+      "total",
+      "reachable",
+      "page",
+      "size",
+      "has_more",
+      "entries",
+      "truncated",
+      "shown",
+      "cap",
+      "totalCount"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Previous value: -"Page size applied."New value: +"Page size applied (at most 25)."

Previous value: -"Machine-readable failure mode. Declared by this tool: `funder_only_for_awards`: funder is set with a vocabulary other than awards. `unknown_funder`: funder (awards) resolves to no Zenodo funder. `result_window_exceeded`: page × size exceeds 10,000. `rate_limited`: Zenodo answered HTTP 429, or this server's shared Zenodo request budget is spent for the current window. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `funder_only_for_awards`: funder is set with a vocabulary other than awards. `unknown_funder`: funder (awards) resolves to no Zenodo funder. `result_window_exceeded`: The page starts past the first 10,000 entries: (page − 1) × size is 10,000 or more, counting a size above 25 as 25. `rate_limited`: Zenodo answered HTTP 429, or this server's shared Zenodo request budget is spent for the current window. Other values are possible when a failure originates below the handler."

Previous value: -"True when more pages follow this one."New value: +"True when another page of reachable entries follows."

Previous value: -"Guidance on empty results, ambiguous funders, or further pages."New value: +"Guidance on empty results, ambiguous funders, the 10,000-entry window, the 25-per-call size cap, or further pages."

Added value: +{
+  "description": "Entries reachable by paging: min(total, 10,000).",
+  "type": "number"
+}

Previous value: -"Page size applied."New value: +"Page size applied: size, or 25 when size asked for more."

Previous value: -"True when more entries exist beyond this page."New value: +"True when more reachable entries follow this page."

Previous value: -"Maximum bytes to read (256–65536)."New value: +"Maximum bytes to read (256 or more), at most 65536 per call; larger values return 65536."

Previous value: -65536New value: +9007199254740991

Previous value: -"Why no text was returned, or how to read the rest of the file."New value: +"Why no text was returned, or how to read the rest of the file, naming the 65,536-byte cap when it held back bytes."

Previous value: -"Result page, starting at 1. page × size may not exceed 10,000."New value: +"Result page, starting at 1. Only the first 10,000 matches are reachable, so the last reachable page is 10,000 ÷ size rounded up (400 at size 25)."

Previous value: -"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."New value: +"Keyword query. Terms are OR-ed unless joined with AND; \"quoted phrases\" (double quotes) 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. With any filter other than community and all_versions, a query that is not valid search syntax (AND AND, a field: with no value, an unclosed [a TO b]) is rejected; without one, Zenodo matches it as plain text. Omit to browse with filters only."

Previous value: -"Results per page (1–25)."New value: +"Results per page, at most 25 per call; larger values return 25."

Previous value: -25New value: +10000

Previous value: -"Page size applied."New value: +"Page size applied (at most 25)."

Previous value: -"Machine-readable failure mode. Declared by this tool: `query_is_identifier`: The query is a single DOI, doi.org URL, or zenodo.org record URL. `query_syntax`: The query has an unpaired unescaped / outside quotes. `query_failed`: Zenodo answered HTTP 500 for a query that passed the local checks. `upstream_timeout`: The search attempt got no complete response within its time budget. `unknown_community`: community resolves to no Zenodo community. `unknown_funder`: funder is not a known ROR id and no funder carries that Crossref Funder DOI. `invalid_date_range`: The expanded published_from is after published_to. `result_window_exceeded`: page × size exceeds 10,000. `rate_limited`: Zenodo answered HTTP 429, or this server's shared Zenodo request budget is spent for the current window. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `query_is_identifier`: The query is a single DOI, doi.org URL, or zenodo.org record URL. `query_syntax`: The query holds something Zenodo cannot run: a regular expression with no closing / (an unescaped / outside double quotes) or with a \" inside /…/ left open; a \" inside a word whose phrase never closes (with a filter other than community and all_versions set, only when the query still fails once that phrase is closed at its end) or closes past a bracket the query needs; a range bound ending in a backslash, as one holding an escaped space, ] or } does; an unescaped ! with nothing after it; or a boost, fuzziness, or proximity value it cannot convert. Or a filter other than community and all_versions is set and the query is not valid search syntax, which Zenodo would match as plain text with every filter dropped. `query_failed`: Zenodo answered HTTP 500 for a query that passed the local checks. `upstream_timeout`: The search attempt got no complete response within its time budget. `unknown_community`: community resolves to no Zenodo community. `unknown_funder`: funder is not a known ROR id and no funder carries that Crossref Funder DOI. `invalid_date_range`: The expanded published_from is after published_to. `result_window_exceeded`: The page starts past the first 10,000 matches: (page − 1) × size is 10,000 or more, counting a size above 25 as 25. `rate_limited`: Zenodo answered HTTP 429, or this server's shared Zenodo request budget is spent for the current window. Other values are possible when a failure originates below the handler."

Previous value: -"Guidance on empty results, the 10,000-result window, or further pages."New value: +"Guidance on a query Zenodo matched as plain text, empty results, the 10,000-result window, the 25-per-call size cap, or further pages."

Previous value: -"Page size applied."New value: +"Page size applied: size, or 25 when size asked for more."