Skip to main content

adfontes

Full-text academic and technical literature reader CLI and stdio Model Context Protocol (MCP) server for coding agents.

Given a paper identifier (arXiv, DOI, PMCID, PMID), specification (IETF RFC), or URL, adfontes fetches open-access full text, stages it locally, and prints a compact provenance header with a line- or page-indexed Table of Contents. Paywalled works return bibliographic metadata and an abstract without fabricating full text.


Installation

NOTE: PyPI and crates.io publishing is pending initial registry setup. Until adfontes is live on both registries, install temporarily from GitHub Releases or Git.

Python (uv)

Download a prebuilt wheel from GitHub Releases and install it with uv:

uv tool install ./adfontes-*.whl

Standalone Binary

Download a prebuilt archive from GitHub Releases for Linux, macOS, or Windows, or build from Git:

cargo install --git https://github.com/Kajiih/adfontes --locked

Quickstart

Fetch a paper, specification, or web article:

adfontes fetch 2409.13740                          # arXiv paper
adfontes fetch 10.1038/s41586-025-10072-4          # DOI
adfontes fetch PMC11456789                         # PubMed Central (or PMID:38123456)
adfontes fetch "RFC 9110"                          # IETF RFC
adfontes fetch https://example.org/article         # web page, Markdown, GitHub blob, or PDF
adfontes fetch 2409.13740 -o /tmp/lit              # custom staging directory

Extract a lossless 1–8-page vector slice from a staged PDF:

adfontes slice-pdf /tmp/adfontes/paper.pdf -p 8-10

Start the stdio MCP server:

adfontes mcp

Register adfontes in mcp_config.json to expose the fetch and slice_pdf tools:

{
  "mcpServers": {
    "adfontes": {
      "command": "/absolute/path/to/adfontes",
      "args": ["mcp"]
    }
  }
}

Supported Sources

adfontes resolves each target through a keyless open-access waterfall:

Source Examples Resolution Order
arXiv 2409.13740, arXiv:2409.13740v1 arxiv.org/html → ar5iv → TeX source → PDF
DOI 10.1038/..., https://doi.org/... Crossref/OpenAlex/Unpaywall → PMCID/arXiv → open-access PDF/HTML → metadata only
PMCID / PMID PMC11456789, PMID:38123456 Europe PMC JATS XML → DOI/arXiv fallback → open-access PDF → metadata only
IETF RFC RFC 9110, rfc7231 Datatracker status notes → RFCXML v3 → plain text
Web / GitHub https://..., github.com/.../blob/... GitHub raw rewrite → text/markdown → HTML math/table extractor, text, or PDF

Configuration

Configure staging confinement, outbound host rules, and polite-pool metadata access through environment variables:

Variable Purpose
ADFONTES_STAGING_DIR Default staging directory.
ADFONTES_EXTRA_ALLOWED_ROOTS Additional allowed staging roots (: on Unix, ; on Windows).
ADFONTES_FORBIDDEN_PATH_PREFIXES Additional absolute path prefixes blocked from staging.
ADFONTES_BLOCKED_HOST_SUFFIXES Comma-separated domain suffixes blocked from outbound HTTP(S).
ADFONTES_CONTACT_EMAIL Contact email enabling Unpaywall and OpenAlex polite-pool queries.
ADFONTES_DISABLE_PDF_SLICE Truthy value (1, true, yes, on) disables local PDF slicing.
HTTPS_PROXY, HTTP_PROXY, NO_PROXY Standard HTTP(S) proxy settings (SOCKS proxies are rejected).

License

MIT — see LICENSE.

Metadata

