paper-fetch-mcp

Overview Schema Source Related Servers Discussions Admin

fetch_paper

Fetch a paper as structured article, Markdown, or metadata with provenance; use the supplementary target to discover and download independent materials without a body or PDF.

Instructions

Fetch one paper as structured article, Markdown, and/or metadata with provenance, or use target=supplementary for independent material discovery/download without a body or body PDF. target defaults to paper; supplementary ignores body asset/render options, returns a structured supplementary list and a material-only Markdown index. Empty complete discovery returns no_result; no_download returns unarchived links. quality, trace, and token estimates. Defaults are modes=article+markdown, provider-default assets, metadata-only fallback enabled, include_refs=null, max_tokens=full_text, prefer_cache=false, no_download=false, artifact_mode=markdown-assets and save_markdown=false. The call may access remote services and write provider artifacts, assets, and an MCP cache sidecar. no_download=true suppresses those writes; save_markdown=true is an explicit separate write and returns a path instead of inline full text. artifact_mode=none suppresses provider artifacts but retains MCP cache semantics. asset_profile=none|body|all controls local assets; body/all may return bounded ImageContent. Use prefer_cache=true only with matching request semantics. Current provider/source/runtime/asset-default facts are at resource://paper-fetch/provider-catalog. Access controls and manual-auth boundaries are never bypassed.

Input Schema

Name	Required	Default
`modes`	No
`query`	Yes
`target`	No	paper
`strategy`	No
`max_tokens`	No	full_text
`no_download`	No
`download_dir`	No
`include_refs`	No
`prefer_cache`	No
`artifact_mode`	No	markdown-assets
`save_markdown`	No
`markdown_filename`	No
`markdown_output_dir`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedv7.2.4Oct 28, 2026

addedInput schema / properties / target

Added value: +{
+  "default": "paper",
+  "enum": [
+    "paper",
+    "supplementary"
+  ],
+  "title": "Target",
+  "type": "string"
+}

Changed1 schema field changedv6.1.0Sep 2, 2026

removedInput schema / properties / browser_auto_prepare

