data-aggregator-mcp

Overview Schema Source Related Servers Discussions Admin

resolve

Read-only

Fetch the full record for a known dataset or publication ID, including files, citations, retraction status, FAIR scores, and license advisories.

Instructions

Fetch the full DataResource for a known id (e.g. 'zenodo:7654321', 'datacite:10.5061/dryad.x', 'hf:owner/name', a bare Zenodo record id, or a DOI), including the complete files[] manifest. Publication resolve also attaches normalized identifiers (pmid/pmcid/doi) and, when open access, a full-text file. Pass cite= to render a citation onto the result (citation field); omitted means no citation. Pass trust=true to attach retraction status (via Crossref) under trust{}. Pass fair=true to attach an RDA-grounded FAIRness score (0–100 + F/A/I/R sub-scores + actionable gaps) computed from the record under fair{}. Pass use= (commercial/redistribute/modify/ml-training) to attach a licence-compatibility advisory (ALLOW/REVIEW/DENY, not legal advice) under license_compat{}. Pass format=provenance for a one-call RO-Crate 1.1 data-availability dossier (under provenance{}) composing version-currency, licence+SPDX, FAIR score, retraction status, and the source/DOI/ID chain — it auto-attaches fair + trust.

Input Schema

TableJSON Schema

Name	Required	Description
`id`	Yes	Source-prefixed id, bare Zenodo id, or DOI
`use`	No	When set, attach a licence-compatibility advisory under license_compat{} for an intended use of the record. Supported intents: 'commercial', 'redistribute', 'modify', 'ml-training' (training = a derivative+commercial use, our stated interpretation). The verdict is ALLOW/REVIEW/DENY computed from a bundled choosealicense.com licence matrix keyed on the normalized SPDX id, naming the governing clause — a metadata-derived advisory, NOT legal advice. An unrecognized or absent licence yields REVIEW (never a fabricated ALLOW/DENY); an unknown intent is an error.
`cite`	No	Optional citation format to render onto the result: 'bibtex', 'ris', 'csl-json', or any CSL style name ('apa', 'mla', 'vancouver', ...). DOI-bearing records render via DOI content negotiation; non-DOI records support 'csl-json' only. Omitted = no citation. Failures degrade quietly (citation stays null).
`fair`	No	When true, attach an RDA-grounded FAIRness assessment under fair{}: a 0–100 overall score plus findable/accessible/interoperable/reusable sub-scores, the count of indicators evaluated, and actionable gaps each naming its RDA FAIR Data Maturity Model indicator id. Pure/local — no network call. Only the machine-evaluable subset is scored (never fabricates what the metadata cannot show).
`trust`	No	When true, attach trust signals (retraction status via Crossref) to the result under trust{}. One extra Crossref call; only meaningful for DOI-bearing records (a DataCite data DOI Crossref does not register leaves retracted=null = unknown, never a false clean claim).
`format`	No	Optional export to render onto the result. 'croissant' attaches a file-level Croissant JSON-LD manifest (croissant field); 'ro-crate' attaches a minimal RO-Crate 1.1 manifest (ro_crate field); 'provenance' attaches a one-call RO-Crate 1.1 data-availability dossier (provenance field) bundling version-currency, licence+SPDX, FAIR score, retraction status, and the source/DOI/ID chain — it auto-attaches fair{} and trust{} so the dossier is complete in one call (unknown signals are reported as unknown, never as a clean claim).

Output Schema

TableJSON Schema

Name	Required	Description	Default
`id`	Yes
`doi`	No
`fair`	No
`kind`	Yes
`taxa`	No
`year`	No
`files`	No
`links`	No
`title`	Yes
`trust`	No
`access`	No
`errors`	No
`source`	Yes
`funding`	No
`license`	No
`metrics`	No
`mirrors`	No
`citation`	No
`creators`	No
`organism`	No
`ro_crate`	No
`subjects`	No
`croissant`	No
`is_latest`	No
`truncated`	No
`accessions`	No
`provenance`	No
`description`	No
`identifiers`	No
`access_modes`	No
`last_updated`	No
`superseded_by`	No
`license_compat`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed3 schema fields changedv0.54.1Sep 30, 2026

