paper-fetch-mcp

Overview Schema Source Related Servers Discussions Admin

batch_fetch

Fetch 1–50 papers in one request with bounded concurrency and input-ordered results, optionally writing an atomic JSONL manifest for reliable batch processing.

Instructions

Fetch 1..50 papers with bounded concurrency and input-ordered compact manifest/acceptance results. It may access remote services and write the same cache, artifacts, or Markdown as fetch_paper. detail=bounded returns only a batch-wide bounded text sample. batch_results atomically writes the final input-ordered JSONL result; overwrite defaults false. Each batch checks managed Camoufox once at start, including HTTP/cache hits (default official/prerelease allows stable and prerelease builds; official/stable excludes prereleases; explicit channel/pins take priority).

Input Schema

Name	Required	Default
`modes`	No
`detail`	No	compact
`target`	No	paper
`queries`	Yes
`strategy`	No
`overwrite`	No
`max_tokens`	No	full_text
`concurrency`	No
`no_download`	No
`download_dir`	No
`include_refs`	No
`prefer_cache`	No
`artifact_mode`	No	markdown-assets
`batch_results`	No
`save_markdown`	No
`content_max_chars`	No
`continue_on_error`	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"
+}

Changed3 schema fields changedv6.1.0Sep 2, 2026

removedInput schema / properties / browser_auto_prepare

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

removedInput schema / properties / resume

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "title": "Resume"
-}

