{"openapi":"3.1.0","info":{"title":"Scholar API","version":"0.1.0","description":"Paper search and metadata (Crossref), citations in any style, arXiv, PubMed, Europe PMC, open-access lookup, authors (ORCID), journals.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://scholar.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/scholar/docs"},"termsOfService":"https://connectorbay.com/scholar/terms"},"servers":[{"url":"https://scholar.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/scholar/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/search_papers":{"post":{"operationId":"search_papers","summary":"Search the scholarly record (Crossref: journals, conferences, books, preprints, datasets) by topic and/or author,","description":"Search the scholarly record (Crossref: journals, conferences, books, preprints, datasets) by topic and/or author,\n    with year and type filters, sorted by relevance, citation count or date. Each result has title, authors, year,\n    venue, DOI, type, citation count and abstract when available. Use for \"papers on X since 2020\", \"most-cited work\n    by Y\", \"recent preprints about Z\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Topic, title words or phrase.","examples":["transformer attention mechanism","CRISPR off-target effects"],"title":"Query"},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Author name to require.","examples":["Yann LeCun"],"title":"Author"},"from_year":{"anyOf":[{"maximum":2100,"minimum":1600,"type":"integer"},{"type":"null"}],"default":null,"description":"Earliest publication year.","title":"From Year"},"until_year":{"anyOf":[{"maximum":2100,"minimum":1600,"type":"integer"},{"type":"null"}],"default":null,"description":"Latest publication year.","title":"Until Year"},"sort":{"default":"relevance","description":"'relevance', 'citations' or 'newest'.","examples":["citations"],"title":"Sort","type":"string"},"work_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"journal-article, proceedings-article, book-chapter, book, posted-content (preprints), dataset, dissertation…","examples":["journal-article"],"title":"Work Type"},"max_results":{"default":15,"maximum":50,"minimum":1,"title":"Max Results","type":"integer"}},"title":"search_papersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/paper":{"post":{"operationId":"paper","summary":"Everything about one paper from its DOI: full Crossref metadata (authors with ORCIDs, venue, volume/issue/pages,","description":"Everything about one paper from its DOI: full Crossref metadata (authors with ORCIDs, venue, volume/issue/pages,\n    type, citation count, abstract, license, funders, reference DOIs), open-access status and free PDF (Unpaywall), and\n    a tl;dr plus influential-citation count from Semantic Scholar when available. Use for \"tell me about this DOI\",\n    \"who wrote 10.1038/nature14539\", \"is there a free version\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"doi":{"description":"A DOI (or a doi.org URL).","examples":["10.1038/nature14539"],"title":"Doi","type":"string"}},"required":["doi"],"title":"paperArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/cite":{"post":{"operationId":"cite","summary":"A formatted reference for a DOI in a named style (APA, MLA, Chicago author-date, Harvard, IEEE, Vancouver,","description":"A formatted reference for a DOI in a named style (APA, MLA, Chicago author-date, Harvard, IEEE, Vancouver,\n    Nature, ACM, AMA) or a BibTeX entry — produced by the DOI registry's own citation formatter, so it is exact. Use\n    for \"cite this in APA\", \"give me the BibTeX for 10.1038/nature14539\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"doi":{"description":"The DOI to cite.","examples":["10.1038/nature14539"],"title":"Doi","type":"string"},"style":{"default":"apa","description":"apa, mla, chicago, harvard, ieee, vancouver, nature, acm, ama, or bibtex.","examples":["apa","bibtex"],"title":"Style","type":"string"}},"required":["doi"],"title":"citeArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/arxiv_search":{"post":{"operationId":"arxiv_search","summary":"Search arXiv preprints by words and/or category, sorted by relevance or date — or, with only a category and","description":"Search arXiv preprints by words and/or category, sorted by relevance or date — or, with only a category and\n    sort='newest', the latest submissions in that field. Each result has arXiv id, title, authors, dates, abstract,\n    categories, DOI/journal reference when published, and PDF link. Use for \"recent arXiv papers on diffusion models\",\n    \"what's new in cs.CL today\", \"arXiv search: quantum error correction\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Words or phrase to search in title/abstract/authors.","examples":["diffusion models","quantum error correction"],"title":"Query"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"arXiv category to restrict to: cs.LG, cs.CL, cs.CV, stat.ML, quant-ph, astro-ph, math.CO, econ.GN…","examples":["cs.CL"],"title":"Category"},"sort":{"default":"relevance","description":"'relevance', 'newest' (submission date) or 'updated'.","examples":["newest"],"title":"Sort","type":"string"},"max_results":{"default":15,"maximum":50,"minimum":1,"title":"Max Results","type":"integer"}},"title":"arxiv_searchArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/arxiv_paper":{"post":{"operationId":"arxiv_paper","summary":"One arXiv paper by id: title, authors, abstract, submission/update dates, categories, comments (pages, venue),","description":"One arXiv paper by id: title, authors, abstract, submission/update dates, categories, comments (pages, venue),\n    journal reference and DOI if published, PDF link. Use for \"what is arXiv 1706.03762\", \"summarise this arXiv paper\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"arxiv_id":{"description":"arXiv identifier, e.g. '1706.03762' or '2301.00001v2' or an arxiv.org URL.","examples":["1706.03762"],"title":"Arxiv Id","type":"string"}},"required":["arxiv_id"],"title":"arxiv_paperArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/pubmed_search":{"post":{"operationId":"pubmed_search","summary":"Search PubMed (37M+ biomedical records) with full PubMed query syntax: title, authors, journal, date, DOI, PMCID","description":"Search PubMed (37M+ biomedical records) with full PubMed query syntax: title, authors, journal, date, DOI, PMCID\n    (free full text) and publication types (e.g. randomized controlled trial, review, meta-analysis). Use for \"latest\n    trials of semaglutide\", \"reviews on gut microbiome and depression since 2022\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"PubMed query; field tags work: 'semaglutide obesity', 'Smith J[au] AND 2024[dp]', 'asthma[MeSH] AND randomized controlled trial[pt]'.","examples":["semaglutide obesity randomized"],"title":"Query","type":"string"},"sort":{"default":"relevance","description":"'relevance' or 'newest'.","examples":["newest"],"title":"Sort","type":"string"},"min_year":{"anyOf":[{"maximum":2100,"minimum":1900,"type":"integer"},{"type":"null"}],"default":null,"description":"Only papers from this year on.","title":"Min Year"},"max_results":{"default":15,"maximum":50,"minimum":1,"title":"Max Results","type":"integer"}},"required":["query"],"title":"pubmed_searchArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/pubmed_article":{"post":{"operationId":"pubmed_article","summary":"A PubMed article in full: structured abstract, authors with affiliations, journal, year, DOI, PMCID with free","description":"A PubMed article in full: structured abstract, authors with affiliations, journal, year, DOI, PMCID with free\n    full-text link, MeSH terms, keywords and publication types. Use after pubmed_search or for \"abstract of PMID X\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"pmid":{"description":"PubMed id.","examples":["38000000"],"title":"Pmid","type":"string"}},"required":["pmid"],"title":"pubmed_articleArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/europepmc_search":{"post":{"operationId":"europepmc_search","summary":"Search Europe PMC — PubMed plus preprints, Agricola and patents — with citation counts and open-access flags,","description":"Search Europe PMC — PubMed plus preprints, Agricola and patents — with citation counts and open-access flags,\n    sortable by citations. Use for \"most-cited papers on long covid\", \"preprints about X this month\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Query (Europe PMC syntax; plain words work).","examples":["long covid fatigue"],"title":"Query","type":"string"},"sort":{"default":"relevance","description":"'relevance', 'newest' or 'citations'.","examples":["citations"],"title":"Sort","type":"string"},"include_preprints":{"default":true,"description":"Include bioRxiv/medRxiv preprints.","title":"Include Preprints","type":"boolean"},"max_results":{"default":15,"maximum":50,"minimum":1,"title":"Max Results","type":"integer"}},"required":["query"],"title":"europepmc_searchArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/open_access":{"post":{"operationId":"open_access","summary":"Is there a legal free copy? Unpaywall's open-access status (gold/green/hybrid/bronze/closed), the best free PDF","description":"Is there a legal free copy? Unpaywall's open-access status (gold/green/hybrid/bronze/closed), the best free PDF\n    or landing page, its host (publisher or repository), version (published/accepted/submitted) and license, plus\n    other locations. Use for \"free PDF of this paper\", \"is this open access\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"doi":{"description":"The DOI.","examples":["10.1038/nature14539"],"title":"Doi","type":"string"}},"required":["doi"],"title":"open_accessArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/author":{"post":{"operationId":"author","summary":"An author's identity and output: ORCID records matching the name (with institutions), the works listed on the","description":"An author's identity and output: ORCID records matching the name (with institutions), the works listed on the\n    chosen ORCID record, and their most-cited papers from Crossref. Use for \"what has Geoffrey Hinton published\",\n    \"find the ORCID for Jane Smith at MIT\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Author name, 'Given Family'.","examples":["Geoffrey Hinton"],"title":"Name"},"orcid":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"An ORCID iD (0000-0002-…); skips the name search.","examples":["0000-0002-8063-7209"],"title":"Orcid"},"max_works":{"default":15,"maximum":50,"minimum":1,"title":"Max Works","type":"integer"}},"title":"authorArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/journal":{"post":{"operationId":"journal","summary":"A journal's registry record (Crossref): title, publisher, ISSNs, subjects, total articles registered and output","description":"A journal's registry record (Crossref): title, publisher, ISSNs, subjects, total articles registered and output\n    per recent year. Use for \"which journal is ISSN 1476-4687\", \"how much does Nature Medicine publish a year\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Journal name or ISSN.","examples":["Nature Medicine","1476-4687"],"title":"Query","type":"string"}},"required":["query"],"title":"journalArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}