addedInput schema / additionalProperties
```
Added value: +false
```

addedOutput schema / properties / errors

Added value: +{
+  "additionalProperties": {
+    "type": "string"
+  },
+  "title": "Errors",
+  "type": "object"
+}

addedOutput schema / properties / truncated

Added value: +{
+  "additionalProperties": {
+    "type": "string"
+  },
+  "title": "Truncated",
+  "type": "object"
+}

Addedv0.45.1Jul 28, 2026
Removedv0.43.0Jul 27, 2026

Changed14 schema fields changedv0.40.0Jun 12, 2026

addedInput schema / properties / fair

Added value: +{
+  "description": "When true, attach an RDA-grounded FAIRness assessment under fair{}: a 0–100 overall score plus findable/accessible/interoperable/reusable sub-scores, the count of indicators evaluated, and actionable gaps each naming its RDA FAIR Data Maturity Model indicator id. Pure/local — no network call. Only the machine-evaluable subset is scored (never fabricates what the metadata cannot show).",
+  "type": "boolean"
+}

changedInput schema / properties / format / description

Previous value: -"Optional export to render onto the result. 'croissant' attaches a file-level Croissant JSON-LD manifest (croissant field); 'ro-crate' attaches a minimal RO-Crate 1.1 manifest (ro_crate field)."New value: +"Optional export to render onto the result. 'croissant' attaches a file-level Croissant JSON-LD manifest (croissant field); 'ro-crate' attaches a minimal RO-Crate 1.1 manifest (ro_crate field); 'provenance' attaches a one-call RO-Crate 1.1 data-availability dossier (provenance field) bundling version-currency, licence+SPDX, FAIR score, retraction status, and the source/DOI/ID chain — it auto-attaches fair{} and trust{} so the dossier is complete in one call (unknown signals are reported as unknown, never as a clean claim)."

changedInput schema / properties / format / enum

Previous value: -[
-  "croissant",
-  "ro-crate"
-]New value: +[
+  "croissant",
+  "ro-crate",
+  "provenance"
+]

addedInput schema / properties / trust

Added value: +{
+  "description": "When true, attach trust signals (retraction status via Crossref) to the result under trust{}. One extra Crossref call; only meaningful for DOI-bearing records (a DataCite data DOI Crossref does not register leaves retracted=null = unknown, never a false clean claim).",
+  "type": "boolean"
+}

addedInput schema / properties / use

Added value: +{
+  "description": "When set, attach a licence-compatibility advisory under license_compat{} for an intended use of the record. Supported intents: 'commercial', 'redistribute', 'modify', 'ml-training' (training = a derivative+commercial use, our stated interpretation). The verdict is ALLOW/REVIEW/DENY computed from a bundled choosealicense.com licence matrix keyed on the normalized SPDX id, naming the governing clause — a metadata-derived advisory, NOT legal advice. An unrecognized or absent licence yields REVIEW (never a fabricated ALLOW/DENY); an unknown intent is an error.",
+  "type": "string"
+}

addedOutput schema / $defs / FairAssessment

Added value: +{
+  "description": "FAIRness assessment attached on resolve(fair=True). PURE-function output:\na 0–100 overall score plus 0–100 per-dimension sub-scores, grounded in the\nmachine-evaluable subset of the RDA FAIR Data Maturity Model. ``assessed`` is\nthe count of indicators actually evaluated (transparency — we never score what\nthe metadata can't show). ``gaps`` are failed-indicator reasons, each naming its\nRDA indicator id and framed as a metadata-exposure gap, not a value judgement.",
+  "properties": {
+    "accessible": {
+      "title": "Accessible",
+      "type": "integer"
+    },
+    "assessed": {
+      "title": "Assessed",
+      "type": "integer"
+    },
+    "findable": {
+      "title": "Findable",
+      "type": "integer"
+    },
+    "gaps": {
+      "items": {
+        "type": "string"
+      },
+      "title": "Gaps",
+      "type": "array"
+    },
+    "interoperable": {
+      "title": "Interoperable",
+      "type": "integer"
+    },
+    "reusable": {
+      "title": "Reusable",
+      "type": "integer"
+    },
+    "score": {
+      "title": "Score",
+      "type": "integer"
+    }
+  },
+  "required": [
+    "score",
+    "findable",
+    "accessible",
+    "interoperable",
+    "reusable",
+    "assessed"
+  ],
+  "title": "FairAssessment",
+  "type": "object"
+}

