Get DataCite work
datacite_get_workFetch the full deposited DataCite metadata for one DOI: titles, creators and contributors with ORCID iDs and ROR affiliations, publisher, dates, version, subjects, descriptions, funding, geolocations, rights, sizes and formats, related identifiers with their relation types, repository and provider, and citation, reference, version, part, view, and download counts. Long lists are capped with exact list/offset continuation recipes; select a list to retrieve later entries without losing the other metadata, or relation_types to page only the related identifiers of chosen relation types. datacite_trace_relations maps a bounded graph (at most 100 nodes and 1,000 edges). A DOI DataCite does not hold returns found: false naming the registration agency that does, or saying the DOI does not exist.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"doi": "<doi>"
},
"name": "datacite_get_work"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| doi | Yes | The DOI, e.g. 10.5061/dryad.234: 10., a 4–9 digit registrant, a slash, and a suffix. Accepted bare, with doi: or info:doi/ prefixes, as a doi.org / dx.doi.org URL, or %2F-encoded; case-insensitive. | |
| list | No | One capped list to page in deposit order; other record fields keep their default caps. relation_types selects relatedIdentifiers. | |
| offset | No | Zero-based offset into valid mapped entries of list, after relation_types. Defaults to zero with list or relation_types; requires one of them. | |
| relation_types | No | Page only the relatedIdentifiers entries asserting these relation types (IsCitedBy, IsDerivedFrom, HasPart, IsSupplementTo, …), any case, matched exactly against the record's own deposited types, in deposit order; offset and listPage then index the filtered entries. Selects list relatedIdentifiers; another list is rejected. relatedIdentifierCounts stays the whole record's. Values: datacite_list_reference topic relation_types. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| doi | No | The DOI, normalized to lowercase bare form. | |
| dates | No | Dates. Found arm only. | |
| error | No | Present when the call failed. Absent on success. | |
| found | No | True when DataCite holds a public record for the DOI. | |
| sizes | No | Sizes as deposited, e.g. "2123413 bytes". Found arm only. | |
| counts | No | DataCite's own counts; they can trail the live record by a few events. Found arm only. | |
| doiUrl | No | Resolver URL, https://doi.org/<doi>, with #, ?, and % percent-encoded. Found arm only. | |
| notice | No | Discloses omitted malformed polygon geometry; other valid geographic fields remain available. | |
| rights | No | The work's own rights and licenses — distinct from metadataLicense. Found arm only. | |
| titles | No | Every title, main title first. Found arm only. | |
| created | No | When the record was created. Found arm only. | |
| formats | No | Formats as deposited. Found arm only. | |
| updated | No | When the record was last updated. Found arm only. | |
| version | No | Version string. Found arm only. | |
| creators | No | Creators, up to 100; full count in truncatedLists by default or listPage when selected. Found arm only. | |
| guidance | No | The next step for this miss. Miss arm only. | |
| language | No | Language as deposited, usually an ISO 639-1 code such as en. Found arm only. | |
| listPage | No | Paging metadata for the selected list, including empty and past-end pages. Found arm only. | |
| subjects | No | Subjects, up to 100; full count in truncatedLists by default or listPage when selected. Found arm only. | |
| publisher | No | Publisher. Found arm only. | |
| landingUrl | No | The repository's landing page. Found arm only. | |
| missReason | No | Why DataCite holds no public record: another agency registered it, no agency did, it is a DataCite DOI without public (Findable) metadata, or the agency lookup did not answer. Miss arm only. | |
| registered | No | When the DOI was registered. Found arm only. | |
| repository | No | The DataCite repository that registered the DOI. Found arm only. | |
| contentUrls | No | Direct content URLs, when deposited. Found arm only. | |
| contributors | No | Contributors, up to 100; full count in truncatedLists by default or listPage when selected. Found arm only. | |
| descriptions | No | Descriptions. Found arm only. | |
| geoLocations | No | Geolocations, up to 50; full count in truncatedLists by default or listPage when selected. Found arm only. | |
| relatedItems | No | Related items described inline in this record — typically the journal, book, or series it appears in — up to 25; full count in truncatedLists by default or listPage when selected. Found arm only. | |
| resourceType | No | Free-text resource type the depositor gave. Found arm only. | |
| schemaVersion | No | DataCite metadata schema version URI. Found arm only. | |
| truncatedLists | No | Lists the caps bound, with their full counts. Present only when a cap bound. | |
| metadataLicense | No | License of the DataCite metadata itself (CC0 1.0), not of the work it describes. Found arm only. | |
| publicationYear | No | Publication year. Found arm only. | |
| fundingReferences | No | Funding, up to 100; full count in truncatedLists by default or listPage when selected. Found arm only. | |
| registrationAgency | No | Registration agency that holds the DOI (e.g. Crossref, mEDRA, DataCite), when known. Miss arm only. | |
| relatedIdentifiers | No | Related identifiers, capped at 100 (full counts in relatedIdentifierCounts); with relation_types, only the entries asserting those types. Found arm only. | |
| resourceTypeGeneral | No | resourceTypeGeneral, e.g. Dataset or Software. Found arm only. | |
| alternateIdentifiers | No | Alternate identifiers. Found arm only. | |
| relatedIdentifierCounts | No | relationType → full count of the record's related identifiers, before the cap and any relation_types filter. Found arm only. |