@cyanheads/biorxiv-mcp-server 0.5.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (47) hide show
  1. package/AGENTS.md +3 -3
  2. package/CLAUDE.md +3 -3
  3. package/README.md +12 -5
  4. package/changelog/0.5.x/0.5.1.md +22 -0
  5. package/changelog/0.6.x/0.6.0.md +39 -0
  6. package/changelog/template.md +10 -3
  7. package/dist/mcp-server/tools/definitions/biorxiv-get-fulltext.tool.d.ts.map +1 -1
  8. package/dist/mcp-server/tools/definitions/biorxiv-get-fulltext.tool.js +2 -2
  9. package/dist/mcp-server/tools/definitions/biorxiv-get-fulltext.tool.js.map +1 -1
  10. package/dist/mcp-server/tools/definitions/biorxiv-get-preprint.tool.d.ts +1 -1
  11. package/dist/mcp-server/tools/definitions/biorxiv-get-preprint.tool.d.ts.map +1 -1
  12. package/dist/mcp-server/tools/definitions/biorxiv-get-preprint.tool.js +13 -6
  13. package/dist/mcp-server/tools/definitions/biorxiv-get-preprint.tool.js.map +1 -1
  14. package/dist/mcp-server/tools/definitions/biorxiv-list-recent.tool.d.ts +2 -0
  15. package/dist/mcp-server/tools/definitions/biorxiv-list-recent.tool.d.ts.map +1 -1
  16. package/dist/mcp-server/tools/definitions/biorxiv-list-recent.tool.js +18 -2
  17. package/dist/mcp-server/tools/definitions/biorxiv-list-recent.tool.js.map +1 -1
  18. package/dist/mcp-server/tools/definitions/biorxiv-search-preprints.tool.d.ts.map +1 -1
  19. package/dist/mcp-server/tools/definitions/biorxiv-search-preprints.tool.js +39 -29
  20. package/dist/mcp-server/tools/definitions/biorxiv-search-preprints.tool.js.map +1 -1
  21. package/dist/mcp-server/tools/definitions/index.d.ts +3 -1
  22. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
  23. package/dist/services/biorxiv/biorxiv-service.d.ts +3 -1
  24. package/dist/services/biorxiv/biorxiv-service.d.ts.map +1 -1
  25. package/dist/services/biorxiv/biorxiv-service.js +15 -15
  26. package/dist/services/biorxiv/biorxiv-service.js.map +1 -1
  27. package/dist/services/biorxiv/types.d.ts +8 -0
  28. package/dist/services/biorxiv/types.d.ts.map +1 -1
  29. package/dist/services/europe-pmc/europe-pmc-service.d.ts +7 -3
  30. package/dist/services/europe-pmc/europe-pmc-service.d.ts.map +1 -1
  31. package/dist/services/europe-pmc/europe-pmc-service.js +46 -14
  32. package/dist/services/europe-pmc/europe-pmc-service.js.map +1 -1
  33. package/dist/services/europe-pmc/query-syntax-hint.d.ts +7 -0
  34. package/dist/services/europe-pmc/query-syntax-hint.d.ts.map +1 -0
  35. package/dist/services/europe-pmc/query-syntax-hint.js +105 -0
  36. package/dist/services/europe-pmc/query-syntax-hint.js.map +1 -0
  37. package/dist/services/europe-pmc/types.d.ts +11 -7
  38. package/dist/services/europe-pmc/types.d.ts.map +1 -1
  39. package/dist/services/europe-pmc/types.js +5 -1
  40. package/dist/services/europe-pmc/types.js.map +1 -1
  41. package/dist/services/shared.d.ts +9 -4
  42. package/dist/services/shared.d.ts.map +1 -1
  43. package/dist/services/shared.js +50 -13
  44. package/dist/services/shared.js.map +1 -1
  45. package/package.json +10 -10
  46. package/server.json +3 -3
  47. package/skills/biorxiv-guide/SKILL.md +11 -10
package/server.json CHANGED
@@ -6,7 +6,7 @@
6
6
  "url": "https://github.com/cyanheads/biorxiv-mcp-server",
7
7
  "source": "github"
8
8
  },
