Get DataCite citation
datacite_get_citationRender one DataCite DOI as a formatted citation in a CSL style and locale (APA in US English by default), or as a machine-readable record: CSL JSON, BibTeX, RIS, DataCite JSON or XML, Schema.org JSON-LD, Codemeta, or JATS. A style the upstream renderer does not support — an unknown id or a dependent journal style — is rejected instead of silently rendered as APA. Formatted text comes back as plain text alongside the upstream HTML markup. A long document comes back one slice at a time: limit sets the slice size in UTF-16 units (default 100,000) and nextOffset continues it. A DOI DataCite does not hold returns found: false naming the registration agency that does.
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_citation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| doi | Yes | The DataCite DOI, e.g. 10.5061/dryad.234. Accepted bare, with doi: or info:doi/ prefixes, as a doi.org / dx.doi.org URL, or %2F-encoded; case-insensitive. | |
| limit | No | UTF-16 code units of the document per slice (for text, of the upstream HTML), a positive integer (default 100,000). A slice ends early rather than split a surrogate pair, or for text a tag or character reference, and runs past limit only when one such unit alone is longer. Values above 1,000,000 apply 1,000,000 with a notice unless strict limits are configured. | |
| style | No | CSL style id for format text, e.g. apa (default), ieee, chicago-author-date, modern-language-association, vancouver, nature. Lowercased. A style that would silently fall back to APA is rejected. Verified ids: datacite_list_reference topic citation_styles. | |
| format | No | text (formatted citation, default), csl_json, bibtex, ris, datacite_json, datacite_xml, schema_org, codemeta, or jats. | |
| locale | No | CSL locale for format text, e.g. en-GB, de-DE, fr-FR, or a bare language (de → de-DE); any case. Omitted: en-US. List: datacite_list_reference topic citation_locales. | |
| offset | No | Zero-based offset, in UTF-16 code units, where the slice starts (for text, into the upstream HTML); default 0. An offset inside a surrogate pair, or for text inside a tag or character reference, starts the slice at that unit's start. Pass nextOffset to continue. At or past the end the slice is empty. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The limit applied, in UTF-16 code units. | |
| doi | No | The DOI, lowercase. | |
| error | No | Present when the call failed. Absent on success. | |
| found | No | True when DataCite holds the DOI and rendered it; false when it holds no public record (the miss fields explain). | |
| shown | No | UTF-16 code units in this slice (for text, of the HTML in citationHtml). | |
| style | No | CSL style applied (text only). | |
| format | No | The format requested. | |
| locale | No | CSL locale applied (text only; absent means en-US). | |
| notice | No | Set when the style could not be confirmed as distinct from APA, JATS contains empty names or inconsistent years, a limit over 1,000,000 was applied as 1,000,000, or citation is a slice of the document (its range and the call that continues it). | |
| citation | No | text: the citation as plain text (tags stripped, entities decoded) of the HTML in citationHtml; each slice is converted on its own, so join citationHtml slices, not these, to rebuild a paged text document. Machine formats: the document verbatim, or the slice of it offset and limit select, never splitting a surrogate pair; slices joined in offset order reproduce it exactly. Empty when offset is at or past the end. | |
| guidance | No | The next step for this miss. Miss arm only. | |
| mediaType | No | Media type negotiated. Found only. | |
| truncated | No | True when citation is a slice short of the whole document: units remain past it (nextOffset), or offset starts it past the beginning. | |
| 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. | |
| nextOffset | No | Where the next slice starts: call again with the same doi, format, style, locale, and limit, and this as offset. Absent once a slice reaches the end. | |
| downloadUrl | No | Exact negotiated URL for the whole document, returned with a slice short of it; fetch it to retrieve the document in one response. | |
| citationHtml | No | text only: the upstream HTML markup verbatim (<i>, &, small caps): the whole rendering trimmed, or the exact slice offset and limit select, which never ends inside a tag or character reference. | |
| totalCharacters | No | Length of the whole document in UTF-16 code units (for text, of the upstream HTML), returned with a slice short of it. | |
| registrationAgency | No | Registration agency that holds the DOI (e.g. Crossref, mEDRA, DataCite), when known. Miss arm only. |