removedInput schema / properties / run_manifest

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "title": "Run Manifest"
-}

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"
-    },
-    "BatchFetchArtifactOutput": {
-      "properties": {
-        "completed_at": {
-          "type": "string"
-        },
-        "failure_code": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "kind": {
-          "type": "string"
-        },
-        "path": {
-          "type": "string"
-        },
-        "resource_uri": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "route": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "sha256": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "size": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "verification_status": {
-          "type": "string"
-        }
-      },
-      "type": "object"
-    },
-    "BatchFetchCompletionOutput": {
-      "properties": {
-        "attempt": {
-          "type": "integer"
-        },
-        "completed_at": {
-          "type": "string"
-        },
-        "index": {
-          "type": "integer"
-        },
-        "sequence": {
-          "type": "integer"
-        },
-        "status": {
-          "type": "string"
-        }
-      },
-      "type": "object"
-    },
-    "BatchFetchItemOutput": {
-      "properties": {
-        "acceptance": {
-          "$ref": "#/$defs/FetchAcceptanceSummaryOutput"
-        },
-        "acquisition": {
-          "anyOf": [
-            {
-              "$ref": "#/$defs/AcquisitionProvenanceOutput"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "attempt": {
-          "type": "integer"
-        },
-        "cache_hit": {
-          "type": "boolean"
-        },
-        "completed_at": {
-          "type": "string"
-        },
-        "completion_sequence": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "content": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "content_available_chars": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "content_returned_chars": {
-          "type": "integer"
-        },
-        "content_truncated": {
-          "type": "boolean"
-        },
-        "doi": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "error": {
-          "anyOf": [
-            {
-              "$ref": "#/$defs/ErrorPayloadOutput"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "failure_codes": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "fallback_codes": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "index": {
-          "type": "integer"
-        },
-        "output_artifacts": {
-          "items": {
-            "$ref": "#/$defs/BatchFetchArtifactOutput"
-          },
-          "type": "array"
-        },
-        "query": {
-          "type": "string"
-        },
-        "record_id": {
-          "type": "string"
-        },
-        "record_status": {
-          "type": "string"
-        },
-        "request_fingerprint": {
-          "type": "string"
-        },
-        "resource_uri": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "reused": {
-          "type": "boolean"
-        },
-        "run_id": {
-          "type": "string"
-        },
-        "saved_markdown_path": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "source": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "started_at": {
-          "type": "string"
-        },
-        "status": {
-          "type": "string"
-        },
-        "warning_codes": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "warnings": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        }
-      },
-      "type": "object"
-    },
-    "BatchFetchLaneCooldownOutput": {
-      "properties": {
-        "cooldown_seconds": {
-          "type": "number"
-        },
-        "lane": {
-          "type": "string"
-        },
-        "reason_code": {
-          "type": "string"
-        },
-        "retry_after_seconds": {
-          "anyOf": [
-            {
-              "type": "number"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "source_index": {
-          "type": "integer"
-        }
-      },
-      "type": "object"
-    },
-    "BatchFetchSummaryOutput": {
-      "properties": {
-        "acceptance": {
-          "additionalProperties": {
-            "type": "integer"
-          },
-          "type": "object"
-        },
-        "cache_hits": {
-          "type": "integer"
-        },
-        "record_statuses": {
-          "additionalProperties": {
-            "type": "integer"
-          },
-          "type": "object"
-        },
-        "saved_markdown": {
-          "type": "integer"
-        }
-      },
-      "type": "object"
-    },
-    "ErrorPayloadOutput": {
-      "properties": {
-        "candidates": {
-          "anyOf": [
-            {
-              "items": {
-                "$ref": "#/$defs/ResolvedCandidateOutput"
-              },
-              "type": "array"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "code": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "details": {
-          "additionalProperties": true,
-          "type": "object"
-        },
-        "error_category": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "http_status": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "missing_env": {
-          "anyOf": [
-            {
-              "items": {
-                "type": "string"
-              },
-              "type": "array"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "provider": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "reason": {
-          "type": "string"
-        },
-        "retry_after_seconds": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "retryable": {
-          "anyOf": [
-            {
-              "type": "boolean"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "route": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "schema_version": {
-          "type": "integer"
-        },
-        "source_trail": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "stage": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "status": {
-          "type": "string"
-        },
-        "trace": {
-          "items": {
-            "$ref": "#/$defs/TraceEventOutput"
-          },
-          "type": "array"
-        },
-        "warnings": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        }
-      },
-      "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"
-    },
-    "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"
-    },
-    "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": {
-    "aborted": {
-      "type": "boolean"
-    },
-    "attempted_count": {
-      "type": "integer"
-    },
-    "cancelled": {
-      "type": "boolean"
-    },
-    "candidates": {
-      "anyOf": [
-        {
-          "items": {
-            "$ref": "#/$defs/ResolvedCandidateOutput"
-          },
-          "type": "array"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "code": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "completion_order": {
-      "items": {
-        "$ref": "#/$defs/BatchFetchCompletionOutput"
-      },
-      "type": "array"
-    },
-    "content_max_chars": {
-      "type": "integer"
-    },
-    "content_returned_chars": {
-      "type": "integer"
-    },
-    "deduplicated_count": {
-      "type": "integer"
-    },
-    "detail": {
-      "type": "string"
-    },
-    "details": {
-      "additionalProperties": true,
-      "type": "object"
-    },
-    "error_category": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "events_path": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "execution_count": {
-      "type": "integer"
-    },
-    "execution_policy": {
-      "additionalProperties": true,
-      "type": "object"
-    },
-    "http_status": {
-      "anyOf": [
-        {
-          "type": "integer"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "lane_cooldowns": {
-      "items": {
-        "$ref": "#/$defs/BatchFetchLaneCooldownOutput"
-      },
-      "type": "array"
-    },
-    "missing_env": {
-      "anyOf": [
-        {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "not_scheduled_count": {
-      "type": "integer"
-    },
-    "persisted": {
-      "type": "boolean"
-    },
-    "provider": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "query_count": {
-      "type": "integer"
-    },
-    "reason": {
-      "type": "string"
-    },
-    "request_fingerprint": {
-      "type": "string"
-    },
-    "results": {
-      "items": {
-        "$ref": "#/$defs/BatchFetchItemOutput"
-      },
-      "type": "array"
-    },
-    "retry_after_seconds": {
-      "anyOf": [
-        {
-          "type": "integer"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "retryable": {
-      "anyOf": [
-        {
-          "type": "boolean"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "reused_count": {
-      "type": "integer"
-    },
-    "route": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "run_id": {
-      "type": "string"
-    },
-    "run_manifest_path": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "schema_version": {
-      "type": "integer"
-    },
-    "semantic_fingerprint": {
-      "type": "string"
-    },
-    "source_trail": {
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    },
-    "stage": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "state": {
-      "type": "string"
-    },
-    "status": {
-      "type": "string"
-    },
-    "summary": {
-      "$ref": "#/$defs/BatchFetchSummaryOutput"
-    },
-    "trace": {
-      "items": {
-        "$ref": "#/$defs/TraceEventOutput"
-      },
-      "type": "array"
-    },
-    "warnings": {
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    }
-  },
-  "type": "object"
-}New value: +null

Changed10 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 / BatchFetchArtifactOutput / properties / failure_code

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

addedOutput schema / $defs / BatchFetchArtifactOutput / properties / route

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

addedOutput schema / $defs / BatchFetchItemOutput / 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 / deduplicated_count
```
Added value: +{
+  "type": "integer"
+}
```
addedOutput schema / properties / execution_count
```
Added value: +{
+  "type": "integer"
+}
```

addedOutput schema / properties / execution_policy

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

addedOutput schema / properties / not_scheduled_count
```
Added value: +{
+  "type": "integer"
+}
```
addedOutput schema / properties / semantic_fingerprint
```
Added value: +{
+  "type": "string"
+}
```

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"
+}

Changed3 schema fields changedv5.2.0Aug 7, 2026

removedOutput schema / $defs / BatchFetchAcceptanceOutput

Removed 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"
-}

changedOutput schema / $defs / BatchFetchItemOutput / properties / acceptance / $ref

Previous value: -"#/$defs/BatchFetchAcceptanceOutput"New value: +"#/$defs/FetchAcceptanceSummaryOutput"

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"
+}

Changed159 schema fields changedv4.1.0Jul 30, 2026
- removedOutput schema / $defs / BatchFetchAcceptanceOutput / properties / asset / title
```
Removed value: -"Asset"
```
- removedOutput schema / $defs / BatchFetchAcceptanceOutput / properties / content / title
```
Removed value: -"Content"
```
- removedOutput schema / $defs / BatchFetchAcceptanceOutput / properties / fetch / title
```
Removed value: -"Fetch"
```
- removedOutput schema / $defs / BatchFetchAcceptanceOutput / properties / has_abstract / title
```
Removed value: -"Has Abstract"
```
- removedOutput schema / $defs / BatchFetchAcceptanceOutput / properties / has_fulltext / title
```
Removed value: -"Has Fulltext"
```
- removedOutput schema / $defs / BatchFetchAcceptanceOutput / properties / identity / title
```
Removed value: -"Identity"
```
- removedOutput schema / $defs / BatchFetchAcceptanceOutput / properties / output / title
```
Removed value: -"Output"
```
- removedOutput schema / $defs / BatchFetchAcceptanceOutput / properties / overall / title
```
Removed value: -"Overall"
```
- removedOutput schema / $defs / BatchFetchAcceptanceOutput / properties / provenance / title
```
Removed value: -"Provenance"
```
- removedOutput schema / $defs / BatchFetchAcceptanceOutput / properties / token_estimate / title
```
Removed value: -"Token Estimate"
```
- removedOutput schema / $defs / BatchFetchAcceptanceOutput / title
```
Removed value: -"BatchFetchAcceptanceOutput"
```
- removedOutput schema / $defs / BatchFetchArtifactOutput / properties / completed_at / title
```
Removed value: -"Completed At"
```
- removedOutput schema / $defs / BatchFetchArtifactOutput / properties / kind / title
```
Removed value: -"Kind"
```
- removedOutput schema / $defs / BatchFetchArtifactOutput / properties / path / title
```
Removed value: -"Path"
```
- removedOutput schema / $defs / BatchFetchArtifactOutput / properties / resource_uri / title
```
Removed value: -"Resource Uri"
```
- removedOutput schema / $defs / BatchFetchArtifactOutput / properties / sha256 / title
```
Removed value: -"Sha256"
```
- removedOutput schema / $defs / BatchFetchArtifactOutput / properties / size / title
```
Removed value: -"Size"
```
- removedOutput schema / $defs / BatchFetchArtifactOutput / properties / verification_status / title
```
Removed value: -"Verification Status"
```
- removedOutput schema / $defs / BatchFetchArtifactOutput / title
```
Removed value: -"BatchFetchArtifactOutput"
```
- removedOutput schema / $defs / BatchFetchCompletionOutput / properties / attempt / title
```
Removed value: -"Attempt"
```
- removedOutput schema / $defs / BatchFetchCompletionOutput / properties / completed_at / title
```
Removed value: -"Completed At"
```
- removedOutput schema / $defs / BatchFetchCompletionOutput / properties / index / title
```
Removed value: -"Index"
```
- removedOutput schema / $defs / BatchFetchCompletionOutput / properties / sequence / title
```
Removed value: -"Sequence"
```
- removedOutput schema / $defs / BatchFetchCompletionOutput / properties / status / title
```
Removed value: -"Status"
```
- removedOutput schema / $defs / BatchFetchCompletionOutput / title
```
Removed value: -"BatchFetchCompletionOutput"
```
- removedOutput schema / $defs / BatchFetchItemOutput / properties / attempt / title
```
Removed value: -"Attempt"
```
- removedOutput schema / $defs / BatchFetchItemOutput / properties / cache_hit / title
```
Removed value: -"Cache Hit"
```
- removedOutput schema / $defs / BatchFetchItemOutput / properties / completed_at / title
```
Removed value: -"Completed At"
```
- removedOutput schema / $defs / BatchFetchItemOutput / properties / completion_sequence / title
```
Removed value: -"Completion Sequence"
```
- removedOutput schema / $defs / BatchFetchItemOutput / properties / content / title
```
Removed value: -"Content"
```
- removedOutput schema / $defs / BatchFetchItemOutput / properties / content_available_chars / title
```
Removed value: -"Content Available Chars"
```
- removedOutput schema / $defs / BatchFetchItemOutput / properties / content_returned_chars / title
```
Removed value: -"Content Returned Chars"
```
- removedOutput schema / $defs / BatchFetchItemOutput / properties / content_truncated / title
```
Removed value: -"Content Truncated"
```
- removedOutput schema / $defs / BatchFetchItemOutput / properties / doi / title
```
Removed value: -"Doi"
```
- removedOutput schema / $defs / BatchFetchItemOutput / properties / failure_codes / title
```
Removed value: -"Failure Codes"
```
- removedOutput schema / $defs / BatchFetchItemOutput / properties / fallback_codes / title
```
Removed value: -"Fallback Codes"
```
- removedOutput schema / $defs / BatchFetchItemOutput / properties / index / title
```
Removed value: -"Index"
```
- removedOutput schema / $defs / BatchFetchItemOutput / properties / output_artifacts / title
```
Removed value: -"Output Artifacts"
```
- removedOutput schema / $defs / BatchFetchItemOutput / properties / query / title
```
Removed value: -"Query"
```
- removedOutput schema / $defs / BatchFetchItemOutput / properties / record_id / title
```
Removed value: -"Record Id"
```
- removedOutput schema / $defs / BatchFetchItemOutput / properties / record_status / title
```
Removed value: -"Record Status"
```
- removedOutput schema / $defs / BatchFetchItemOutput / properties / request_fingerprint / title
```
Removed value: -"Request Fingerprint"
```
- removedOutput schema / $defs / BatchFetchItemOutput / properties / resource_uri / title
```
Removed value: -"Resource Uri"
```
- removedOutput schema / $defs / BatchFetchItemOutput / properties / reused / title
```
Removed value: -"Reused"
```
- removedOutput schema / $defs / BatchFetchItemOutput / properties / run_id / title
```
Removed value: -"Run Id"
```
- removedOutput schema / $defs / BatchFetchItemOutput / properties / saved_markdown_path / title
```
Removed value: -"Saved Markdown Path"
```
- removedOutput schema / $defs / BatchFetchItemOutput / properties / source / title
```
Removed value: -"Source"
```
- removedOutput schema / $defs / BatchFetchItemOutput / properties / started_at / title
```
Removed value: -"Started At"
```
- removedOutput schema / $defs / BatchFetchItemOutput / properties / status / title
```
Removed value: -"Status"
```
- removedOutput schema / $defs / BatchFetchItemOutput / properties / warning_codes / title
```
Removed value: -"Warning Codes"
```
- removedOutput schema / $defs / BatchFetchItemOutput / properties / warnings / title
```
Removed value: -"Warnings"
```
- removedOutput schema / $defs / BatchFetchItemOutput / title
```
Removed value: -"BatchFetchItemOutput"
```
- removedOutput schema / $defs / BatchFetchLaneCooldownOutput / properties / cooldown_seconds / title
```
Removed value: -"Cooldown Seconds"
```
- removedOutput schema / $defs / BatchFetchLaneCooldownOutput / properties / lane / title
```
Removed value: -"Lane"
```
- removedOutput schema / $defs / BatchFetchLaneCooldownOutput / properties / reason_code / title
```
Removed value: -"Reason Code"
```
- removedOutput schema / $defs / BatchFetchLaneCooldownOutput / properties / retry_after_seconds / title
```
Removed value: -"Retry After Seconds"
```
- removedOutput schema / $defs / BatchFetchLaneCooldownOutput / properties / source_index / title
```
Removed value: -"Source Index"
```
- removedOutput schema / $defs / BatchFetchLaneCooldownOutput / title
```
Removed value: -"BatchFetchLaneCooldownOutput"
```
- removedOutput schema / $defs / BatchFetchSummaryOutput / properties / acceptance / title
```
Removed value: -"Acceptance"
```
- removedOutput schema / $defs / BatchFetchSummaryOutput / properties / cache_hits / title
```
Removed value: -"Cache Hits"
```
- removedOutput schema / $defs / BatchFetchSummaryOutput / properties / record_statuses / title
```
Removed value: -"Record Statuses"
```
- removedOutput schema / $defs / BatchFetchSummaryOutput / properties / saved_markdown / title
```
Removed value: -"Saved Markdown"
```
- removedOutput schema / $defs / BatchFetchSummaryOutput / title
```
Removed value: -"BatchFetchSummaryOutput"
```
- removedOutput schema / $defs / ErrorPayloadOutput / properties / candidates / title
```
Removed value: -"Candidates"
```
- removedOutput schema / $defs / ErrorPayloadOutput / properties / code / title
```
Removed value: -"Code"
```
- addedOutput schema / $defs / ErrorPayloadOutput / properties / details
```
Added value: +{
+  "additionalProperties": true,
+  "type": "object"
+}
```
- removedOutput schema / $defs / ErrorPayloadOutput / properties / error_category / title
```
Removed value: -"Error Category"
```
- removedOutput schema / $defs / ErrorPayloadOutput / properties / http_status / title
```
Removed value: -"Http Status"
```
- removedOutput schema / $defs / ErrorPayloadOutput / properties / missing_env / title
```
Removed value: -"Missing Env"
```
- removedOutput schema / $defs / ErrorPayloadOutput / properties / provider / title
```
Removed value: -"Provider"
```
- removedOutput schema / $defs / ErrorPayloadOutput / properties / reason / title
```
Removed value: -"Reason"
```
- removedOutput schema / $defs / ErrorPayloadOutput / properties / retry_after_seconds / title
```
Removed value: -"Retry After Seconds"
```
- addedOutput schema / $defs / ErrorPayloadOutput / properties / retryable
```
Added value: +{
+  "anyOf": [
+    {
+      "type": "boolean"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
```
- addedOutput schema / $defs / ErrorPayloadOutput / properties / route
```
Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
```
- removedOutput schema / $defs / ErrorPayloadOutput / properties / schema_version / title
```
Removed value: -"Schema Version"
```
- removedOutput schema / $defs / ErrorPayloadOutput / properties / source_trail / title
```
Removed value: -"Source Trail"
```
- addedOutput schema / $defs / ErrorPayloadOutput / properties / stage
```
Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
```
- removedOutput schema / $defs / ErrorPayloadOutput / properties / status / title
```
Removed value: -"Status"
```
- addedOutput schema / $defs / ErrorPayloadOutput / properties / trace
```
Added value: +{
+  "items": {
+    "$ref": "#/$defs/TraceEventOutput"
+  },
+  "type": "array"
+}
```
- removedOutput schema / $defs / ErrorPayloadOutput / properties / warnings / title
```
Removed value: -"Warnings"
```
- removedOutput schema / $defs / ErrorPayloadOutput / title
```
Removed value: -"ErrorPayloadOutput"
```
- 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"
```
- addedOutput schema / $defs / TraceEventOutput
```
Added value: +{
+  "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"
+}
```
- removedOutput schema / properties / aborted / default
```
Removed value: -null
```
- removedOutput schema / properties / aborted / title
```
Removed value: -"Aborted"
```
- removedOutput schema / properties / attempted_count / default
```
Removed value: -null
```
- removedOutput schema / properties / attempted_count / title
```
Removed value: -"Attempted Count"
```
- removedOutput schema / properties / cancelled / default
```
Removed value: -null
```
- removedOutput schema / properties / cancelled / title
```
Removed value: -"Cancelled"
```
- 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 / completion_order / default
```
Removed value: -null
```
- removedOutput schema / properties / completion_order / title
```
Removed value: -"Completion Order"
```
- removedOutput schema / properties / content_max_chars / default
```
Removed value: -null
```
- removedOutput schema / properties / content_max_chars / title
```
Removed value: -"Content Max Chars"
```
- removedOutput schema / properties / content_returned_chars / default
```
Removed value: -null
```
- removedOutput schema / properties / content_returned_chars / title
```
Removed value: -"Content Returned Chars"
```
- removedOutput schema / properties / detail / default
```
Removed value: -null
```
- removedOutput schema / properties / detail / title
```
Removed value: -"Detail"
```
- addedOutput schema / properties / details
```
Added value: +{
+  "additionalProperties": true,
+  "type": "object"
+}
```
- removedOutput schema / properties / error_category / default
```
Removed value: -null
```
- removedOutput schema / properties / error_category / title
```
Removed value: -"Error Category"
```
- removedOutput schema / properties / events_path / default
```
Removed value: -null
```
- removedOutput schema / properties / events_path / title
```
Removed value: -"Events Path"
```
- removedOutput schema / properties / http_status / default
```
Removed value: -null
```
- removedOutput schema / properties / http_status / title
```
Removed value: -"Http Status"
```
- removedOutput schema / properties / lane_cooldowns / default
```
Removed value: -null
```
- removedOutput schema / properties / lane_cooldowns / title
```
Removed value: -"Lane Cooldowns"
```
- removedOutput schema / properties / missing_env / default
```
Removed value: -null
```
- removedOutput schema / properties / missing_env / title
```
Removed value: -"Missing Env"
```
- removedOutput schema / properties / persisted / default
```
Removed value: -null
```
- removedOutput schema / properties / persisted / title
```
Removed value: -"Persisted"
```
- removedOutput schema / properties / provider / default
```
Removed value: -null
```
- removedOutput schema / properties / provider / title
```
Removed value: -"Provider"
```
- removedOutput schema / properties / query_count / default
```
Removed value: -null
```
- removedOutput schema / properties / query_count / title
```
Removed value: -"Query Count"
```
- removedOutput schema / properties / reason / default
```
Removed value: -null
```
- removedOutput schema / properties / reason / title
```
Removed value: -"Reason"
```
- removedOutput schema / properties / request_fingerprint / default
```
Removed value: -null
```
- removedOutput schema / properties / request_fingerprint / title
```
Removed value: -"Request Fingerprint"
```
- removedOutput schema / properties / results / default
```
Removed value: -null
```
- removedOutput schema / properties / results / title
```
Removed value: -"Results"
```
- 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"
+    }
+  ]
+}
```
- removedOutput schema / properties / reused_count / default
```
Removed value: -null
```
- removedOutput schema / properties / reused_count / title
```
Removed value: -"Reused Count"
```
- addedOutput schema / properties / route
```
Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
```
- removedOutput schema / properties / run_id / default
```
Removed value: -null
```
- removedOutput schema / properties / run_id / title
```
Removed value: -"Run Id"
```
- removedOutput schema / properties / run_manifest_path / default
```
Removed value: -null
```
- removedOutput schema / properties / run_manifest_path / title
```
Removed value: -"Run Manifest Path"
```
- removedOutput schema / properties / schema_version / default
```
Removed value: -null
```
- removedOutput schema / properties / schema_version / title
```
Removed value: -"Schema Version"
```
- 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 / state / default
```
Removed value: -null
```
- removedOutput schema / properties / state / title
```
Removed value: -"State"
```
- removedOutput schema / properties / status / default
```
Removed value: -null
```
- removedOutput schema / properties / status / title
```
Removed value: -"Status"
```
- removedOutput schema / properties / summary / default
```
Removed value: -null
```
- addedOutput schema / properties / trace
```
Added value: +{
+  "items": {
+    "$ref": "#/$defs/TraceEventOutput"
+  },
+  "type": "array"
+}
```
- removedOutput schema / properties / warnings / default
```
Removed value: -null
```
- removedOutput schema / properties / warnings / title
```
Removed value: -"Warnings"
```
- removedOutput schema / title
```
Removed value: -"BatchFetchOutput"
```
Addedv3.2.0Jul 25, 2026

TDQS

A3.7/5.0

Behavior5/5

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

Beyond annotations, the description discloses remote access, cache/artifact/Markdown writes, atomic input-ordered JSONL output via batch_results, overwrite defaulting to false, bounded detail behavior, and a managed Camoufox check at batch start. These details materially expand on the supplied annotations without contradicting them.

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?

The core batch purpose is front-loaded, but the description is a dense paragraph mixing invocation-relevant details with low-level Camoufox channel behavior. It is not bloated overall, but it could be structured more clearly.

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

Completeness2/5

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

For a 19-parameter batch tool with no output schema and no schema parameter descriptions, the description is incomplete: it says results are a "compact manifest/acceptance" and that batch_results produces JSONL, but does not explain the result shape. Many parameters and nested strategy options remain undocumented, leaving the agent to infer behavior from names and defaults.

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

Parameters2/5

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

With 19 parameters and 0% schema description coverage, the description explains only a few: queries are limited to 1..50, concurrency is bounded, detail=bounded returns a batch-wide text sample, and batch_results atomically writes ordered JSONL with overwrite defaulting to false. Most parameters, including modes, target, strategy, max_tokens, artifact_mode, and markdown-related options, receive no semantic explanation.

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 states a specific verb and resource: "Fetch 1..50 papers" with bounded concurrency and input-ordered results. The 1..50 limitation and batch-specific result handling distinguish it from the single-paper sibling fetch_paper.

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?

Usage is implied by the batch scope (1..50 papers), but there is no explicit when-to-use guidance versus fetch_paper, batch_check, or batch_resolve. The mention of fetch_paper explains shared cache/artifact behavior rather than routing criteria.

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

Deploy Server

batch_fetch

Instructions

Input Schema

Schema Changelog

TDQS

Other Tools