fetch_paper
Fetch a paper by DOI, URL, or title to get structured Markdown full text, metadata, and assets, enabling 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 | ||
| acceptance | 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 | ||
| diagnostic_artifacts | No | ||
| token_estimate_breakdown | No |