9
- "version": "0.5.0",
9
+ "version": "0.6.0",
10
10
  "remotes": [
11
11
  {
12
12
  "type": "streamable-http",
@@ -19,7 +19,7 @@
19
19
  "registryBaseUrl": "https://registry.npmjs.org",
20
20
  "identifier": "@cyanheads/biorxiv-mcp-server",
21
21
  "runtimeHint": "npx",
22
- "version": "0.5.0",
22
+ "version": "0.6.0",
23
23
  "environmentVariables": [
24
24
  {
25
25
  "name": "BIORXIV_MAILTO",
@@ -58,7 +58,7 @@
58
58
  "registryBaseUrl": "https://registry.npmjs.org",
59
59
  "identifier": "@cyanheads/biorxiv-mcp-server",
60
60
  "runtimeHint": "npx",
61
- "version": "0.5.0",
61
+ "version": "0.6.0",
62
62
  "environmentVariables": [
63
63
  {
64
64
  "name": "MCP_TRANSPORT_TYPE",
@@ -4,7 +4,7 @@ description: Search syntax, identifier origins, and counting gates for the biorx
4
4
  license: Apache-2.0
5
5
  metadata:
6
6
  author: cyanheads
7
- version: "1.0"
7
+ version: "1.2"
8
8
  ---
9
9
 
10
10
  ## Scope
@@ -18,7 +18,7 @@ No citation counts and no journal-article content beyond the crosswalk record. P
18
18
  - **DOI prefix is an era, not a server.** `10.1101/` is the older prefix and `10.64898/` the newer; bioRxiv and medRxiv both issue both, and a preprint keeps its DOI through every revision (`10.1101/2025.11.24.690249` was revised as v2 under `10.1101/` long after new submissions moved to `10.64898/`). Leave `server` at `"both"` for DOI lookups; the response names the server that holds it.
19
19
  - **The date inside a DOI is the submission date, not the posting date.** `10.1101/2024.01.03.573434` was posted 2024-01-04; `10.1101/2025.05.22.653117` on 2025-05-27. Read `date` (or `preprintDate` on crosswalk rows) for when a preprint appeared. Older bioRxiv DOIs are plain serials with no date (`10.1101/049882`).
20
20
  - **Versions.** Each revision has its own title, authors, and date; `biorxiv_get_preprint` lists them. Only the latest revision carries an abstract — the API keeps one per preprint. An earlier revision's own abstract and text come from `biorxiv_get_fulltext` with `version`: `10.1101/049882` v1 opens with a different abstract than the one `biorxiv_get_preprint` returns.
21
- - **Category strings** come from `biorxiv_list_categories`, or from any record's `category` field, which is accepted as input as written.
21
+ - **Category strings** come from `biorxiv_list_categories` or from a record's `category` or `preprintCategory` field. Record values are trimmed and lowercased. Blank values are omitted.
22
22
  - **Funder** is a ROR ID (`https://ror.org/<id>`), looked up by name at ror.org. A Crossref Funder Registry ID (`100000002`) is not one and is rejected before any request.
23
23
  - **Publisher** is the DOI prefix of a journal publisher, the part before the slash, taken from any article DOI of the journal you care about. It names the whole publisher, not one journal: `10.1038` returns rows from many Springer Nature journals at once (`s41467-`, `s41598-`, `s41593-`, and more DOI stems on one two-day page).
24
24
 
@@ -26,18 +26,19 @@ No citation counts and no journal-article content beyond the crosswalk record. P
26
26
 
27
27
  ### Keyword search (`biorxiv_search_preprints`)
28
28
 
29
- `query` is EuropePMC query syntax, passed through and joined to the server's own clauses with `AND`.
29
+ `query` is EuropePMC query syntax, passed through as written inside one pair of parentheses, then joined to the server's author, date, and server clauses with `AND`.
30
30
 
31
- - **Wrap every `OR` in parentheses.** The server appends `AND <date and server clauses>`, and in EuropePMC's parser an unparenthesized `OR` before an `AND` stops constraining the match: `transformer OR CRISPR` returns exactly the hits for `CRISPR` alone, while `(transformer OR CRISPR)` returns both sets. The same applies to any `OR` inside a larger query.
32
- - **Spell out synonyms yourself.** Synonym expansion is off, so `"heart attack"` misses the far larger set written `"myocardial infarction"`. Search `("heart attack" OR "myocardial infarction")`.
31
+ - **Spell out synonyms yourself.** Synonym expansion is off, so `"heart attack"` misses the far larger set written `"myocardial infarction"`. Search `"heart attack" OR "myocardial infarction"`.
33
32
  - **Scope by field when precision matters.** A bare term or phrase matches more than the title and abstract. `TITLE_ABS:"…"`, `TITLE:"…"`, `ABSTRACT:"…"`, `AUTH:"…"`, and `AFF:"…"` all work inside `query`; `TITLE_ABS:"base editing"` and `TITLE:"base editing"` each match fewer records than the bare phrase.
34
- - **Author names.** `author` becomes `AUTH:"…"`. A full name and `Surname Initial` match the same records (`Jennifer Doudna`, `Doudna J`); adding a middle initial (`Doudna JA`) drops records indexed without it. The surname alone is broadest. Confirm identity from co-authors and institution before attributing a list to one person.
33
+ - **Author names.** `author` becomes `AUTH:"…"`. Citation forms such as `Bucher, G.`, `Doudna, J.A.`, and `Doudna, Jennifer` become `Bucher G`, `Doudna JA`, and `Doudna Jennifer`. Use `queryEcho.author` to see the spelling that selected the results. In a reported EuropePMC snapshot, `Doudna JA` matched fewer records than `Doudna J`. Start with surname and first initial and confirm identity from co-authors and institution.
34
+ - **Search defaults and continuation.** Search requests 10 rows with abstracts when available. Follow `nextCursorMark` with the same filters, even when a page has few usable records. A short upstream page ends the walk.
35
+ - **Query syntax hints.** When EuropePMC confirms zero matches, look for a notice naming a clear defect and how to repair it before broadening the search.
35
36
  - **`server` scopes the search itself**, not only enrichment: `"medrxiv"` returns medRxiv preprints only.
36
37
  - **The date window is first posting; the record shows the latest revision.** `date_from` / `date_to` filter on when v1 appeared, while each result's `date` and `version` are the latest revision's: a January 2024 window returned `10.1101/2024.01.29.577624` dated 2024-12-15, v2. Never re-filter search results on `date` to enforce the window.
37
38
 
38
39
  ### Posting-date listing (`biorxiv_list_recent`)
39
40
 
40
- - **Rows are revisions, and `total` counts them.** A revised preprint reappears on the day its new version posts, under its old DOI and `version` 2, 3, …. bioRxiv's 2026-10-01..07 listing held 1,460 rows, of which 1,092 were new preprints. To count or list new preprints, keep `version` `"1"` rows.
41
+ - **Rows are revisions, and `total` counts them.** A revised preprint reappears on the day its new version posts, under its old DOI and `version` 2, 3, …. bioRxiv's 2026-10-01..07 listing held 1,460 rows, of which 1,092 were new preprints. To count new preprints, read each server's `newPreprints` from the first page, which carries the whole listing's count for those filters; to list them, keep `version` `"1"` rows.
41
42
  - **It has no keyword filter.** At 30 rows a page, one bioRxiv week runs to dozens of pages. For a topic within a window, search with `date_from` / `date_to` and filter enriched results on `category` locally; reserve the listing for a complete category census or for the last day or two that EuropePMC has not indexed yet.
42
43
  - **A funder filter is not a funder's output.** It reaches only records api.biorxiv.org linked to that ROR ID: NIH (`01cwqze88`) returned 9 rows for that same week, all of them revisions. Report what it returns as "preprints bioRxiv links to this funder", never as everything the funder supported.
43
44
 
@@ -50,13 +51,13 @@ No citation counts and no journal-article content beyond the crosswalk record. P
50
51
 
51
52
  ## Workflows
52
53
 
53
- **New preprints on a topic in a period.** `biorxiv_search_preprints` with a parenthesized, field-scoped query and `date_from` / `date_to`, `include_abstract: false` and `limit: 100` for triage, passing each `nextCursorMark` back as `cursor_mark`. Narrow to a field by the `category` on enriched results (EuropePMC-fallback results carry none). Read abstracts for the shortlist with `biorxiv_get_preprint` (10 DOIs a call). For the last day or two, add a `biorxiv_list_recent` pass with `category`.
54
+ **New preprints on a topic in a period.** `biorxiv_search_preprints` with a field-scoped query and `date_from` / `date_to`, `include_abstract: false` and `limit: 100` for triage, passing each `nextCursorMark` back as `cursor_mark`. Narrow to a field by the `category` on enriched results (EuropePMC-fallback results carry none). Read abstracts for the shortlist with `biorxiv_get_preprint` (10 DOIs a call). For the last day or two, add a `biorxiv_list_recent` pass with `category`.
54
55
 
55
- **Everything a category posted in a window.** `biorxiv_list_recent` with `category`, each server advanced at its own `nextCursor` until none is returned; keep `version` `"1"` rows for new preprints.
56
+ **Everything a category posted in a window.** `biorxiv_list_recent` with `category`, each server advanced at its own `nextCursor` until none is returned; keep `version` `"1"` rows for new preprints, whose number each server's `newPreprints` gives on the first page.
56
57
 
57
58
  **Find a person's preprints.** `author` (surname plus initial, then surname alone if the list looks short) with `server` when the field is clear; add a topic `query` to separate namesakes.
58
59
 
59
- **Has this preprint been published, and where?** `biorxiv_get_preprint` shows `publishedJournalDoi`; `biorxiv_get_published_version` adds the journal name and date. Holding the journal article instead, pass its DOI to `biorxiv_get_published_version` to find the preprint. A not-found answer is bioRxiv's record only, per the crosswalk gate.
60
+ **Has this preprint been published, and where?** `biorxiv_get_preprint` shows `publishedJournalDoi`; `biorxiv_get_published_version` adds the journal name and date. If you have a journal article DOI, pass it to `biorxiv_get_published_version` to find the preprint. If a preprint DOI misses on one server, retry with `server: "both"`. A not-found answer reflects the crosswalk's coverage.
60
61
 
61
62
  **What a journal or publisher took up in a period.** `biorxiv_list_published_versions` filters on the journal's publication date, so the preprints can be years older.
62
63