Release files for adfontes 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for adfontes 0.1.0
File Size Uploaded Provenance Actions
adfontes-0.1.0.tar.gz 162.7 kB With provenance Details for adfontes-0.1.0.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for adfontes 0.1.0
File Actions
adfontes-0.1.0-cp310-abi3-win_amd64.whl CPython 3.10 abi3 Windows x86-64 Details for adfontes-0.1.0-cp310-abi3-win_amd64.whl
adfontes-0.1.0-cp310-abi3-manylinux_2_28_x86_64.whl CPython 3.10 abi3 Linux glibc 2.28+ x86-64 Details for adfontes-0.1.0-cp310-abi3-manylinux_2_28_x86_64.whl
adfontes-0.1.0-cp310-abi3-manylinux_2_28_aarch64.whl CPython 3.10 abi3 Linux glibc 2.28+ ARM64 Details for adfontes-0.1.0-cp310-abi3-manylinux_2_28_aarch64.whl
adfontes-0.1.0-cp310-abi3-macosx_11_0_arm64.whl CPython 3.10 abi3 macOS 11.0+ ARM64 Details for adfontes-0.1.0-cp310-abi3-macosx_11_0_arm64.whl
adfontes-0.1.0-cp310-abi3-macosx_10_12_x86_64.whl CPython 3.10 abi3 macOS 10.12+ x86-64 Details for adfontes-0.1.0-cp310-abi3-macosx_10_12_x86_64.whl

Total release size: 15.4 MB

Release files / adfontes-0.1.0.tar.gz

Download URL adfontes-0.1.0.tar.gz
Size 162.7 kB
Tags Source
SHA-256 checksum
How to use checksums
e68dd861b96ee7ffc205269bd20917c9adc137cda8644d226ac11c143d4fcc6d
BLAKE2b-256 checksum
How to use checksums
b728e3a256bf4b605f07b0d7bc214b976b5adf0876cef2b2f7e70600d4f96f6b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

Release files / adfontes-0.1.0-cp310-abi3-win_amd64.whl

Download URL adfontes-0.1.0-cp310-abi3-win_amd64.whl
Size 3.1 MB
Tags CPython 3.10 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
7f9ad8effe0133bbe36cbbbf0e169789e27c02ea3e6023ede4b848dd595e04bd
BLAKE2b-256 checksum
How to use checksums
81462680b83816a4bc21ae95c1996d492e0891a514c3286aebd9b756c9a3a8b6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

Release files / adfontes-0.1.0-cp310-abi3-manylinux_2_28_x86_64.whl

Download URL adfontes-0.1.0-cp310-abi3-manylinux_2_28_x86_64.whl
Size 3.1 MB
Tags CPython 3.10 Linux glibc 2.28+ x86-64 abi3
SHA-256 checksum
How to use checksums
1dc57087b178fc568ba5b368704091d483a628b9e997b38c147a40ed08e5fa6c
BLAKE2b-256 checksum
How to use checksums
d6fb07cb29af694149ac06711d029fef64d7e4e2fe49bb394d5cad1609c78b78
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

Release files / adfontes-0.1.0-cp310-abi3-manylinux_2_28_aarch64.whl

Download URL adfontes-0.1.0-cp310-abi3-manylinux_2_28_aarch64.whl
Size 3.0 MB
Tags CPython 3.10 Linux glibc 2.28+ ARM64 abi3
SHA-256 checksum
How to use checksums
a4835ee4ea4fdfe5f833c33fea2ecd3937407d71fa898bc3f1e9cd7b0f454034
BLAKE2b-256 checksum
How to use checksums
49e6e85671928dbd169a9db8c5797b802200b8abe55c3013f5535e0d9331af77
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

Release files / adfontes-0.1.0-cp310-abi3-macosx_11_0_arm64.whl

Download URL adfontes-0.1.0-cp310-abi3-macosx_11_0_arm64.whl
Size 2.9 MB
Tags CPython 3.10 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
0e4df3ef3289e10b4cebdb64edb3d669e065da528ecbb22e778ae12cf13fdbd9
BLAKE2b-256 checksum
How to use checksums
7967a82919c808da0cf493ef84c864629a1500d5895cdc7201f79aabb185d9c3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

Release files / adfontes-0.1.0-cp310-abi3-macosx_10_12_x86_64.whl

Download URL adfontes-0.1.0-cp310-abi3-macosx_10_12_x86_64.whl
Size 3.1 MB
Tags CPython 3.10 abi3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
35efa8dc27614e65247136be8678868639bcaac5e9b4cff43904bdbba7903642
BLAKE2b-256 checksum
How to use checksums
ab596d888ec9b04452bc4f3bc4b6f55f045930cc9ca0f3668ab7ae22064c6ef1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

Security for adfontes 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 6 files in this release have been uploaded with provenance metadata.

Select from 6 files

Attestation for adfontes-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

6 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page