addedOutput schema / $defs / LicenseVerdict

Added value: +{
+  "description": "Licence-compatibility advisory attached on resolve(use=<intent>). PURE-function\noutput: an ALLOW / REVIEW / DENY verdict for an intended use of the resolved record,\ncomputed from a bundled licence matrix (choosealicense.com flag vocabulary) keyed on\nthe normalized SPDX id. ``spdx_id`` is None exactly when the licence was unrecognized\nor absent (→ REVIEW, never a fabricated ALLOW/DENY). ``reason`` names the governing\nclause; ``disclaimer`` states this is a metadata-derived advisory, not legal advice.",
+  "properties": {
+    "disclaimer": {
+      "title": "Disclaimer",
+      "type": "string"
+    },
+    "license_raw": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "title": "License Raw"
+    },
+    "reason": {
+      "title": "Reason",
+      "type": "string"
+    },
+    "spdx_id": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "title": "Spdx Id"
+    },
+    "use": {
+      "title": "Use",
+      "type": "string"
+    },
+    "verdict": {
+      "enum": [
+        "ALLOW",
+        "REVIEW",
+        "DENY"
+      ],
+      "title": "Verdict",
+      "type": "string"
+    }
+  },
+  "required": [
+    "use",
+    "verdict",
+    "spdx_id",
+    "license_raw",
+    "reason",
+    "disclaimer"
+  ],
+  "title": "LicenseVerdict",
+  "type": "object"
+}

addedOutput schema / $defs / Mirror

Added value: +{
+  "description": "A same-dataset copy folded into this record by content dedup (resolve the\nmirror's id to reach the original deposit). Only populated when a search ran\nwith the opt-in ``collapse_mirrors`` flag.",
+  "properties": {
+    "doi": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Doi"
+    },
+    "id": {
+      "title": "Id",
+      "type": "string"
+    },
+    "source": {
+      "title": "Source",
+      "type": "string"
+    }
+  },
+  "required": [
+    "source",
+    "id"
+  ],
+  "title": "Mirror",
+  "type": "object"
+}

addedOutput schema / $defs / TrustSignals

Added value: +{
+  "description": "Integrity/provenance signals attached on resolve(trust=True). All nullable:\nNone = not checked or not determinable (e.g. a DOI Crossref doesn't register) —\nNEVER a negative claim. A *found* Crossref work yields definitive booleans.",
+  "properties": {
+    "concern": {
+      "anyOf": [
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Concern"
+    },
+    "retracted": {
+      "anyOf": [
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Retracted"
+    },
+    "retraction_doi": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Retraction Doi"
+    }
+  },
+  "title": "TrustSignals",
+  "type": "object"
+}

addedOutput schema / properties / fair

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/$defs/FairAssessment"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

addedOutput schema / properties / license_compat

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/$defs/LicenseVerdict"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

addedOutput schema / properties / mirrors

Added value: +{
+  "items": {
+    "$ref": "#/$defs/Mirror"
+  },
+  "title": "Mirrors",
+  "type": "array"
+}

addedOutput schema / properties / provenance

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Provenance"
+}

addedOutput schema / properties / trust

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/$defs/TrustSignals"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

Changed9 schema fields changedv0.20.0Jun 4, 2026

addedInput schema / properties / format

Added value: +{
+  "description": "Optional export to render onto the result. 'croissant' attaches a file-level Croissant JSON-LD manifest (croissant field); 'ro-crate' attaches a minimal RO-Crate 1.1 manifest (ro_crate field).",
+  "enum": [
+    "croissant",
+    "ro-crate"
+  ],
+  "type": "string"
+}

