litcheck-mcp
litcheck-mcp gives scientists and AI agents a quote-and-retraction checker backed by an append-only, hash-chained audit log.
check_quote — resolve a DOI/PMID/PMCID, fetch the paper's pinned open-access PMC text, and look for a quoted passage (exact substring after normalisation q1), returning
FOUND,NOT_FOUND,TOO_SHORT,NOT_CHECKABLEorUNVERIFIABLE, with match offsets, paragraph index, text version/sha256/licence, and retraction status.resolve_identifier — map one DOI, PMID or PMCID to the other two via the PMC ID converter (Europe PMC fallback for DOIs).
retraction_status — read PMC's
is_retractedflag and Crossref's notices (retraction, withdrawal, removal; expressions of concern reported separately), returningRETRACTED,NOT_RETRACTED_AS_OF <date>orUNVERIFIABLEwith per-source URLs and response hashes.search_literature — run one recorded search on Europe PMC, LitSense 2.0 or PubMed, returning items plus hit count and a response hash.
citing_papers — list works citing a paper via OpenAlex, recorded.
verify_log — re-walk the log's hash chain and report the first bad line and head sha256.
record_support — store a person's or a named judge's
supports/contradicts/absentverdict on an evidence line (litcheck computes no support verdict itself).Audit trail — quote checks, searches and annotations are appended to a JSONL hash-chained log (nothing rewritten), with per-line seq, timestamp and sha256;
LITCHECK_LOG/--logrelocate it.Politeness/limits —
LITCHECK_CONTACTsets the User-Agent and contact email; per-host rate limits are honoured and retried on 429/5xx.CLI — the same core runs without install as
./litcheck check|search|verify-log|annotate, with exit codes encoding verdict and retraction state.
Fetches pinned open-access full texts from PMC's Amazon S3 bucket for quote checking, verifying the retrieved bytes against PMC metadata.
Provides recorded literature searches against PubMed via NCBI E-utilities, returning matching IDs and optional titles, and logs each query, parameters, and response hash.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@litcheck-mcp Check if this quote is in PMC1234567: 'CRISPR enables gene editing'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
litcheck-mcp
A quote and retraction checker for scientists and their AI agents. litcheck checks quoted passages against pinned open-access PubMed Central texts and checks retraction status; every quote check and every search it runs goes into an append-only, hash-chained log.
It never tells you a hypothesis is novel. It gives you a dated record of what was searched and what was found, and, where open-access text exists, checks whether each quoted passage appears in it.
Install
Clone it, then add it to your MCP client (uv must be on your PATH):
git clone https://github.com/javrodriguez/litcheck-mcpClaude Code:
claude mcp add litcheck -- uv --directory /ABS/PATH/TO/litcheck-mcp run litcheck-mcpCodex:
codex mcp add litcheck -- uv --directory /ABS/PATH/TO/litcheck-mcp run litcheck-mcpReplace /ABS/PATH/TO/litcheck-mcp with the clone's absolute path. The first launch installs
the server's dependencies (mcp, pydantic, and the small development group: pytest,
pytest-asyncio, ruff, mypy) into the clone's own .venv. The server needs Python 3.12 or 3.13; uv fetches one
if none is installed.
Related MCP server: CiteAnything MCP Server
Worked example
docs/EXAMPLE.md takes one CC BY paper through the whole loop: a true quote
comes back FOUND with its offsets, the same quote with one word changed comes back
NOT_FOUND, the paper's retraction status is reported with its sources, and the log's chain
is verified. Every output on that page is re-derived from recorded responses by
scripts/check_readme.py, so it shows what the code does.
Does searching help? A small pre-registered test
Before any run, we wrote down ten research hypotheses, each based on one paper's research question, and the rules for scoring. An agent counted as finding the paper only if it listed that paper among its first ten citations. We then asked one model (Claude Sonnet 5.5) to find the prior work behind each hypothesis in two ways: with litcheck's search tools (two separate runs) and from memory alone (one run).
Search, run 1 | Search, run 2 | Memory only | |
Found the paper, on the 6 hypotheses scored in all three runs | 6 of 6 | 6 of 6 | 0 of 6 |
Found the paper, all 10 (a voided run counts as not found) | 7 of 10 | 9 of 10 | 0 of 10 |
Memory alone still reported its search as done or partly done in 8 of its 9 scored answers.
What this does not show: that litcheck beats any other search route, anything about another model, or a precise rate (ten hypotheses is a small sample). It also cannot tell whether memory missed because the model never learned the paper or because the paper is newer than its training data. The hypotheses stay sealed so that they can be reused for blind runs, so the per-hypothesis records are not public yet.
What it checks, and what it does not
Quotes, against the paper's open-access text from the PMC Cloud Service: the latest version, recorded by version number and sha256 (a later check may meet a newer version), and accepted only if its bytes match the md5 in PMC's metadata. Matching is an exact substring search after a pinned normalisation (
q1: Unicode NFKC, straight quotes, one dash, collapsed whitespace; case kept); it does not respect word boundaries, so a quote that starts or ends mid-word can still beFOUND. The text searched is PMC's whole plain-text file: a metadata header (journal, identifiers, affiliations), the article, and its reference list, so a cited work's title isFOUNDtoo. Paragraph breaks become single spaces, so a match can also run across two blocks;paragraphnames the block it starts in. Check it, or read the passage, before saying the paper itself states it. Verdicts:FOUND,NOT_FOUND,TOO_SHORT(under 20 characters),NOT_CHECKABLE(no open-access text to check: none in PMC, PMC's copy missing, or the identifier not found at all; theresolvedstatus and thereasonsay which; a short quote with no text to check isNOT_CHECKABLE, notTOO_SHORT),UNVERIFIABLE(a source could not be read or verified, or litcheck itself failed; thereasonsays which).Only open-access full text can be quote-checked. Paywalled papers, and author manuscripts PMC does not mark as open access, come back
NOT_CHECKABLE.Retraction status, from PMC's
is_retractedflag and Crossref's notices about the DOI (the notice recordsfilter=updates:<doi>returns: retraction, withdrawal and removal count; corrections do not; an expression of concern is reported separately; a retraction recorded only in the paper's ownupdated-byfield is not read).NOT_RETRACTED_AS_OF <date>means no retraction notice was found in the sources consulted, as of that date (a UTC date: the day of the earliest check); it needs the identifier to have resolved and every consulted source to have answered, otherwise the status isUNVERIFIABLE. PMC's flag is read for papers PMC lists (if their metadata cannot be read, PMC's copy is missing, or the PMC Cloud Service holds no copy of a paper PMC lists, that counts as a source that did not answer); a paper PMC does not hold is checked on Crossref alone, and a paper with no known DOI on PMC's flag alone;sourcesshows which answered. A PMID or PMCID outside PMC has no DOI to ask Crossref about: pass the DOI instead. Retraction checks are returned, not logged, except inside acheck_quoteevidence line.No support verdict is computed. Whether a passage supports, contradicts or is absent from a claim is recorded only when a person or a named judge gives it (
record_support).Searches are recorded, and a search can miss papers. Europe PMC, LitSense 2.0, PubMed and OpenAlex citations are queried as asked; each query, its parameters, the sha256 of the search response (for PubMed the esearch response, not the esummary that adds titles) and one id per returned item go into the log. Searches that were sent and failed are recorded too; a request rejected before sending (an empty query, say) is not. An empty result is a record of one query, not evidence that nothing exists.
Tools
Tool | What it does |
| resolve the paper, fetch its pinned open-access text, look for the quote; licence and retraction status alongside |
| DOI, PMID or PMCID to the other two (PMC ID converter, Europe PMC fallback for DOIs only: a PMID or PMCID outside PMC comes back |
| PMC's flag and Crossref's notices, with the date and response hash of each check (returned, not logged) |
| one recorded search on |
| works citing a paper, from OpenAlex, recorded |
| re-walk the log's hash chain |
| store a person's or a named judge's verdict ( |
Command line
The core is standard-library Python that runs on Python 3.6 or newer, with no install
(./litcheck is a POSIX shell wrapper; on Windows run python -m litcheck with core on
PYTHONPATH, and note that appends to the log are not locked there, so two writers, including
concurrent calls to the MCP server on Windows, can break the chain):
./litcheck check --id PMC10496602 --quote "Arteriosclerosis consists of functional depletion of large-artery elasticity."
./litcheck search litsense "large-artery elasticity" --limit 5
./litcheck verify-log
./litcheck annotate --seq 1 --support supports --by "your name"check exits 0 only for FOUND in a paper whose retraction status is not RETRACTED, 3 for
FOUND in a paper whose retraction status is RETRACTED (the passage is in the text, but the
paper cannot back a claim), 1 for every other verdict, and 2 for an unusable request (an
unusable identifier or quote) or a damaged log.
A retraction status of UNVERIFIABLE is not RETRACTED, so a FOUND with it still exits 0:
read the retraction line before relying on the paper.
verify-log exits 0 only for an intact chain.
The log
One JSON object per line: seq, a UTC timestamp, the kind (evidence, search, annotate),
the sha256 of the previous line, its payload, and its own sha256. Nothing in litcheck rewrites
a line. verify-log (or verify_log) reports the first line that does not fit, which catches
accidental and naive edits. The hashes are not keyed: someone who rewrites a line and
recomputes every hash after it, or cuts off the tail, leaves a chain that checks out. To
detect that, keep the head hash verify-log prints somewhere else; later, the sha256 of
line N's bytes (without its newline) must still equal the head you saved when the log had N
lines. litcheck has no command for that comparison yet. The chain shows order and
integrity, not authorship: anyone who can write the file can append well-formed lines, and
each line's timestamp is the writing machine's clock.
A log that does not exist yet is reported as not intact (exit 1, chain_ok: false), and a
damaged last line stops new checks and searches from being written until it is dealt with.
System | Default location |
Windows |
|
macOS |
|
Linux |
|
Set LITCHECK_LOG to put it elsewhere (for one project, say); --log does the same per call
(verify-log takes the path as its argument). Only check_quote, the searches and
record_support write to the log; resolve_identifier and retraction_status do not.
Etiquette
Set LITCHECK_CONTACT to an address the services can reach you at. litcheck sends it only
with each request: in the User-Agent, to every host it calls (the PMC bucket on Amazon S3
included), and as the email/mailto parameter NCBI, Europe PMC, Crossref and OpenAlex ask
for. It is not part of any URL litcheck stores, and it is never written to a recorded
fixture; a value that is not printable ASCII is ignored. With Claude Code, add
-e LITCHECK_CONTACT=you@example.org before --; with Codex,
--env LITCHECK_CONTACT=you@example.org.
Rate limits are honoured per host within one process, concurrent tool calls included
(separate CLI runs or servers do not share the spacing): NCBI E-utilities and the ID
converter 3 requests a second (no API key), LitSense one a second, Europe PMC 5 a second,
OpenAlex and Crossref 10 a second. Answers 429, 500, 502, 503 and 504, and network errors,
are retried at most twice, with backoff (honouring a Retry-After in seconds, up to 10);
other answers are not retried. A call that still fails makes the result UNVERIFIABLE, with
one exception: when PubMed's esearch answers but the esummary that adds titles fails, the
search is SEARCHED with ids only and a reason saying the titles are missing.
Tests
uv sync --dev
uv run pytest -q # the MCP server
python3 -m unittest discover -s core/tests -t core # the core, offline
uv run python scripts/check_readme.py # README and worked exampleThe core's tests replay responses recorded live by core/tools/record_fixture.py; a replay
refuses any URL it was not given and any body whose sha256 differs from its record.
LITCHECK_NETWORK_TESTS=1 runs the live smoke test against the real services.
Credits
litcheck reads public services and is grateful to the people who run them: Europe PMC (EMBL-EBI); NCBI, for E-utilities, LitSense 2.0, the PMC Cloud Service and the PMC ID Converter; Crossref, including the Retraction Watch data it distributes; and OpenAlex.
The pinned-PMC gate and quote matcher are ported from peerpanel.
Built by Javier Rodríguez Hernáez · LinkedIn · GitHub
Made alongside GARS, the genomics agentic research system.
Licence
MIT, for the source code. The recorded responses under core/tests/fixtures/ belong to the
services that served them; the one article text among them is CC BY and attributed in
docs/EXAMPLE.md.
Available Tools
7 toolscheck_quoteA
Check whether a quoted passage appears in the paper's pinned open-access PMC text.
Also reports the text's version, sha256 and licence, and the paper's retraction status,
and appends an evidence line to the log. The text searched is PMC's whole plain-text file,
header and reference list included, so check paragraph before attributing a FOUND
passage to the paper. Exact substring match (word boundaries are not
checked) after normalisation q1 (Unicode
NFKC, straight quotes, one dash, collapsed whitespace; case kept). It does not judge
whether the passage supports the claim.
Inputs: quote (required), identifier (required), claim. Returns: claim, quote, reason, log_seq, +14 more
citing_papersB
List works that cite a paper, from OpenAlex, and record the search in the log.
Inputs: identifier (required), limit. Returns: items, query, engine, reason, +5 more
record_supportB
Record a person's or a named judge's support verdict about an evidence line.
litcheck computes no support verdict itself; this stores one that was given, with who gave it, as a new line in the log.
Inputs: by (required), seq (required), support (required). Returns: by, seq, support, log_path, +1 more
resolve_identifierA
Map one DOI, PMID or PMCID to the other two, through the PMC ID converter.
The converter knows only articles in PubMed Central; a DOI it cannot map is also looked up in Europe PMC. NOT_FOUND means not in PMC (and, for a DOI, not in Europe PMC either): a PMID or PMCID is not looked up elsewhere, so NOT_FOUND does not mean the paper does not exist. UNVERIFIABLE means a service could not be read.
Inputs: identifier (required). Returns: doi, pmid, pmcid, reason, +3 more
retraction_statusA
Is the paper retracted? Reads PMC's is_retracted flag and Crossref's notices.
Retraction, withdrawal and removal notices count; corrections do not; an expression of
concern is reported separately. NOT_RETRACTED_AS_OF means no retraction notice was found
in the sources consulted, as of its date; it needs the identifier to have resolved and
every consulted source to have answered, otherwise the status is UNVERIFIABLE. A paper PMC
does not hold is checked on Crossref alone, and one with no known DOI on PMC's flag alone;
sources shows which answered. For a paper outside PMC, pass its DOI. Not logged.
Inputs: identifier (required). Returns: as_of, reason, status, concern, +2 more
search_literatureA
Run one literature search and record it, with its response hash, in the log.
hit_count is what the engine reported (for litsense, the number of results it returned,
at most 100); items are the first limit of them. A search can
miss papers: status SEARCHED with few items is a record of this query, not of the field.
Inputs: query (required), engine (required), limit. Returns: items, query, engine, reason, +5 more
verify_logA
Re-walk the log's hash chain and report the first line that does not fit, if any.
This catches accidental and naive edits. The hashes are not keyed, so a rewrite that recomputes every later hash, or a cut-off tail, is caught only by comparing head_sha256 with a copy kept elsewhere. A log that does not exist yet reports chain_ok false.
Inputs: no named parameters. Returns: path, lines, reason, chain_ok, +2 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool targets a clearly distinct task: quote checking, identifier mapping, log integrity, retraction status, literature search, citation listing, and support recording. Although retraction_status and check_quote both read PMC, their purposes (retraction notices vs. textual quote matching) are unambiguous from the descriptions.
Most tools follow a verb_noun pattern (check_quote, resolve_identifier, verify_log, search_literature, record_support). Two deviate into noun phrases (retraction_status, citing_papers), which is a minor inconsistency but still readable and predictable.
Seven tools is well-scoped for a literature-verification server, and each tool earns its place with a distinct role. No redundancy or filler tools.
The surface covers the core verification lifecycle: quote checking, ID resolution, retraction checking, searching, citations, and support recording plus log auditing. Minor gaps exist (e.g., no tool to fetch full paper metadata or export/report the log), but agents can work around them.
Maintenance
Related MCP Connectors
Citation and retraction checker for AI agents. Give it DOIs, PubMed or arXiv ids and it says whether each paper exists and whether it was retracted, withdrawn or corrected, using Crossref and Retraction Watch. It also searches publisher articles and open research papers, shows the x402 price in USDC an agent pays to read or cite each one, and traces a passage to the page it was copied from. Free, read-only, no account.
Hosted research subset: check citations, catch fake/retracted papers, search OpenAlex & PubMed.
Check if references exist or were retracted, look up journal AI policies, and preview manuscripts.
Search and cite research claims with their evidence and reliability scores; publish claimsets.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables revision-bound source audits with exact article fingerprinting, claim-to-source mapping, quotation verification, and immutable JSON evidence reports for prepublication review.9MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to create verifiable, replayable citations, search private knowledge bases, and publish Markdown with verified citation markers.MIT
- AlicenseCqualityBmaintenanceEnables users to search scientific literature metadata across OpenAlex, Europe PMC, and Crossref, verify citations, retractions, source quotes, and claims, and build or export hash-chained evidence ledgers with explicit provenance and limitations.355Apache 2.0
- FlicenseNot gradedqualityAmaintenanceEnables researchers and AI assistants to verify bibliographic existence and metadata consistency, resolve DOI, PMID, PMCID, and arXiv identifiers, and perform explainable multi-source matching without destructive edits.-