Mdtero Docs

Mdtero turns papers into structured Markdown packages for reading, citation-aware research, and local agent workflows.

Mdtero Account manages sign-in, usage, billing, and API keys. The Python client, browser extension, and agent skill share the same task history and downloads.

Start Here

uv tool install --upgrade mdtero
mdtero setup
mdtero doctor --json

• Read Human And Agent Overview for the normal workflow.
• Read Install to connect an Agent, use the browser extension, or set up the client yourself.
• Read API Reference when integrating your own client.
• Open mdtero.com to manage your account and install options.

What You Can Do

• Discover papers and add selected results to a project.
• Parse a DOI, arXiv link, or a PDF, EPUB, HTML, or XML file you are allowed to use.
• Download Markdown and supporting assets, then request translation.
• Import Zotero or BibTeX metadata without changing your Zotero bibliography.
• Query a project with citations after its documents have been processed.
• Continue a local workflow through the CLI, browser extension, or an installed agent skill.

Safe Handoff

Use JSON output when a local agent continues a workflow:

mdtero doctor --json
mdtero mcp briefing --json

These commands provide task state, available downloads, quality notices, citations, and actionable next steps without printing saved secrets. Give API keys only to trusted machines and enter them at the secure mdtero setup --api-key --json prompt, not on a command line or in chat.

Product Boundaries

Mdtero helps you process material you are permitted to access. Publisher subscriptions, institutional access, and source-specific credentials remain your responsibility. When a paper requires a browser session or a file from your own collection, use the extension or upload the saved file.

Parser implementation and source-selection details are service internals, not user configuration. The stable public contract is the task lifecycle: submit, check status, download, translate, and use the resulting Markdown in a project.