Skip to main content
Glama

fetch_paper

Retrieve a paper's full-text Markdown, structured article, and metadata from DOI, URL, or title, with provenance, quality, and token estimates, so AI agents can read beyond abstracts.

Instructions

Fetch one paper as structured article, Markdown, and/or metadata with provenance, 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

TableJSON Schema
NameRequiredDescriptionDefault
modesNo
queryYes
strategyNo
max_tokensNofull_text
no_downloadNo
download_dirNo
include_refsNo
prefer_cacheNo
artifact_modeNomarkdown-assets
save_markdownNo
markdown_filenameNo
markdown_output_dirNo

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. Changed1 schema field changedv6.1.0
    • removedInput schema / properties / browser_auto_prepare
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "type": "boolean"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "default": null,
      -  "title": "Browser Auto Prepare"
      -}
  2. Changed3 schema fields changedv6.0.1
    • 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
  3. Changed4 schema fields changedv5.5.0
    • 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"
      +    }
      +  ]
      +}
  4. Changed1 schema field changedv5.4.1
    • addedInput schema / properties / browser_auto_prepare
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "boolean"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Browser Auto Prepare"
      +}
  5. Changed12 schema fields changedv5.2.0
    • 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"
      +}
  6. Changed214 schema fields changedv4.1.0
    • 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"
  7. Addedv3.1.3
  8. Removedv3.1.3
  9. First observedv1.0.0

TDQS

A4.7/5.0
Behavior5/5

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

Even though annotations indicate a non-read-only, side-effect-capable tool, the description adds substantial behavioral detail: remote service access, provider artifact writes, MCP cache sidecar, no_download suppression, save_markdown path return, artifact_mode cache retention, asset_profile ImageContent bounds, and access-control boundaries. It goes well beyond the annotations.

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

Conciseness5/5

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

The description is dense but every sentence adds meaningful information. It front-loads the core action and defaults, then layers side-effect semantics, cache behavior, and resource pointers. For a tool with 12 parameters and nested options, this is appropriately sized rather than bloated.

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

Completeness5/5

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

Given the tool's complexity, 0% schema coverage, and no output schema, the description covers the key aspects needed for correct invocation: required query, default modes, side-effect control, cache matching semantics, output forms including path and ImageContent, and a pointer to the provider catalog for environment-specific facts.

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

Parameters4/5

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

Schema description coverage is 0%, so the description carries the parameter-meaning burden. It explains the purpose and defaults for many parameters, including modes, include_refs, max_tokens, prefer_cache, no_download, save_markdown, artifact_mode, and asset_profile. Some parameters such as download_dir, markdown_filename, preferred_providers, and inline_image_budget are not explained, so it is not a 5.

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?

The description opens with a specific verb and resource: 'Fetch one paper as structured article, Markdown, and/or metadata...'. It clearly identifies the core output modes and distinguishes itself from siblings like batch_fetch and get_cached by emphasizing single-paper fetch.

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 description gives explicit operational guidance: defaults, fallback behavior, no_download=true suppressing writes, save_markdown=true as an explicit write, artifact_mode semantics, and the warning to use prefer_cache=true only with matching request semantics. It does not explicitly name alternatives like batch_fetch, so it is not a 5.

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

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Dictation354/paper-fetch-skill'

If you have feedback or need assistance with the MCP directory API, please join our Discord server