Repository Public Research preview
1{2 "schemaVersion": "1.0",3 "name": "@spboucher/scholarly-mcp",4 "version": "1.0.1",5 "type": "mcp-server",6 "description": "MCP server for scholarly search and citation verification over Crossref, OpenAlex, arXiv and doi.org: checks that a DOI resolves and its metadata matches, audits .bib files, flags retractions, walks the citation graph.",7 "license": "MIT",8 "keywords": [9 "citations",10 "doi",11 "crossref",12 "openalex",13 "arxiv",14 "bibtex",15 "retractions",16 "literature-search",17 "bibliography",18 "research",19 "mcp"20 ],21 "compatibility": [22 "claude-code",23 "codex",24 "cursor",25 "generic-mcp"26 ],27 "permissions": [28 "network",29 "filesystem:read",30 "env"31 ],32 "mcp": {33 "transport": "stdio",34 "command": "node",35 "args": [36 "server.mjs"37 ],38 "env": [39 {40 "name": "SCHOLARLY_ROOT",41 "description": "Only directory bibliography files (.bib, .bibtex, .txt, .md) may be read from (default: working directory).",42 "required": false,43 "secret": false44 },45 {46 "name": "OPENALEX_API_KEY",47 "description": "Optional OpenAlex API key of the operator. Without it, OpenAlex-backed tools share a small daily budget per IP address.",48 "required": false,49 "secret": true50 },51 {52 "name": "SCHOLARLY_MAILTO",53 "description": "Optional contact address sent to Crossref and OpenAlex (their polite pools). Unset by default: nothing identifying is sent.",54 "required": false,55 "secret": false56 },57 {58 "name": "SCHOLARLY_TIMEOUT_MS",59 "description": "Per-request timeout in milliseconds (default 20000).",60 "required": false,61 "secret": false62 }63 ],64 "tools": [65 {66 "name": "scholarly_status",67 "description": "Configuration, request counters and remaining OpenAlex budget"68 },69 {70 "name": "search_works",71 "description": "Search works by text, title, author, year and type"72 },73 {74 "name": "get_work",75 "description": "Registered metadata of one work by DOI, arXiv id, OpenAlex id or PMID"76 },77 {78 "name": "verify_doi",79 "description": "Check that a DOI resolves and its record matches the citation"80 },81 {82 "name": "resolve_reference",83 "description": "Find the record for a reference without a DOI, or say there is none"84 },85 {86 "name": "verify_bibliography",87 "description": "Audit a .bib file or reference list, one status per entry"88 },89 {90 "name": "check_retractions",91 "description": "Retractions, expressions of concern and corrections for a list of DOIs"92 },93 {94 "name": "get_citations",95 "description": "Works citing a work"96 },97 {98 "name": "get_references",99 "description": "Reference list of a work"100 },101 {102 "name": "related_works",103 "description": "Works related by shared concepts"104 },105 {106 "name": "author_works",107 "description": "Works of an author by ORCID, id or name"108 },109 {110 "name": "search_arxiv",111 "description": "Search or look up arXiv preprints"112 },113 {114 "name": "get_open_access",115 "description": "Legal open-access copies of a work"116 },117 {118 "name": "format_citation",119 "description": "APA, Chicago, MLA, BibTeX, RIS or CSL-JSON from registry metadata"120 },121 {122 "name": "bibtex_from_doi",123 "description": "BibTeX entry for a DOI"124 },125 {126 "name": "parse_bibtex",127 "description": "Parse BibTeX offline: entries, missing DOIs, duplicate keys, errors"128 }129 ]130 },131 "examples": [132 {133 "title": "Verify a bibliography against the registries (Claude Code)",134 "client": "claude-code",135 "image": "examples/claude-code.png",136 "alt": "Terminal screenshot of a Claude Code session using scholarly-mcp: the prompt, the tool or script calls, and the agent's answer.",137 "prompt": "Verify every entry of refs.bib with the scholarly MCP tools. One line per entry: key, status, and what differs from the registry record. Then say which entries must not be cited as they stand.",138 "caption": "Three test entries: one correct, one with an invented DOI, one with the wrong year. Each gets its status from Crossref and doi.org. Real session, Claude Code 2.1.322 with Fable 5.2, with version 1.0.0 installed from this registry; inputs are test fixtures.",139 "capturedAt": "2026-11-10"140 },141 {142 "title": "Verify a bibliography against the registries (Codex)",143 "client": "codex",144 "image": "examples/codex.png",145 "alt": "Terminal screenshot of a Codex session using scholarly-mcp: the prompt, the tool or script calls, and the agent's answer.",146 "prompt": "Verify every entry of refs.bib with the scholarly MCP tools. One line per entry: key, status, and what differs from the registry record. Then say which entries must not be cited as they stand.",147 "caption": "Three test entries: one correct, one with an invented DOI, one with the wrong year. Each gets its status from Crossref and doi.org. Real session, Codex CLI 0.167.1 with GPT-6.1-Sol, with version 1.0.0 installed from this registry; inputs are test fixtures.",148 "capturedAt": "2026-11-10"149 }150 ]151}152