fetch_paper
Fetch a paper by DOI, URL, or title and return its structured article, markdown, and metadata with provenance, quality, and token estimates. Enables AI agents to 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
| Name | Required | Description | Default |
|---|---|---|---|
| modes | No | ||
| query | Yes | ||
| strategy | No | ||
| max_tokens | No | full_text | |
| no_download | No | ||
| download_dir | No | ||
| include_refs | No | ||
| prefer_cache | No | ||
| artifact_mode | No | markdown-assets | |
| save_markdown | No | ||
| markdown_filename | No | ||
| markdown_output_dir | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| doi | No | ||
| code | No | ||
| route | No | ||
| stage | No | ||
| trace | No | ||
| reason | No | ||
| source | No | ||
| status | No | ||
| article | No | ||
| details | No | ||
| quality | No | ||
| markdown | No | ||
| metadata | No | ||
| provider | No | ||
| warnings | No | ||
| retryable | No | ||
| candidates | No | ||
| http_status | No | ||
| missing_env | No | ||
| content_kind | No | ||
| has_abstract | No | ||
| has_fulltext | No | ||
| source_trail | No | ||
| error_category | No | ||
| schema_version | No | ||
| token_estimate | No | ||
| retry_after_seconds | No | ||
| saved_markdown_path | No | ||
| token_estimate_breakdown | No |