Removed value: -{
-  "anyOf": [
-    {
-      "type": "boolean"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "title": "Browser Auto Prepare"
-}

Changed3 schema fields changedv6.0.1Aug 29, 2026

addedInput schema / properties / strategy / properties / require_full_size_body_assets

Added value: +{
+  "default": false,
+  "title": "Require Full Size Body Assets",
+  "type": "boolean"
+}

addedInput schema / properties / strategy / properties / require_local_body_assets

Added value: +{
+  "default": false,
+  "title": "Require Local Body Assets",
+  "type": "boolean"
+}

changedOutput schema / (root)

Previous value: -{
-  "$defs": {
-    "AcquisitionProvenanceOutput": {
-      "properties": {
-        "fallback_used": {
-          "type": "boolean"
-        },
-        "provider": {
-          "type": "string"
-        },
-        "representation": {
-          "type": "string"
-        },
-        "route": {
-          "type": "string"
-        },
-        "transport": {
-          "type": "string"
-        }
-      },
-      "type": "object"
-    },
-    "ArticleOutput": {
-      "properties": {
-        "acquisition": {
-          "anyOf": [
-            {
-              "$ref": "#/$defs/AcquisitionProvenanceOutput"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "assets": {
-          "items": {
-            "$ref": "#/$defs/AssetOutput"
-          },
-          "type": "array"
-        },
-        "doi": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "metadata": {
-          "$ref": "#/$defs/MetadataOutput"
-        },
-        "quality": {
-          "$ref": "#/$defs/QualityOutput"
-        },
-        "references": {
-          "items": {
-            "$ref": "#/$defs/ReferenceOutput"
-          },
-          "type": "array"
-        },
-        "sections": {
-          "items": {
-            "$ref": "#/$defs/SectionOutput"
-          },
-          "type": "array"
-        },
-        "source": {
-          "type": "string"
-        }
-      },
-      "type": "object"
-    },
-    "AssetByKindOutput": {
-      "properties": {
-        "decoration": {
-          "$ref": "#/$defs/AssetKindSummaryOutput"
-        },
-        "figure": {
-          "$ref": "#/$defs/AssetKindSummaryOutput"
-        },
-        "formula": {
-          "$ref": "#/$defs/AssetKindSummaryOutput"
-        },
-        "supplement": {
-          "$ref": "#/$defs/AssetKindSummaryOutput"
-        },
-        "table": {
-          "$ref": "#/$defs/AssetKindSummaryOutput"
-        }
-      },
-      "type": "object"
-    },
-    "AssetDiagnosticOutput": {
-      "properties": {
-        "byte_count": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "download_tier": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "failure_code": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "height": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "kind": {
-          "type": "string"
-        },
-        "path": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "preview_accepted": {
-          "type": "boolean"
-        },
-        "provenance": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "real_mime": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "request_profile": {
-          "type": "string"
-        },
-        "sha256": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "status": {
-          "type": "string"
-        },
-        "suspected_reasons": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "width": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        }
-      },
-      "type": "object"
-    },
-    "AssetFailureOutput": {
-      "properties": {
-        "body_snippet": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "caption": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "content_type": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "final_url": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "heading": {
-          "type": "string"
-        },
-        "kind": {
-          "type": "string"
-        },
-        "reason": {
-          "type": "string"
-        },
-        "recovery_attempts": {
-          "items": {
-            "additionalProperties": true,
-            "type": "object"
-          },
-          "type": "array"
-        },
-        "section": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "source_url": {
-          "type": "string"
-        },
-        "status": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "title_snippet": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        }
-      },
-      "type": "object"
-    },
-    "AssetKindSummaryOutput": {
-      "properties": {
-        "accepted_preview": {
-          "type": "integer"
-        },
-        "failed": {
-          "type": "integer"
-        },
-        "fallback_preview": {
-          "type": "integer"
-        },
-        "full_size": {
-          "type": "integer"
-        },
-        "not_archived": {
-          "type": "integer"
-        },
-        "not_requested": {
-          "type": "integer"
-        },
-        "placeholder_suspected": {
-          "type": "integer"
-        },
-        "preview": {
-          "type": "integer"
-        },
-        "requested": {
-          "type": "integer"
-        },
-        "total": {
-          "type": "integer"
-        }
-      },
-      "type": "object"
-    },
-    "AssetOutput": {
-      "properties": {
-        "anchor_key": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "caption": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "content_type": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "download_tier": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "download_url": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "downloaded_bytes": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "heading": {
-          "type": "string"
-        },
-        "height": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "kind": {
-          "type": "string"
-        },
-        "original_url": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "path": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "preview_accepted": {
-          "type": "boolean"
-        },
-        "provenance": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "render_state": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "section": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "source_href": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "source_path": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "source_url": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "url": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "width": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        }
-      },
-      "type": "object"
-    },
-    "AssetQualitySummaryOutput": {
-      "properties": {
-        "accepted_preview": {
-          "type": "integer"
-        },
-        "audited": {
-          "type": "boolean"
-        },
-        "by_kind": {
-          "$ref": "#/$defs/AssetByKindOutput"
-        },
-        "diagnostics": {
-          "items": {
-            "$ref": "#/$defs/AssetDiagnosticOutput"
-          },
-          "type": "array"
-        },
-        "failed": {
-          "type": "integer"
-        },
-        "failure_codes": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "fallback_preview": {
-          "type": "integer"
-        },
-        "full_size": {
-          "type": "integer"
-        },
-        "issue_codes": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "local": {
-          "type": "integer"
-        },
-        "not_archived": {
-          "type": "integer"
-        },
-        "not_requested": {
-          "type": "integer"
-        },
-        "placeholder_suspected": {
-          "type": "integer"
-        },
-        "preview": {
-          "type": "integer"
-        },
-        "profile": {
-          "type": "string"
-        },
-        "remote_link_count": {
-          "type": "integer"
-        },
-        "remote_only_count": {
-          "type": "integer"
-        },
-        "requested": {
-          "type": "boolean"
-        },
-        "total": {
-          "type": "integer"
-        }
-      },
-      "type": "object"
-    },
-    "BodyMetricsOutput": {
-      "properties": {
-        "body_block_count": {
-          "type": "integer"
-        },
-        "body_heading_count": {
-          "type": "integer"
-        },
-        "body_to_abstract_ratio": {
-          "type": "number"
-        },
-        "char_count": {
-          "type": "integer"
-        },
-        "explicit_body_container": {
-          "type": "boolean"
-        },
-        "figure_count": {
-          "type": "integer"
-        },
-        "post_abstract_body_run": {
-          "type": "boolean"
-        },
-        "word_count": {
-          "type": "integer"
-        }
-      },
-      "type": "object"
-    },
-    "FetchAcceptanceSummaryOutput": {
-      "properties": {
-        "acquisition": {
-          "anyOf": [
-            {
-              "$ref": "#/$defs/AcquisitionProvenanceOutput"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "asset": {
-          "type": "string"
-        },
-        "content": {
-          "type": "string"
-        },
-        "fetch": {
-          "type": "string"
-        },
-        "has_abstract": {
-          "type": "boolean"
-        },
-        "has_fulltext": {
-          "type": "boolean"
-        },
-        "identity": {
-          "type": "string"
-        },
-        "output": {
-          "type": "string"
-        },
-        "overall": {
-          "type": "string"
-        },
-        "provenance": {
-          "type": "string"
-        },
-        "token_estimate": {
-          "type": "integer"
-        }
-      },
-      "type": "object"
-    },
-    "MetadataOutput": {
-      "properties": {
-        "abstract": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "article_type": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "authors": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "journal": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "keywords": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "landing_page_url": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "license_urls": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "published": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "title": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        }
-      },
-      "type": "object"
-    },
-    "QualityOutput": {
-      "properties": {
-        "asset_failures": {
-          "items": {
-            "$ref": "#/$defs/AssetFailureOutput"
-          },
-          "type": "array"
-        },
-        "asset_summary": {
-          "$ref": "#/$defs/AssetQualitySummaryOutput"
-        },
-        "body_metrics": {
-          "$ref": "#/$defs/BodyMetricsOutput"
-        },
-        "confidence": {
-          "type": "string"
-        },
-        "content_kind": {
-          "type": "string"
-        },
-        "extraction_revision": {
-          "type": "integer"
-        },
-        "flags": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "has_abstract": {
-          "type": "boolean"
-        },
-        "has_fulltext": {
-          "type": "boolean"
-        },
-        "semantic_losses": {
-          "$ref": "#/$defs/SemanticLossesOutput"
-        },
-        "source_trail": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "token_estimate": {
-          "type": "integer"
-        },
-        "token_estimate_breakdown": {
-          "$ref": "#/$defs/TokenEstimateBreakdownOutput"
-        },
-        "warnings": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        }
-      },
-      "type": "object"
-    },
-    "ReferenceOutput": {
-      "properties": {
-        "doi": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "raw": {
-          "type": "string"
-        },
-        "title": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "year": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        }
-      },
-      "type": "object"
-    },
-    "ResolvedCandidateOutput": {
-      "properties": {
-        "author_score": {
-          "type": "number"
-        },
-        "authors": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "doi": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "journal_title": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "landing_page_url": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "provider_hint": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "published": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "score": {
-          "type": "number"
-        },
-        "title": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "title_score": {
-          "type": "number"
-        },
-        "year_score": {
-          "type": "number"
-        }
-      },
-      "type": "object"
-    },
-    "SectionOutput": {
-      "properties": {
-        "heading": {
-          "type": "string"
-        },
-        "kind": {
-          "type": "string"
-        },
-        "level": {
-          "type": "integer"
-        },
-        "text": {
-          "type": "string"
-        }
-      },
-      "type": "object"
-    },
-    "SemanticLossesOutput": {
-      "properties": {
-        "formula_fallback_count": {
-          "type": "integer"
-        },
-        "formula_missing_count": {
-          "type": "integer"
-        },
-        "table_fallback_count": {
-          "type": "integer"
-        },
-        "table_layout_degraded_count": {
-          "type": "integer"
-        },
-        "table_lossy_count": {
-          "type": "integer"
-        },
-        "table_semantic_loss_count": {
-          "type": "integer"
-        }
-      },
-      "type": "object"
-    },
-    "TokenEstimateBreakdownOutput": {
-      "properties": {
-        "abstract": {
-          "type": "integer"
-        },
-        "body": {
-          "type": "integer"
-        },
-        "refs": {
-          "type": "integer"
-        }
-      },
-      "type": "object"
-    },
-    "TraceEventOutput": {
-      "properties": {
-        "attempt": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "attempt_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "code": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "component": {
-          "type": "string"
-        },
-        "duration_ms": {
-          "anyOf": [
-            {
-              "type": "number"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "error_category": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "finished_at": {
-          "anyOf": [
-            {
-              "type": "number"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "http_status": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "message": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "outcome": {
-          "type": "string"
-        },
-        "parent_span_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "provider": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "retry_after_seconds": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "retryable": {
-          "anyOf": [
-            {
-              "type": "boolean"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "route": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "span_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "stage": {
-          "type": "string"
-        },
-        "started_at": {
-          "anyOf": [
-            {
-              "type": "number"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "target": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "target_sha256": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        }
-      },
-      "type": "object"
-    }
-  },
-  "properties": {
-    "acceptance": {
-      "$ref": "#/$defs/FetchAcceptanceSummaryOutput"
-    },
-    "acquisition": {
-      "anyOf": [
-        {
-          "$ref": "#/$defs/AcquisitionProvenanceOutput"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "article": {
-      "anyOf": [
-        {
-          "$ref": "#/$defs/ArticleOutput"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "candidates": {
-      "anyOf": [
-        {
-          "items": {
-            "$ref": "#/$defs/ResolvedCandidateOutput"
-          },
-          "type": "array"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "code": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "content_kind": {
-      "type": "string"
-    },
-    "details": {
-      "additionalProperties": true,
-      "type": "object"
-    },
-    "diagnostic_artifacts": {
-      "items": {
-        "additionalProperties": true,
-        "type": "object"
-      },
-      "type": "array"
-    },
-    "doi": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "error_category": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "has_abstract": {
-      "type": "boolean"
-    },
-    "has_fulltext": {
-      "type": "boolean"
-    },
-    "http_status": {
-      "anyOf": [
-        {
-          "type": "integer"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "markdown": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "metadata": {
-      "anyOf": [
-        {
-          "$ref": "#/$defs/MetadataOutput"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "missing_env": {
-      "anyOf": [
-        {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "provider": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "quality": {
-      "$ref": "#/$defs/QualityOutput"
-    },
-    "reason": {
-      "type": "string"
-    },
-    "retry_after_seconds": {
-      "anyOf": [
-        {
-          "type": "integer"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "retryable": {
-      "anyOf": [
-        {
-          "type": "boolean"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "route": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "saved_markdown_path": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "schema_version": {
-      "type": "integer"
-    },
-    "source": {
-      "type": "string"
-    },
-    "source_trail": {
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    },
-    "stage": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "status": {
-      "type": "string"
-    },
-    "token_estimate": {
-      "type": "integer"
-    },
-    "token_estimate_breakdown": {
-      "$ref": "#/$defs/TokenEstimateBreakdownOutput"
-    },
-    "trace": {
-      "items": {
-        "$ref": "#/$defs/TraceEventOutput"
-      },
-      "type": "array"
-    },
-    "warnings": {
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    }
-  },
-  "type": "object"
-}New value: +null

Changed4 schema fields changedv5.5.0Aug 26, 2026

addedOutput schema / $defs / AcquisitionProvenanceOutput

Added value: +{
+  "properties": {
+    "fallback_used": {
+      "type": "boolean"
+    },
+    "provider": {
+      "type": "string"
+    },
+    "representation": {
+      "type": "string"
+    },
+    "route": {
+      "type": "string"
+    },
+    "transport": {
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

addedOutput schema / $defs / ArticleOutput / properties / acquisition

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

addedOutput schema / $defs / FetchAcceptanceSummaryOutput / properties / acquisition

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

addedOutput schema / properties / acquisition

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

Changed1 schema field changedv5.4.1Aug 20, 2026

addedInput schema / properties / browser_auto_prepare

Added value: +{
+  "anyOf": [
+    {
+      "type": "boolean"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Browser Auto Prepare"
+}

Changed12 schema fields changedv5.2.0Aug 7, 2026

addedOutput schema / $defs / AssetDiagnosticOutput / properties / preview_accepted
```
Added value: +{
+  "type": "boolean"
+}
```
addedOutput schema / $defs / AssetKindSummaryOutput / properties / accepted_preview
```
Added value: +{
+  "type": "integer"
+}
```
addedOutput schema / $defs / AssetKindSummaryOutput / properties / fallback_preview
```
Added value: +{
+  "type": "integer"
+}
```
addedOutput schema / $defs / AssetOutput / properties / preview_accepted
```
Added value: +{
+  "type": "boolean"
+}
```
addedOutput schema / $defs / AssetQualitySummaryOutput / properties / accepted_preview
```
Added value: +{
+  "type": "integer"
+}
```
addedOutput schema / $defs / AssetQualitySummaryOutput / properties / fallback_preview
```
Added value: +{
+  "type": "integer"
+}
```

addedOutput schema / $defs / AssetQualitySummaryOutput / properties / issue_codes

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

addedOutput schema / $defs / FetchAcceptanceSummaryOutput

Added value: +{
+  "properties": {
+    "asset": {
+      "type": "string"
+    },
+    "content": {
+      "type": "string"
+    },
+    "fetch": {
+      "type": "string"
+    },
+    "has_abstract": {
+      "type": "boolean"
+    },
+    "has_fulltext": {
+      "type": "boolean"
+    },
+    "identity": {
+      "type": "string"
+    },
+    "output": {
+      "type": "string"
+    },
+    "overall": {
+      "type": "string"
+    },
+    "provenance": {
+      "type": "string"
+    },
+    "token_estimate": {
+      "type": "integer"
+    }
+  },
+  "type": "object"
+}

addedOutput schema / $defs / MetadataOutput / properties / article_type

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

removedOutput schema / $defs / QualityOutput / properties / trace

Removed value: -{
-  "items": {
-    "$ref": "#/$defs/TraceEventOutput"
-  },
-  "type": "array"
-}

addedOutput schema / properties / acceptance

Added value: +{
+  "$ref": "#/$defs/FetchAcceptanceSummaryOutput"
+}

addedOutput schema / properties / diagnostic_artifacts

Added value: +{
+  "items": {
+    "additionalProperties": true,
+    "type": "object"
+  },
+  "type": "array"
+}

Changed214 schema fields changedv4.1.0Jul 30, 2026
- removedOutput schema / $defs / ArticleOutput / properties / assets / title
```
Removed value: -"Assets"
```
- removedOutput schema / $defs / ArticleOutput / properties / doi / title
```
Removed value: -"Doi"
```
- removedOutput schema / $defs / ArticleOutput / properties / references / title
```
Removed value: -"References"
```
- removedOutput schema / $defs / ArticleOutput / properties / sections / title
```
Removed value: -"Sections"
```
- removedOutput schema / $defs / ArticleOutput / properties / source / title
```
Removed value: -"Source"
```
- removedOutput schema / $defs / ArticleOutput / title
```
Removed value: -"ArticleOutput"
```
- removedOutput schema / $defs / AssetByKindOutput / title
```
Removed value: -"AssetByKindOutput"
```
- removedOutput schema / $defs / AssetDiagnosticOutput / properties / byte_count / title
```
Removed value: -"Byte Count"
```
- removedOutput schema / $defs / AssetDiagnosticOutput / properties / download_tier / title
```
Removed value: -"Download Tier"
```
- removedOutput schema / $defs / AssetDiagnosticOutput / properties / failure_code / title
```
Removed value: -"Failure Code"
```
- removedOutput schema / $defs / AssetDiagnosticOutput / properties / height / title
```
Removed value: -"Height"
```
- removedOutput schema / $defs / AssetDiagnosticOutput / properties / kind / title
```
Removed value: -"Kind"
```
- removedOutput schema / $defs / AssetDiagnosticOutput / properties / path / title
```
Removed value: -"Path"
```
- removedOutput schema / $defs / AssetDiagnosticOutput / properties / provenance / title
```
Removed value: -"Provenance"
```
- removedOutput schema / $defs / AssetDiagnosticOutput / properties / real_mime / title
```
Removed value: -"Real Mime"
```
- removedOutput schema / $defs / AssetDiagnosticOutput / properties / request_profile / title
```
Removed value: -"Request Profile"
```
- removedOutput schema / $defs / AssetDiagnosticOutput / properties / sha256 / title
```
Removed value: -"Sha256"
```
- removedOutput schema / $defs / AssetDiagnosticOutput / properties / status / title
```
Removed value: -"Status"
```
- removedOutput schema / $defs / AssetDiagnosticOutput / properties / suspected_reasons / title
```
Removed value: -"Suspected Reasons"
```
- removedOutput schema / $defs / AssetDiagnosticOutput / properties / width / title
```
Removed value: -"Width"
```
- removedOutput schema / $defs / AssetDiagnosticOutput / title
```
Removed value: -"AssetDiagnosticOutput"
```
- removedOutput schema / $defs / AssetFailureOutput / properties / body_snippet / title
```
Removed value: -"Body Snippet"
```
- removedOutput schema / $defs / AssetFailureOutput / properties / caption / title
```
Removed value: -"Caption"
```
- removedOutput schema / $defs / AssetFailureOutput / properties / content_type / title
```
Removed value: -"Content Type"
```
- removedOutput schema / $defs / AssetFailureOutput / properties / final_url / title
```
Removed value: -"Final Url"
```
- removedOutput schema / $defs / AssetFailureOutput / properties / heading / title
```
Removed value: -"Heading"
```
- removedOutput schema / $defs / AssetFailureOutput / properties / kind / title
```
Removed value: -"Kind"
```
- removedOutput schema / $defs / AssetFailureOutput / properties / reason / title
```
Removed value: -"Reason"
```
- removedOutput schema / $defs / AssetFailureOutput / properties / recovery_attempts / title
```
Removed value: -"Recovery Attempts"
```
- removedOutput schema / $defs / AssetFailureOutput / properties / section / title
```
Removed value: -"Section"
```
- removedOutput schema / $defs / AssetFailureOutput / properties / source_url / title
```
Removed value: -"Source Url"
```
- removedOutput schema / $defs / AssetFailureOutput / properties / status / title
```
Removed value: -"Status"
```
- removedOutput schema / $defs / AssetFailureOutput / properties / title_snippet / title
```
Removed value: -"Title Snippet"
```
- removedOutput schema / $defs / AssetFailureOutput / title
```
Removed value: -"AssetFailureOutput"
```
- removedOutput schema / $defs / AssetKindSummaryOutput / properties / failed / title
```
Removed value: -"Failed"
```
- removedOutput schema / $defs / AssetKindSummaryOutput / properties / full_size / title
```
Removed value: -"Full Size"
```
- removedOutput schema / $defs / AssetKindSummaryOutput / properties / not_archived / title
```
Removed value: -"Not Archived"
```
- removedOutput schema / $defs / AssetKindSummaryOutput / properties / not_requested / title
```
Removed value: -"Not Requested"
```
- removedOutput schema / $defs / AssetKindSummaryOutput / properties / placeholder_suspected / title
```
Removed value: -"Placeholder Suspected"
```
- removedOutput schema / $defs / AssetKindSummaryOutput / properties / preview / title
```
Removed value: -"Preview"
```
- removedOutput schema / $defs / AssetKindSummaryOutput / properties / requested / title
```
Removed value: -"Requested"
```
- removedOutput schema / $defs / AssetKindSummaryOutput / properties / total / title
```
Removed value: -"Total"
```
- removedOutput schema / $defs / AssetKindSummaryOutput / title
```
Removed value: -"AssetKindSummaryOutput"
```
- removedOutput schema / $defs / AssetOutput / properties / anchor_key / title
```
Removed value: -"Anchor Key"
```
- removedOutput schema / $defs / AssetOutput / properties / caption / title
```
Removed value: -"Caption"
```
- removedOutput schema / $defs / AssetOutput / properties / content_type / title
```
Removed value: -"Content Type"
```
- removedOutput schema / $defs / AssetOutput / properties / download_tier / title
```
Removed value: -"Download Tier"
```
- removedOutput schema / $defs / AssetOutput / properties / download_url / title
```
Removed value: -"Download Url"
```
- removedOutput schema / $defs / AssetOutput / properties / downloaded_bytes / title
```
Removed value: -"Downloaded Bytes"
```
- removedOutput schema / $defs / AssetOutput / properties / heading / title
```
Removed value: -"Heading"
```
- removedOutput schema / $defs / AssetOutput / properties / height / title
```
Removed value: -"Height"
```
- removedOutput schema / $defs / AssetOutput / properties / kind / title
```
Removed value: -"Kind"
```
- removedOutput schema / $defs / AssetOutput / properties / original_url / title
```
Removed value: -"Original Url"
```
- removedOutput schema / $defs / AssetOutput / properties / path / title
```
Removed value: -"Path"
```
- removedOutput schema / $defs / AssetOutput / properties / provenance / title
```
Removed value: -"Provenance"
```
- removedOutput schema / $defs / AssetOutput / properties / render_state / title
```
Removed value: -"Render State"
```
- removedOutput schema / $defs / AssetOutput / properties / section / title
```
Removed value: -"Section"
```
- removedOutput schema / $defs / AssetOutput / properties / source_href / title
```
Removed value: -"Source Href"
```
- removedOutput schema / $defs / AssetOutput / properties / source_path / title
```
Removed value: -"Source Path"
```
- removedOutput schema / $defs / AssetOutput / properties / source_url / title
```
Removed value: -"Source Url"
```
- removedOutput schema / $defs / AssetOutput / properties / url / title
```
Removed value: -"Url"
```
- removedOutput schema / $defs / AssetOutput / properties / width / title
```
Removed value: -"Width"
```
- removedOutput schema / $defs / AssetOutput / title
```
Removed value: -"AssetOutput"
```
- removedOutput schema / $defs / AssetQualitySummaryOutput / properties / audited / title
```
Removed value: -"Audited"
```
- removedOutput schema / $defs / AssetQualitySummaryOutput / properties / diagnostics / title
```
Removed value: -"Diagnostics"
```
- removedOutput schema / $defs / AssetQualitySummaryOutput / properties / failed / title
```
Removed value: -"Failed"
```
- removedOutput schema / $defs / AssetQualitySummaryOutput / properties / failure_codes / title
```
Removed value: -"Failure Codes"
```
- removedOutput schema / $defs / AssetQualitySummaryOutput / properties / full_size / title
```
Removed value: -"Full Size"
```
- removedOutput schema / $defs / AssetQualitySummaryOutput / properties / local / title
```
Removed value: -"Local"
```
- removedOutput schema / $defs / AssetQualitySummaryOutput / properties / not_archived / title
```
Removed value: -"Not Archived"
```
- removedOutput schema / $defs / AssetQualitySummaryOutput / properties / not_requested / title
```
Removed value: -"Not Requested"
```
- removedOutput schema / $defs / AssetQualitySummaryOutput / properties / placeholder_suspected / title
```
Removed value: -"Placeholder Suspected"
```
- removedOutput schema / $defs / AssetQualitySummaryOutput / properties / preview / title
```
Removed value: -"Preview"
```
- removedOutput schema / $defs / AssetQualitySummaryOutput / properties / profile / title
```
Removed value: -"Profile"
```
- removedOutput schema / $defs / AssetQualitySummaryOutput / properties / remote_link_count / title
```
Removed value: -"Remote Link Count"
```
- removedOutput schema / $defs / AssetQualitySummaryOutput / properties / remote_only_count / title
```
Removed value: -"Remote Only Count"
```
- removedOutput schema / $defs / AssetQualitySummaryOutput / properties / requested / title
```
Removed value: -"Requested"
```
- removedOutput schema / $defs / AssetQualitySummaryOutput / properties / total / title
```
Removed value: -"Total"
```
- removedOutput schema / $defs / AssetQualitySummaryOutput / title
```
Removed value: -"AssetQualitySummaryOutput"
```
- removedOutput schema / $defs / BodyMetricsOutput / properties / body_block_count / title
```
Removed value: -"Body Block Count"
```
- removedOutput schema / $defs / BodyMetricsOutput / properties / body_heading_count / title
```
Removed value: -"Body Heading Count"
```
- removedOutput schema / $defs / BodyMetricsOutput / properties / body_to_abstract_ratio / title
```
Removed value: -"Body To Abstract Ratio"
```
- removedOutput schema / $defs / BodyMetricsOutput / properties / char_count / title
```
Removed value: -"Char Count"
```
- removedOutput schema / $defs / BodyMetricsOutput / properties / explicit_body_container / title
```
Removed value: -"Explicit Body Container"
```
- removedOutput schema / $defs / BodyMetricsOutput / properties / figure_count / title
```
Removed value: -"Figure Count"
```
- removedOutput schema / $defs / BodyMetricsOutput / properties / post_abstract_body_run / title
```
Removed value: -"Post Abstract Body Run"
```
- removedOutput schema / $defs / BodyMetricsOutput / properties / word_count / title
```
Removed value: -"Word Count"
```
- removedOutput schema / $defs / BodyMetricsOutput / title
```
Removed value: -"BodyMetricsOutput"
```
- removedOutput schema / $defs / MetadataOutput / properties / abstract / title
```
Removed value: -"Abstract"
```
- removedOutput schema / $defs / MetadataOutput / properties / authors / title
```
Removed value: -"Authors"
```
- removedOutput schema / $defs / MetadataOutput / properties / journal / title
```
Removed value: -"Journal"
```
- removedOutput schema / $defs / MetadataOutput / properties / keywords / title
```
Removed value: -"Keywords"
```
- removedOutput schema / $defs / MetadataOutput / properties / landing_page_url / title
```
Removed value: -"Landing Page Url"
```
- removedOutput schema / $defs / MetadataOutput / properties / license_urls / title
```
Removed value: -"License Urls"
```
- removedOutput schema / $defs / MetadataOutput / properties / published / title
```
Removed value: -"Published"
```
- removedOutput schema / $defs / MetadataOutput / properties / title / title
```
Removed value: -"Title"
```
- removedOutput schema / $defs / MetadataOutput / title
```
Removed value: -"MetadataOutput"
```
- removedOutput schema / $defs / QualityOutput / properties / asset_failures / title
```
Removed value: -"Asset Failures"
```
- removedOutput schema / $defs / QualityOutput / properties / confidence / title
```
Removed value: -"Confidence"
```
- removedOutput schema / $defs / QualityOutput / properties / content_kind / title
```
Removed value: -"Content Kind"
```
- removedOutput schema / $defs / QualityOutput / properties / extraction_revision / title
```
Removed value: -"Extraction Revision"
```
- removedOutput schema / $defs / QualityOutput / properties / flags / title
```
Removed value: -"Flags"
```
- removedOutput schema / $defs / QualityOutput / properties / has_abstract / title
```
Removed value: -"Has Abstract"
```
- removedOutput schema / $defs / QualityOutput / properties / has_fulltext / title
```
Removed value: -"Has Fulltext"
```
- removedOutput schema / $defs / QualityOutput / properties / source_trail / title
```
Removed value: -"Source Trail"
```
- removedOutput schema / $defs / QualityOutput / properties / token_estimate / title
```
Removed value: -"Token Estimate"
```
- removedOutput schema / $defs / QualityOutput / properties / trace / title
```
Removed value: -"Trace"
```
- removedOutput schema / $defs / QualityOutput / properties / warnings / title
```
Removed value: -"Warnings"
```
- removedOutput schema / $defs / QualityOutput / title
```
Removed value: -"QualityOutput"
```
- removedOutput schema / $defs / ReferenceOutput / properties / doi / title
```
Removed value: -"Doi"
```
- removedOutput schema / $defs / ReferenceOutput / properties / raw / title
```
Removed value: -"Raw"
```
- removedOutput schema / $defs / ReferenceOutput / properties / title / title
```
Removed value: -"Title"
```
- removedOutput schema / $defs / ReferenceOutput / properties / year / title
```
Removed value: -"Year"
```
- removedOutput schema / $defs / ReferenceOutput / title
```
Removed value: -"ReferenceOutput"
```
- removedOutput schema / $defs / ResolvedCandidateOutput / properties / author_score / title
```
Removed value: -"Author Score"
```
- removedOutput schema / $defs / ResolvedCandidateOutput / properties / authors / title
```
Removed value: -"Authors"
```
- removedOutput schema / $defs / ResolvedCandidateOutput / properties / doi / title
```
Removed value: -"Doi"
```
- removedOutput schema / $defs / ResolvedCandidateOutput / properties / journal_title / title
```
Removed value: -"Journal Title"
```
- removedOutput schema / $defs / ResolvedCandidateOutput / properties / landing_page_url / title
```
Removed value: -"Landing Page Url"
```
- removedOutput schema / $defs / ResolvedCandidateOutput / properties / provider_hint / title
```
Removed value: -"Provider Hint"
```
- removedOutput schema / $defs / ResolvedCandidateOutput / properties / published / title
```
Removed value: -"Published"
```
- removedOutput schema / $defs / ResolvedCandidateOutput / properties / score / title
```
Removed value: -"Score"
```
- removedOutput schema / $defs / ResolvedCandidateOutput / properties / title / title
```
Removed value: -"Title"
```
- removedOutput schema / $defs / ResolvedCandidateOutput / properties / title_score / title
```
Removed value: -"Title Score"
```
- removedOutput schema / $defs / ResolvedCandidateOutput / properties / year_score / title
```
Removed value: -"Year Score"
```
- removedOutput schema / $defs / ResolvedCandidateOutput / title
```
Removed value: -"ResolvedCandidateOutput"
```
- removedOutput schema / $defs / SectionOutput / properties / heading / title
```
Removed value: -"Heading"
```
- removedOutput schema / $defs / SectionOutput / properties / kind / title
```
Removed value: -"Kind"
```
- removedOutput schema / $defs / SectionOutput / properties / level / title
```
Removed value: -"Level"
```
- removedOutput schema / $defs / SectionOutput / properties / text / title
```
Removed value: -"Text"
```
- removedOutput schema / $defs / SectionOutput / title
```
Removed value: -"SectionOutput"
```
- removedOutput schema / $defs / SemanticLossesOutput / properties / formula_fallback_count / title
```
Removed value: -"Formula Fallback Count"
```
- removedOutput schema / $defs / SemanticLossesOutput / properties / formula_missing_count / title
```
Removed value: -"Formula Missing Count"
```
- removedOutput schema / $defs / SemanticLossesOutput / properties / table_fallback_count / title
```
Removed value: -"Table Fallback Count"
```
- removedOutput schema / $defs / SemanticLossesOutput / properties / table_layout_degraded_count / title
```
Removed value: -"Table Layout Degraded Count"
```
- removedOutput schema / $defs / SemanticLossesOutput / properties / table_lossy_count / title
```
Removed value: -"Table Lossy Count"
```
- removedOutput schema / $defs / SemanticLossesOutput / properties / table_semantic_loss_count / title
```
Removed value: -"Table Semantic Loss Count"
```
- removedOutput schema / $defs / SemanticLossesOutput / title
```
Removed value: -"SemanticLossesOutput"
```
- removedOutput schema / $defs / TokenEstimateBreakdownOutput / properties / abstract / title
```
Removed value: -"Abstract"
```
- removedOutput schema / $defs / TokenEstimateBreakdownOutput / properties / body / title
```
Removed value: -"Body"
```
- removedOutput schema / $defs / TokenEstimateBreakdownOutput / properties / refs / title
```
Removed value: -"Refs"
```
- removedOutput schema / $defs / TokenEstimateBreakdownOutput / title
```
Removed value: -"TokenEstimateBreakdownOutput"
```
- addedOutput schema / $defs / TraceEventOutput / properties / attempt
```
Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
```
- addedOutput schema / $defs / TraceEventOutput / properties / attempt_id
```
Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
```
- removedOutput schema / $defs / TraceEventOutput / properties / code / title
```
Removed value: -"Code"
```
- removedOutput schema / $defs / TraceEventOutput / properties / component / title
```
Removed value: -"Component"
```
- addedOutput schema / $defs / TraceEventOutput / properties / duration_ms
```
Added value: +{
+  "anyOf": [
+    {
+      "type": "number"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
```
- addedOutput schema / $defs / TraceEventOutput / properties / error_category
```
Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
```
- addedOutput schema / $defs / TraceEventOutput / properties / finished_at
```
Added value: +{
+  "anyOf": [
+    {
+      "type": "number"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
```
- addedOutput schema / $defs / TraceEventOutput / properties / http_status
```
Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
```
- removedOutput schema / $defs / TraceEventOutput / properties / message / title
```
Removed value: -"Message"
```
- removedOutput schema / $defs / TraceEventOutput / properties / outcome / title
```
Removed value: -"Outcome"
```
- addedOutput schema / $defs / TraceEventOutput / properties / parent_span_id
```
Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
```
- addedOutput schema / $defs / TraceEventOutput / properties / provider
```
Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
```
- addedOutput schema / $defs / TraceEventOutput / properties / retry_after_seconds
```
Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
```
- addedOutput schema / $defs / TraceEventOutput / properties / retryable
```
Added value: +{
+  "anyOf": [
+    {
+      "type": "boolean"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
```
- addedOutput schema / $defs / TraceEventOutput / properties / route
```
Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
```
- addedOutput schema / $defs / TraceEventOutput / properties / span_id
```
Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
```
- removedOutput schema / $defs / TraceEventOutput / properties / stage / title
```
Removed value: -"Stage"
```
- addedOutput schema / $defs / TraceEventOutput / properties / started_at
```
Added value: +{
+  "anyOf": [
+    {
+      "type": "number"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
```
- addedOutput schema / $defs / TraceEventOutput / properties / target
```
Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
```
- addedOutput schema / $defs / TraceEventOutput / properties / target_sha256
```
Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
```
- removedOutput schema / $defs / TraceEventOutput / title
```
Removed value: -"TraceEventOutput"
```
- removedOutput schema / properties / article / default
```
Removed value: -null
```
- removedOutput schema / properties / candidates / default
```
Removed value: -null
```
- removedOutput schema / properties / candidates / title
```
Removed value: -"Candidates"
```
- removedOutput schema / properties / code / default
```
Removed value: -null
```
- removedOutput schema / properties / code / title
```
Removed value: -"Code"
```
- removedOutput schema / properties / content_kind / default
```
Removed value: -null
```
- removedOutput schema / properties / content_kind / title
```
Removed value: -"Content Kind"
```
- addedOutput schema / properties / details
```
Added value: +{
+  "additionalProperties": true,
+  "type": "object"
+}
```
- removedOutput schema / properties / doi / default
```
Removed value: -null
```
- removedOutput schema / properties / doi / title
```
Removed value: -"Doi"
```
- removedOutput schema / properties / error_category / default
```
Removed value: -null
```
- removedOutput schema / properties / error_category / title
```
Removed value: -"Error Category"
```
- removedOutput schema / properties / has_abstract / default
```
Removed value: -null
```
- removedOutput schema / properties / has_abstract / title
```
Removed value: -"Has Abstract"
```
- removedOutput schema / properties / has_fulltext / default
```
Removed value: -null
```
- removedOutput schema / properties / has_fulltext / title
```
Removed value: -"Has Fulltext"
```
- removedOutput schema / properties / http_status / default
```
Removed value: -null
```
- removedOutput schema / properties / http_status / title
```
Removed value: -"Http Status"
```
- removedOutput schema / properties / markdown / default
```
Removed value: -null
```
- removedOutput schema / properties / markdown / title
```
Removed value: -"Markdown"
```
- removedOutput schema / properties / metadata / default
```
Removed value: -null
```
- removedOutput schema / properties / missing_env / default
```
Removed value: -null
```
- removedOutput schema / properties / missing_env / title
```
Removed value: -"Missing Env"
```
- removedOutput schema / properties / provider / default
```
Removed value: -null
```
- removedOutput schema / properties / provider / title
```
Removed value: -"Provider"
```
- removedOutput schema / properties / quality / default
```
Removed value: -null
```
- removedOutput schema / properties / reason / default
```
Removed value: -null
```
- removedOutput schema / properties / reason / title
```
Removed value: -"Reason"
```
- removedOutput schema / properties / retry_after_seconds / default
```
Removed value: -null
```
- removedOutput schema / properties / retry_after_seconds / title
```
Removed value: -"Retry After Seconds"
```
- addedOutput schema / properties / retryable
```
Added value: +{
+  "anyOf": [
+    {
+      "type": "boolean"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
```
- addedOutput schema / properties / route
```
Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
```
- removedOutput schema / properties / saved_markdown_path / default
```
Removed value: -null
```
- removedOutput schema / properties / saved_markdown_path / title
```
Removed value: -"Saved Markdown Path"
```
- removedOutput schema / properties / schema_version / default
```
Removed value: -null
```
- removedOutput schema / properties / schema_version / title
```
Removed value: -"Schema Version"
```
- removedOutput schema / properties / source / default
```
Removed value: -null
```
- removedOutput schema / properties / source / title
```
Removed value: -"Source"
```
- removedOutput schema / properties / source_trail / default
```
Removed value: -null
```
- removedOutput schema / properties / source_trail / title
```
Removed value: -"Source Trail"
```
- addedOutput schema / properties / stage
```
Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
```
- removedOutput schema / properties / status / default
```
Removed value: -null
```
- removedOutput schema / properties / status / title
```
Removed value: -"Status"
```
- removedOutput schema / properties / token_estimate / default
```
Removed value: -null
```
- removedOutput schema / properties / token_estimate / title
```
Removed value: -"Token Estimate"
```
- removedOutput schema / properties / token_estimate_breakdown / default
```
Removed value: -null
```
- removedOutput schema / properties / trace / default
```
Removed value: -null
```
- removedOutput schema / properties / trace / title
```
Removed value: -"Trace"
```
- removedOutput schema / properties / warnings / default
```
Removed value: -null
```
- removedOutput schema / properties / warnings / title
```
Removed value: -"Warnings"
```
- removedOutput schema / title
```
Removed value: -"FetchPaperOutput"
```
Addedv3.1.3Jul 18, 2026
Removedv3.1.3Jul 18, 2026
First observedv1.0.0Jul 11, 2026

TDQS

A3.8/5.0

Behavior5/5

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

Goes well beyond the annotations by disclosing remote-service access, provider-artifact/asset/cache-sidecar writes, and how no_download, save_markdown, artifact_mode, and asset_profile each affect those writes. It also documents failure modes (no_result, no_download returning unarchived links) and that manual-auth boundaries are never bypassed. Nothing here repeats what readOnlyHint/openWorldHint already say.

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

Conciseness3/5

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

Front-loads the core purpose, but then collapses into a dense run-on paragraph of defaults and mode interactions, including a sentence fragment ("quality, trace, and token estimates."). The information is valuable but poorly structured and hard to scan for a 13-param tool.

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 13-param tool with nested objects and no output schema, the description is largely complete: it covers side effects, defaults, cache/write toggles, and several return semantics (supplementary list, material-only Markdown index, no_result, unarchived links). A few return-shape and nested-strategy details remain unaddressed, keeping it short of full.

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?

With 0% schema description coverage the description carries a real burden, and it explains target, modes defaults, no_download, save_markdown, artifact_mode, asset_profile, prefer_cache, max_tokens, and include_refs well. But the nested strategy fields (preferred_providers, require_local_body_assets, require_full_size_body_assets, inline_image_budget sub-fields) and the path params (download_dir, markdown_filename, markdown_output_dir) are left undocumented.

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

Purpose4/5

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

States a specific verb+resource (fetch one paper) and enumerates its output forms (structured article, Markdown, metadata with provenance), plus the target=supplementary variant. An agent knows what it produces, but the description never differentiates it from siblings like batch_fetch or resolve_paper, so the reader must infer when this single-paper tool is preferred.

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

Usage Guidelines3/5

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

Provides useful conditional guidance for one axis: use target=supplementary for independent material discovery without a body, and use prefer_cache=true only with matching request semantics. However, it gives no guidance on when to choose this over batch_fetch, get_cached, or resolve_paper, so sibling selection is left implicit.

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

Deploy Server

fetch_paper

Instructions

Input Schema

Schema Changelog

TDQS

Other Tools