Skip to main content

PaperGraph MCP

CI Python MIT Release

Read math papers with evidence, not guesses.

Turn arXiv papers, local LaTeX projects, and born-digital PDFs into a local theorem-centered workspace. Inspect source-backed results, proofs, citations, and dependencies; save reading progress and export Markdown reports.

What You Can Do

  • Start with a Paper Map: inspect structure, main-result candidates, and external reading risks before choosing a theorem.
  • Trace statements and proof-local references back to source slices; inspect direct and recursive dependencies, shared prerequisites, cycles, and unknowns.
  • Discover public full-text candidates for DOI papers and review scholarly reference matches from Crossref, OpenAlex, and arXiv.
  • Keep queues, sessions, checkpoints, notes, and open questions in local SQLite workspaces. Export Reading Reports and Cross-Paper Reading Plans.

Quick Start

This checkout prepares 1.2.3. Run the following planned commands only after its release gates record official-index acceptance. Install uv; no Git or checkout is required:

uvx --from papergraph-mcp==1.2.3 papergraph-mcp --version
uvx --from papergraph-mcp==1.2.3 papergraph-mcp doctor

PyPI 1.2.2 is published and has passed public-package and Git-free Linux acceptance. Until 1.2.3 acceptance, use that verified version through the setup skill. Diagnostics do not independently verify publication.

After that acceptance, an MCP client can use this JSON-style stdio configuration:

{
  "mcpServers": {
    "papergraph": {
      "command": "uvx",
      "args": ["--from", "papergraph-mcp==1.2.3", "papergraph-mcp"]
    }
  }
}

Restart the client after configuration. A bare server launch waits quietly for a stdio MCP connection; CLI commands also work without an MCP client.

For agent-assisted setup, use the repository's setup skill from the freshly fetched remote default revision. Preserve existing branches and local changes; ask before installing software, changing client configuration, or restarting. The optional Git-source route requires Git and live verification of the selected version tag against its reviewed package source; the setup skill currently selects verified 1.2.2.

Read Your First Paper

PaperGraph request and reading flow: import usable full text, inspect source evidence and dependencies, review external imports, and save reading state.

Editable DrawCMS source.

  1. Keep the workspace database outside the repository. Preview inputs with plan-starter-project; it validates files without importing or writing. Run bootstrap-reading-project after review to create the workspace and reading artifacts. Local LaTeX inputs must name the main .tex file.
  2. Open the Paper Map and Evidence Triage, choose a result, then inspect its statement, proof, source slices, and dependency evidence.
  3. Review external import plans, save checkpoints and notes, and export a report or cross-paper plan. Follow the first-workspace walkthrough for commands and examples.

For raw arXiv requests, use load_arxiv_request; conflicting IDs or links require user selection before loading. For DOI discovery, discover-doi DOI finds candidates without downloading. add-doi-paper WORKSPACE DOI can import a requested root paper when exactly one eligible public PDF exists; multiple candidates require selection.

For an existing workspace, replace the placeholders with actual IDs:

uvx --from papergraph-mcp==1.2.3 papergraph-mcp get-paper-map --workspace WORKSPACE --paper-id PAPER_ID
uvx --from papergraph-mcp==1.2.3 papergraph-mcp get-dependency-reading WORKSPACE PAPER_ID --target-result-id RESULT_ID --detail compact

Arguments are command-specific: check each command's --help. Compact dependency output retains access to full evidence.

Evidence Boundaries

  • PaperGraph does not verify proofs, infer hidden prerequisites, or establish semantic theorem equivalence. Empty dependencies do not prove independence; extracted reading orders are not complete mathematical dependency graphs.
  • Long PDFs support raw source pagination through workspace_read_source_blocks and its next handle. New automatic PDF proof evidence covers only the first physical line with an explicit proof heading; ownership can remain unknown, and later proof references remain unknown. Raw continuation is readable but does not become dependency evidence automatically. Existing excerpts retain their extraction policy until explicit reimport.
  • External references become reviewable plans, not automatic downloads. Bounded reference expansion requires an explicitly approved finite policy; ambiguous matches await review. Metadata is not full text, and no workflow bypasses paywalls.
  • Papers and reading state remain local. Back up workspaces before schema upgrades; older versions cannot open schema 9.

Documentation

Metadata

Release files for papergraph-mcp 1.2.3

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

Source distribution (sdist)

Source distribution for papergraph-mcp 1.2.3
File Size Uploaded Provenance Actions
papergraph_mcp-1.2.3.tar.gz 1.2 MB With provenance Details for papergraph_mcp-1.2.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for papergraph-mcp 1.2.3
File Interpreter ABI Platform Actions
papergraph_mcp-1.2.3-py3-none-any.whl Python 3 none any Details for papergraph_mcp-1.2.3-py3-none-any.whl

Total release size: 1.4 MB

Release files / papergraph_mcp-1.2.3.tar.gz

Download URL papergraph_mcp-1.2.3.tar.gz
Size 1.2 MB
Tags Source
SHA-256 checksum
How to use checksums
140c0aca282f87b431fcea984ed357024a7f368399195a214eb56f745cf2f153
BLAKE2b-256 checksum
How to use checksums
594c2a71eddf1cf5dad1ab389b9e82cc84742e244654b95ea2482c90b630721c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Oct 18, 2026.

Transparency log

Release files / papergraph_mcp-1.2.3-py3-none-any.whl

Download URL papergraph_mcp-1.2.3-py3-none-any.whl
Size 173.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
25ad4ec7632bbd0f166e1d9a0508885ce2fe0125b620801f1b41c4d53bd93474
BLAKE2b-256 checksum
How to use checksums
9478ccc67d340e92863e044c79c5d3f14d0d7784c9befd0362ee644c18b19134
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Oct 18, 2026.

Transparency log

Security for papergraph-mcp 1.2.3

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

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for papergraph_mcp-1.2.3.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 Oct 18, 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.

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