addedOutput schema / $defs / Metrics

Added value: +{
+  "description": "Usage/impact signals, each a separate axis — NO blended score. All\nnullable: a source that does not expose an axis leaves it None.",
+  "properties": {
+    "citations": {
+      "anyOf": [
+        {
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Citations"
+    },
+    "downloads": {
+      "anyOf": [
+        {
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Downloads"
+    },
+    "likes": {
+      "anyOf": [
+        {
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Likes"
+    },
+    "views": {
+      "anyOf": [
+        {
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Views"
+    }
+  },
+  "title": "Metrics",
+  "type": "object"
+}

addedOutput schema / properties / access_modes

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "title": "Access Modes",
+  "type": "array"
+}

addedOutput schema / properties / croissant

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Croissant"
+}

addedOutput schema / properties / is_latest

Added value: +{
+  "anyOf": [
+    {
+      "type": "boolean"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Is Latest"
+}

addedOutput schema / properties / last_updated

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Last Updated"
+}

addedOutput schema / properties / metrics

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/$defs/Metrics"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

addedOutput schema / properties / ro_crate

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Ro Crate"
+}

addedOutput schema / properties / superseded_by

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Superseded By"
+}

Changed5 schema fields changedv0.16.0May 31, 2026

addedOutput schema / $defs / Creator

Added value: +{
+  "properties": {
+    "name": {
+      "title": "Name",
+      "type": "string"
+    },
+    "orcid": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Orcid"
+    }
+  },
+  "required": [
+    "name"
+  ],
+  "title": "Creator",
+  "type": "object"
+}

addedOutput schema / $defs / FundingRef

Added value: +{
+  "properties": {
+    "award": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Award"
+    },
+    "funder": {
+      "title": "Funder",
+      "type": "string"
+    }
+  },
+  "required": [
+    "funder"
+  ],
+  "title": "FundingRef",
+  "type": "object"
+}

addedOutput schema / properties / creators / items / $ref
```
Added value: +"#/$defs/Creator"
```
removedOutput schema / properties / creators / items / type
```
Removed value: -"string"
```

addedOutput schema / properties / funding

Added value: +{
+  "items": {
+    "$ref": "#/$defs/FundingRef"
+  },
+  "title": "Funding",
+  "type": "array"
+}

First observedv0.11.0May 30, 2026

TDQS

A4.3/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Goes well beyond readOnlyHint=true: it discloses cost/network behavior ('pure/local — no network call' for fair, 'one extra Crossref call' for trust), graceful degradation (citation failures stay null, retraction is null=unknown rather than a false clean claim), and legal/scope caveats (advisory 'NOT legal advice', unrecognized licence yields REVIEW). Unknowns are explicitly reported as unknown, never fabricated.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the core purpose (fetch + files[] manifest) before enumerating optional flags, one sentence per flag, no filler. It is on the long side and duplicates schema parameter docs, which costs a point but not clarity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 6-parameter tool with an output schema and only readOnlyHint annotations, the description carries the behavioral burden well: auto-attach relationships, error/degradation behavior, and advisory framing are all covered. The remaining gap is sibling routing (when to prefer search or fetch instead), which no sentence addresses.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3. The description mostly restates what the schema already documents (citation formats, fair/trust/use semantics, format enum, provenance auto-attaching fair+trust); its only additive value is the concrete id-format examples that the schema's brief 'Source-prefixed id' note lacks.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource — fetch the full DataResource for a known id — and names the distinguishing payload ('the complete files[] manifest'). The id-format examples show exactly what a queryable 'known id' looks like, so an agent can tell this apart from search/fetch without opening a schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The precondition is clear: this is for a KNOWN id, and format=provenance is framed as a 'one-call' alternative to assembling the pieces separately. However, it never names the sibling tools (search, fetch, relate) or states the when-not condition (e.g. 'use search when you do not have an id'), leaving routing to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server