{
  "markdown": "# mcp-scholaris\n\nAn MCP server for retrieving academic papers from open access sources. Provides search across arXiv, Semantic Scholar, and PubMed, with full text retrieval via arXiv PDFs, PubMed Central (BioC API), and Unpaywall. No paywalls, no grey area — legitimate open access only.\n\n## Installation\n\n``````bash\npip install mcp-scholaris\n``````\n\n## Tools\n\n### ``search_papers``\n\nSearch for academic papers by topic, author, or keyword.\n\n**Parameters:**\n- ``query`` (required) — search terms\n- ``sources`` (optional) — list of sources to search: ``arxiv``, ``semantic_scholar``, ``pubmed``. Defaults to all three.\n- ``max_results`` (optional) — maximum results per source. Defaults to 5.\n\n### ``fetch_paper``\n\nFetch the full text of a paper. Tries open access sources in order: arXiv → PubMed Central → Unpaywall. Provide at least one identifier.\n\n**Parameters:**\n- ``arxiv_id`` — e.g. ``2301.00001`` or ``arxiv:2301.00001``\n- ``pubmed_id`` — PubMed ID (PMID), e.g. ``36383508``\n- ``doi`` — e.g. ``10.1371/journal.pone.0276755``\n\n## Configuration\n\nSemantic Scholar works without an API key but is rate-limited. For higher limits, create a ``.env`` file in your working directory:\n\n``````\nSEMANTIC_SCHOLAR_API_KEY=your_key_here\n``````\n\nAPI keys are free at [semanticscholar.org](https://www.semanticscholar.org/product/api).\n\n## Usage with an MCP client\n\nAdd to your MCP client configuration:\n\n``````json\n{\n  \"mcpServers\": {\n    \"scholaris\": {\n      \"command\": \"scholaris\"\n    }\n  }\n}\n``````\n\nOr run directly:\n\n``````bash\nscholaris\n``````\n\nThe server communicates over stdio using the MCP protocol (JSON-RPC 2.0).\n\n## Sources\n\n| Source | Search | Full Text |\n|---|---|---|\n| arXiv | ✓ | ✓ PDF |\n| Semantic Scholar | ✓ | ✓ when OA PDF available |\n| PubMed | ✓ | ✓ via BioC API (PMC articles) |\n| Unpaywall | — | ✓ for any DOI with OA version |\n\n## License\n\nMIT\n",
  "bytes": 1864,
  "sha": "1afcbd9140231695146cc957fed1fcbbe1418052a65f5ca4e539648686de5e76",
  "repo_slug": "penny4nonsense/mcp-scholaris",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_penny4nonsense_mcp_scholaris_8e5a0d3f/readme"
}