Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Scholar MCP

by pvliesdonkversion 3.2.0i★ 3iRuns on your computerOfficial site ↗
Registry nameio.github.pvliesdonk/scholar-mcp

How to install

What it does

Scholarly papers, patents, books, standards and PDF conversion

  • Connects Runs on your computer
  • Account or key Needs SCHOLAR_MCP_VLM_API_KEY
  • Category Search & AI memory

Use together with

Skills that teach the AI this kind of work; they work alongside this one

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

by google-research★ 35,6291 skills

Skill · How-to guide

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

by BigBodyCobain★ 11,6021 skills

Skill · How-to guide

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

by gosom★ 8,2091 skills

Skill · How-to guide

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity25/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score37/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Scholar MCP. Follow https://mcp.popnx.com/i/pvliesdonk-scholar-mcp.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

You need a Scholar MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone

Let AI install it

Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Scholar MCP for Claude on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "scholar": { "command": "uvx", "args": [ "pvliesdonk-scholar-mcp" ], "env": { "SCHOLAR_MCP_VLM_API_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For SCHOLAR_MCP_VLM_API_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Scholar MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Sign up and create a Scholar MCP key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the Scholar MCP site ↗

  3. Open the Claude desktop app’s settings file

    SettingsDeveloperEdit Config

  4. Paste these settings and save the file

    {
      "mcpServers": {
        "scholar": {
          "command": "uvx",
          "args": [
            "pvliesdonk-scholar-mcp"
          ],
          "env": {
            "SCHOLAR_MCP_VLM_API_KEY": "your-value"
          }
        }
      }
    }

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Quit Claude and open it again

  6. Try it

    Use Scholar MCP and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Scholar MCP or shows a Scholar MCP tool in the answer, you are connected

31 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • SCHOLAR_MCP_KV_STORE_URL Persistent-state backend URL shared by every pvl-core subsystem that needs state. `memory://` is in-process and lost on restart; `file:///path` persists on one server; `redis://`, `dynamodb://` and `… · default file:///data/state
  • SCHOLAR_MCP_TOOLS_ALLOW Comma-separated explicit tool names this instance exposes; every other tool is hidden from listings and cannot be invoked. Names matching no registered tool are inert. Mutually exclusive with `tools_…
  • SCHOLAR_MCP_TOOLS_DENY Comma-separated explicit tool names hidden from this instance (absent from listings, cannot be invoked). Names matching no registered tool are inert. Mutually exclusive with `tools_allow`. Takes effe…
  • SCHOLAR_MCP_SERVER_NAME Rename this server instance; defaults to the project name.
  • SCHOLAR_MCP_INSTANCE_DESCRIPTION Concise routing context that distinguishes this deployment's material or responsibility.
  • SCHOLAR_MCP_INSTRUCTIONS_EXTRA Deployment-specific behavioral policy added to the generated MCP instructions.
  • SCHOLAR_MCP_INSTRUCTIONS Legacy: replaces all generated MCP instructions (deprecated; use _INSTANCE_DESCRIPTION for routing and _INSTRUCTIONS_EXTRA for policy).
  • SCHOLAR_MCP_LOG_LEVEL Log level for every logger in the process, FastMCP's included (DEBUG / INFO / WARNING / ERROR / CRITICAL). The -v CLI flag overrides to DEBUG. The unprefixed FASTMCP_LOG_LEVEL still works for one maj… · default INFO
  • SCHOLAR_MCP_LOG_FORMAT Log rendering. rich is one colour event key=value line per record, for a terminal; json is one JSON object per record, for a collector. Unset picks rich when stderr is a terminal and json everywhere…
  • SCHOLAR_GITHUB_TOKEN GitHub token used to raise rate limits when fetching standards documents from GitHub. Optional; unauthenticated requests work at reduced limits.
  • SCHOLAR_MCP_READ_ONLY When true, write-tagged tools (PDF download and conversion cache writes) are hidden. Set false to enable them. · default true
  • SCHOLAR_MCP_S2_API_KEY Semantic Scholar API key. Optional but strongly recommended: a key has an introductory 1 req/s allowance; anonymous users share capacity and may be throttled. Request one at https://www.semanticschol…
  • SCHOLAR_MCP_DOCLING_URL Base URL of a running docling-serve instance for PDF conversion (e.g. http://localhost:5001). When unset, PDF conversion tools return an error.
  • SCHOLAR_MCP_VLM_API_URL OpenAI-compatible VLM endpoint for formula and figure enrichment during PDF conversion.
  • SCHOLAR_MCP_VLM_MODEL Model name to use with the VLM endpoint. · default gpt-4o
  • SCHOLAR_MCP_VLM_PARAMS JSON object of extra request parameters for every VLM call, overriding the defaults, for a model that needs them (e.g. {"temperature": 1}).
  • SCHOLAR_MCP_CACHE_DIR Directory for the SQLite cache database (cache.db) and downloaded PDFs (pdfs/, md/). · default /data/scholar-mcp
  • SCHOLAR_MCP_CONTACT_EMAIL Contact email for the OpenAlex polite pool (improves rate limits). Also enables Unpaywall lookups as a PDF fallback source.
  • SCHOLAR_MCP_EPO_CONSUMER_KEY EPO Open Patent Services consumer key. Optional; patent tools are hidden when unset. Register at https://developers.epo.org/user/register.
  • SCHOLAR_MCP_EPO_CONSUMER_SECRET EPO Open Patent Services consumer secret. Optional; patent tools are hidden when unset.
  • SCHOLAR_MCP_GOOGLE_BOOKS_API_KEY Google Books API key. Optional; book tools work unauthenticated at reduced rate limits.
  • SCHOLAR_MCP_ACCESS_LINKS Links to a paper through your library, offered when no PDF can be fetched and with each paper lookup: a JSON list of objects with a label and an http(s) URL template, in priority order. Placeholders:…
  • SCHOLAR_MCP_PDF_FETCH_ALLOW_PRIVATE When false (the default), a PDF download is refused if the host, or a redirect target, resolves to a loopback, private, link-local or other non-public address. This covers URLs the caller supplies an… · default false
  • SCHOLAR_MCP_JOBS_SOFT_DEADLINE_S Seconds a long-running tool call may run in the foreground before it is promoted to a background job and a job handle is returned instead. · default 25.0
  • SCHOLAR_MCP_JOBS_RESULT_TTL_S Seconds a background-job record (working or finished) is retained for polling before it expires from the store. · default 3600.0
  • SCHOLAR_MCP_JOBS_MAX_PER_SUBJECT Maximum live background jobs per calling subject; further promotions are rejected until older records expire. · default 256
  • SCHOLAR_MCP_TRANSFER_TTL_DEFAULT_S Link lifetime in seconds when the caller requests no explicit TTL. · default 3600.0
  • SCHOLAR_MCP_TRANSFER_TTL_MAX_S Ceiling in seconds a caller-requested link TTL is clamped to. · default 86400.0
  • SCHOLAR_MCP_TRANSFER_GRACE_TTL_S Post-success grace window in seconds: a served token's TTL shrinks to this so a stalled transfer can retry within it. · default 60.0
  • SCHOLAR_MCP_TRANSFER_LEASE_S Crashed-handler reclaim window in seconds for an in-flight reservation. · default 60.0
  • SCHOLAR_MCP_TRANSFER_MAX_UPLOAD_BYTES Maximum size in bytes of a single upload. · default 104857600

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect Scholar MCP yet

Scholar MCP runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect Scholar MCP

  • You need a Scholar MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
  • You need a Scholar MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)
  • You need a Scholar MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)
  • You need a Scholar MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)

B · Others in Search & AI memory that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code, with some setup first

You need a Scholar MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Scholar MCP for Claude Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user scholar --env SCHOLAR_MCP_VLM_API_KEY=your-value -- uvx pvliesdonk-scholar-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For SCHOLAR_MCP_VLM_API_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Scholar MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Sign up and create a Scholar MCP key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the Scholar MCP site ↗

  3. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  4. Paste this command and press Enter

    claude mcp add --scope user scholar --env SCHOLAR_MCP_VLM_API_KEY=your-value -- uvx pvliesdonk-scholar-mcp

    Replace “your-value” with your key before pressing Enter

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Type /mcp in Claude Code

    You should see Scholar MCP listed as connected

  6. Try it

    Use Scholar MCP and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Scholar MCP or shows a Scholar MCP tool in the answer, you are connected

31 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • SCHOLAR_MCP_KV_STORE_URL Persistent-state backend URL shared by every pvl-core subsystem that needs state. `memory://` is in-process and lost on restart; `file:///path` persists on one server; `redis://`, `dynamodb://` and `… · default file:///data/state
  • SCHOLAR_MCP_TOOLS_ALLOW Comma-separated explicit tool names this instance exposes; every other tool is hidden from listings and cannot be invoked. Names matching no registered tool are inert. Mutually exclusive with `tools_…
  • SCHOLAR_MCP_TOOLS_DENY Comma-separated explicit tool names hidden from this instance (absent from listings, cannot be invoked). Names matching no registered tool are inert. Mutually exclusive with `tools_allow`. Takes effe…
  • SCHOLAR_MCP_SERVER_NAME Rename this server instance; defaults to the project name.
  • SCHOLAR_MCP_INSTANCE_DESCRIPTION Concise routing context that distinguishes this deployment's material or responsibility.
  • SCHOLAR_MCP_INSTRUCTIONS_EXTRA Deployment-specific behavioral policy added to the generated MCP instructions.
  • SCHOLAR_MCP_INSTRUCTIONS Legacy: replaces all generated MCP instructions (deprecated; use _INSTANCE_DESCRIPTION for routing and _INSTRUCTIONS_EXTRA for policy).
  • SCHOLAR_MCP_LOG_LEVEL Log level for every logger in the process, FastMCP's included (DEBUG / INFO / WARNING / ERROR / CRITICAL). The -v CLI flag overrides to DEBUG. The unprefixed FASTMCP_LOG_LEVEL still works for one maj… · default INFO
  • SCHOLAR_MCP_LOG_FORMAT Log rendering. rich is one colour event key=value line per record, for a terminal; json is one JSON object per record, for a collector. Unset picks rich when stderr is a terminal and json everywhere…
  • SCHOLAR_GITHUB_TOKEN GitHub token used to raise rate limits when fetching standards documents from GitHub. Optional; unauthenticated requests work at reduced limits.
  • SCHOLAR_MCP_READ_ONLY When true, write-tagged tools (PDF download and conversion cache writes) are hidden. Set false to enable them. · default true
  • SCHOLAR_MCP_S2_API_KEY Semantic Scholar API key. Optional but strongly recommended: a key has an introductory 1 req/s allowance; anonymous users share capacity and may be throttled. Request one at https://www.semanticschol…
  • SCHOLAR_MCP_DOCLING_URL Base URL of a running docling-serve instance for PDF conversion (e.g. http://localhost:5001). When unset, PDF conversion tools return an error.
  • SCHOLAR_MCP_VLM_API_URL OpenAI-compatible VLM endpoint for formula and figure enrichment during PDF conversion.
  • SCHOLAR_MCP_VLM_MODEL Model name to use with the VLM endpoint. · default gpt-4o
  • SCHOLAR_MCP_VLM_PARAMS JSON object of extra request parameters for every VLM call, overriding the defaults, for a model that needs them (e.g. {"temperature": 1}).
  • SCHOLAR_MCP_CACHE_DIR Directory for the SQLite cache database (cache.db) and downloaded PDFs (pdfs/, md/). · default /data/scholar-mcp
  • SCHOLAR_MCP_CONTACT_EMAIL Contact email for the OpenAlex polite pool (improves rate limits). Also enables Unpaywall lookups as a PDF fallback source.
  • SCHOLAR_MCP_EPO_CONSUMER_KEY EPO Open Patent Services consumer key. Optional; patent tools are hidden when unset. Register at https://developers.epo.org/user/register.
  • SCHOLAR_MCP_EPO_CONSUMER_SECRET EPO Open Patent Services consumer secret. Optional; patent tools are hidden when unset.
  • SCHOLAR_MCP_GOOGLE_BOOKS_API_KEY Google Books API key. Optional; book tools work unauthenticated at reduced rate limits.
  • SCHOLAR_MCP_ACCESS_LINKS Links to a paper through your library, offered when no PDF can be fetched and with each paper lookup: a JSON list of objects with a label and an http(s) URL template, in priority order. Placeholders:…
  • SCHOLAR_MCP_PDF_FETCH_ALLOW_PRIVATE When false (the default), a PDF download is refused if the host, or a redirect target, resolves to a loopback, private, link-local or other non-public address. This covers URLs the caller supplies an… · default false
  • SCHOLAR_MCP_JOBS_SOFT_DEADLINE_S Seconds a long-running tool call may run in the foreground before it is promoted to a background job and a job handle is returned instead. · default 25.0
  • SCHOLAR_MCP_JOBS_RESULT_TTL_S Seconds a background-job record (working or finished) is retained for polling before it expires from the store. · default 3600.0
  • SCHOLAR_MCP_JOBS_MAX_PER_SUBJECT Maximum live background jobs per calling subject; further promotions are rejected until older records expire. · default 256
  • SCHOLAR_MCP_TRANSFER_TTL_DEFAULT_S Link lifetime in seconds when the caller requests no explicit TTL. · default 3600.0
  • SCHOLAR_MCP_TRANSFER_TTL_MAX_S Ceiling in seconds a caller-requested link TTL is clamped to. · default 86400.0
  • SCHOLAR_MCP_TRANSFER_GRACE_TTL_S Post-success grace window in seconds: a served token's TTL shrinks to this so a stalled transfer can retry within it. · default 60.0
  • SCHOLAR_MCP_TRANSFER_LEASE_S Crashed-handler reclaim window in seconds for an in-flight reservation. · default 60.0
  • SCHOLAR_MCP_TRANSFER_MAX_UPLOAD_BYTES Maximum size in bytes of a single upload. · default 104857600

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

You need a Scholar MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Scholar MCP for Cursor on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "scholar": { "command": "uvx", "args": [ "pvliesdonk-scholar-mcp" ], "env": { "SCHOLAR_MCP_VLM_API_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For SCHOLAR_MCP_VLM_API_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Scholar MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Sign up and create a Scholar MCP key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the Scholar MCP site ↗

  3. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  4. Fill in your key

    In the Scholar MCP settings, SCHOLAR_MCP_VLM_API_KEY is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Open the AI chat in Cursor in Agent mode

  6. Try it

    Use Scholar MCP and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Scholar MCP or shows a Scholar MCP tool in the answer, you are connected

31 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • SCHOLAR_MCP_KV_STORE_URL Persistent-state backend URL shared by every pvl-core subsystem that needs state. `memory://` is in-process and lost on restart; `file:///path` persists on one server; `redis://`, `dynamodb://` and `… · default file:///data/state
  • SCHOLAR_MCP_TOOLS_ALLOW Comma-separated explicit tool names this instance exposes; every other tool is hidden from listings and cannot be invoked. Names matching no registered tool are inert. Mutually exclusive with `tools_…
  • SCHOLAR_MCP_TOOLS_DENY Comma-separated explicit tool names hidden from this instance (absent from listings, cannot be invoked). Names matching no registered tool are inert. Mutually exclusive with `tools_allow`. Takes effe…
  • SCHOLAR_MCP_SERVER_NAME Rename this server instance; defaults to the project name.
  • SCHOLAR_MCP_INSTANCE_DESCRIPTION Concise routing context that distinguishes this deployment's material or responsibility.
  • SCHOLAR_MCP_INSTRUCTIONS_EXTRA Deployment-specific behavioral policy added to the generated MCP instructions.
  • SCHOLAR_MCP_INSTRUCTIONS Legacy: replaces all generated MCP instructions (deprecated; use _INSTANCE_DESCRIPTION for routing and _INSTRUCTIONS_EXTRA for policy).
  • SCHOLAR_MCP_LOG_LEVEL Log level for every logger in the process, FastMCP's included (DEBUG / INFO / WARNING / ERROR / CRITICAL). The -v CLI flag overrides to DEBUG. The unprefixed FASTMCP_LOG_LEVEL still works for one maj… · default INFO
  • SCHOLAR_MCP_LOG_FORMAT Log rendering. rich is one colour event key=value line per record, for a terminal; json is one JSON object per record, for a collector. Unset picks rich when stderr is a terminal and json everywhere…
  • SCHOLAR_GITHUB_TOKEN GitHub token used to raise rate limits when fetching standards documents from GitHub. Optional; unauthenticated requests work at reduced limits.
  • SCHOLAR_MCP_READ_ONLY When true, write-tagged tools (PDF download and conversion cache writes) are hidden. Set false to enable them. · default true
  • SCHOLAR_MCP_S2_API_KEY Semantic Scholar API key. Optional but strongly recommended: a key has an introductory 1 req/s allowance; anonymous users share capacity and may be throttled. Request one at https://www.semanticschol…
  • SCHOLAR_MCP_DOCLING_URL Base URL of a running docling-serve instance for PDF conversion (e.g. http://localhost:5001). When unset, PDF conversion tools return an error.
  • SCHOLAR_MCP_VLM_API_URL OpenAI-compatible VLM endpoint for formula and figure enrichment during PDF conversion.
  • SCHOLAR_MCP_VLM_MODEL Model name to use with the VLM endpoint. · default gpt-4o
  • SCHOLAR_MCP_VLM_PARAMS JSON object of extra request parameters for every VLM call, overriding the defaults, for a model that needs them (e.g. {"temperature": 1}).
  • SCHOLAR_MCP_CACHE_DIR Directory for the SQLite cache database (cache.db) and downloaded PDFs (pdfs/, md/). · default /data/scholar-mcp
  • SCHOLAR_MCP_CONTACT_EMAIL Contact email for the OpenAlex polite pool (improves rate limits). Also enables Unpaywall lookups as a PDF fallback source.
  • SCHOLAR_MCP_EPO_CONSUMER_KEY EPO Open Patent Services consumer key. Optional; patent tools are hidden when unset. Register at https://developers.epo.org/user/register.
  • SCHOLAR_MCP_EPO_CONSUMER_SECRET EPO Open Patent Services consumer secret. Optional; patent tools are hidden when unset.
  • SCHOLAR_MCP_GOOGLE_BOOKS_API_KEY Google Books API key. Optional; book tools work unauthenticated at reduced rate limits.
  • SCHOLAR_MCP_ACCESS_LINKS Links to a paper through your library, offered when no PDF can be fetched and with each paper lookup: a JSON list of objects with a label and an http(s) URL template, in priority order. Placeholders:…
  • SCHOLAR_MCP_PDF_FETCH_ALLOW_PRIVATE When false (the default), a PDF download is refused if the host, or a redirect target, resolves to a loopback, private, link-local or other non-public address. This covers URLs the caller supplies an… · default false
  • SCHOLAR_MCP_JOBS_SOFT_DEADLINE_S Seconds a long-running tool call may run in the foreground before it is promoted to a background job and a job handle is returned instead. · default 25.0
  • SCHOLAR_MCP_JOBS_RESULT_TTL_S Seconds a background-job record (working or finished) is retained for polling before it expires from the store. · default 3600.0
  • SCHOLAR_MCP_JOBS_MAX_PER_SUBJECT Maximum live background jobs per calling subject; further promotions are rejected until older records expire. · default 256
  • SCHOLAR_MCP_TRANSFER_TTL_DEFAULT_S Link lifetime in seconds when the caller requests no explicit TTL. · default 3600.0
  • SCHOLAR_MCP_TRANSFER_TTL_MAX_S Ceiling in seconds a caller-requested link TTL is clamped to. · default 86400.0
  • SCHOLAR_MCP_TRANSFER_GRACE_TTL_S Post-success grace window in seconds: a served token's TTL shrinks to this so a stalled transfer can retry within it. · default 60.0
  • SCHOLAR_MCP_TRANSFER_LEASE_S Crashed-handler reclaim window in seconds for an in-flight reservation. · default 60.0
  • SCHOLAR_MCP_TRANSFER_MAX_UPLOAD_BYTES Maximum size in bytes of a single upload. · default 104857600

Descriptions are as written by the maker.

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

You need a Scholar MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Scholar MCP for VS Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "scholar": { "type": "stdio", "command": "uvx", "args": [ "pvliesdonk-scholar-mcp" ], "env": { "SCHOLAR_MCP_VLM_API_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For SCHOLAR_MCP_VLM_API_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Scholar MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Sign up and create a Scholar MCP key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the Scholar MCP site ↗

  3. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  4. Fill in your key

    In the Scholar MCP settings, SCHOLAR_MCP_VLM_API_KEY is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Open the AI chat in VS Code in Agent mode

  6. Try it

    Use Scholar MCP and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Scholar MCP or shows a Scholar MCP tool in the answer, you are connected

31 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • SCHOLAR_MCP_KV_STORE_URL Persistent-state backend URL shared by every pvl-core subsystem that needs state. `memory://` is in-process and lost on restart; `file:///path` persists on one server; `redis://`, `dynamodb://` and `… · default file:///data/state
  • SCHOLAR_MCP_TOOLS_ALLOW Comma-separated explicit tool names this instance exposes; every other tool is hidden from listings and cannot be invoked. Names matching no registered tool are inert. Mutually exclusive with `tools_…
  • SCHOLAR_MCP_TOOLS_DENY Comma-separated explicit tool names hidden from this instance (absent from listings, cannot be invoked). Names matching no registered tool are inert. Mutually exclusive with `tools_allow`. Takes effe…
  • SCHOLAR_MCP_SERVER_NAME Rename this server instance; defaults to the project name.
  • SCHOLAR_MCP_INSTANCE_DESCRIPTION Concise routing context that distinguishes this deployment's material or responsibility.
  • SCHOLAR_MCP_INSTRUCTIONS_EXTRA Deployment-specific behavioral policy added to the generated MCP instructions.
  • SCHOLAR_MCP_INSTRUCTIONS Legacy: replaces all generated MCP instructions (deprecated; use _INSTANCE_DESCRIPTION for routing and _INSTRUCTIONS_EXTRA for policy).
  • SCHOLAR_MCP_LOG_LEVEL Log level for every logger in the process, FastMCP's included (DEBUG / INFO / WARNING / ERROR / CRITICAL). The -v CLI flag overrides to DEBUG. The unprefixed FASTMCP_LOG_LEVEL still works for one maj… · default INFO
  • SCHOLAR_MCP_LOG_FORMAT Log rendering. rich is one colour event key=value line per record, for a terminal; json is one JSON object per record, for a collector. Unset picks rich when stderr is a terminal and json everywhere…
  • SCHOLAR_GITHUB_TOKEN GitHub token used to raise rate limits when fetching standards documents from GitHub. Optional; unauthenticated requests work at reduced limits.
  • SCHOLAR_MCP_READ_ONLY When true, write-tagged tools (PDF download and conversion cache writes) are hidden. Set false to enable them. · default true
  • SCHOLAR_MCP_S2_API_KEY Semantic Scholar API key. Optional but strongly recommended: a key has an introductory 1 req/s allowance; anonymous users share capacity and may be throttled. Request one at https://www.semanticschol…
  • SCHOLAR_MCP_DOCLING_URL Base URL of a running docling-serve instance for PDF conversion (e.g. http://localhost:5001). When unset, PDF conversion tools return an error.
  • SCHOLAR_MCP_VLM_API_URL OpenAI-compatible VLM endpoint for formula and figure enrichment during PDF conversion.
  • SCHOLAR_MCP_VLM_MODEL Model name to use with the VLM endpoint. · default gpt-4o
  • SCHOLAR_MCP_VLM_PARAMS JSON object of extra request parameters for every VLM call, overriding the defaults, for a model that needs them (e.g. {"temperature": 1}).
  • SCHOLAR_MCP_CACHE_DIR Directory for the SQLite cache database (cache.db) and downloaded PDFs (pdfs/, md/). · default /data/scholar-mcp
  • SCHOLAR_MCP_CONTACT_EMAIL Contact email for the OpenAlex polite pool (improves rate limits). Also enables Unpaywall lookups as a PDF fallback source.
  • SCHOLAR_MCP_EPO_CONSUMER_KEY EPO Open Patent Services consumer key. Optional; patent tools are hidden when unset. Register at https://developers.epo.org/user/register.
  • SCHOLAR_MCP_EPO_CONSUMER_SECRET EPO Open Patent Services consumer secret. Optional; patent tools are hidden when unset.
  • SCHOLAR_MCP_GOOGLE_BOOKS_API_KEY Google Books API key. Optional; book tools work unauthenticated at reduced rate limits.
  • SCHOLAR_MCP_ACCESS_LINKS Links to a paper through your library, offered when no PDF can be fetched and with each paper lookup: a JSON list of objects with a label and an http(s) URL template, in priority order. Placeholders:…
  • SCHOLAR_MCP_PDF_FETCH_ALLOW_PRIVATE When false (the default), a PDF download is refused if the host, or a redirect target, resolves to a loopback, private, link-local or other non-public address. This covers URLs the caller supplies an… · default false
  • SCHOLAR_MCP_JOBS_SOFT_DEADLINE_S Seconds a long-running tool call may run in the foreground before it is promoted to a background job and a job handle is returned instead. · default 25.0
  • SCHOLAR_MCP_JOBS_RESULT_TTL_S Seconds a background-job record (working or finished) is retained for polling before it expires from the store. · default 3600.0
  • SCHOLAR_MCP_JOBS_MAX_PER_SUBJECT Maximum live background jobs per calling subject; further promotions are rejected until older records expire. · default 256
  • SCHOLAR_MCP_TRANSFER_TTL_DEFAULT_S Link lifetime in seconds when the caller requests no explicit TTL. · default 3600.0
  • SCHOLAR_MCP_TRANSFER_TTL_MAX_S Ceiling in seconds a caller-requested link TTL is clamped to. · default 86400.0
  • SCHOLAR_MCP_TRANSFER_GRACE_TTL_S Post-success grace window in seconds: a served token's TTL shrinks to this so a stalled transfer can retry within it. · default 60.0
  • SCHOLAR_MCP_TRANSFER_LEASE_S Crashed-handler reclaim window in seconds for an in-flight reservation. · default 60.0
  • SCHOLAR_MCP_TRANSFER_MAX_UPLOAD_BYTES Maximum size in bytes of a single upload. · default 104857600

Descriptions are as written by the maker.

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use Scholar MCP💬 Discussion →
For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

claude mcp add --scope user scholar --env SCHOLAR_MCP_VLM_API_KEY=your-value -- uvx pvliesdonk-scholar-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "scholar": {
      "command": "uvx",
      "args": [
        "pvliesdonk-scholar-mcp"
      ],
      "env": {
        "SCHOLAR_MCP_VLM_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "scholar": {
      "command": "uvx",
      "args": [
        "pvliesdonk-scholar-mcp"
      ],
      "env": {
        "SCHOLAR_MCP_VLM_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "scholar": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "pvliesdonk-scholar-mcp"
      ],
      "env": {
        "SCHOLAR_MCP_VLM_API_KEY": "your-value"
      }
    }
  }
}

Values you fill in

  • SCHOLAR_MCP_KV_STORE_URL env
    Persistent-state backend URL shared by every pvl-core subsystem that needs state. `memory://` is in-process and lost on restart; `file:///path` persists on one server; `redis://`, `dynamodb://` and `…
  • SCHOLAR_MCP_TOOLS_ALLOW env
    Comma-separated explicit tool names this instance exposes; every other tool is hidden from listings and cannot be invoked. Names matching no registered tool are inert. Mutually exclusive with `tools_…
  • SCHOLAR_MCP_TOOLS_DENY env
    Comma-separated explicit tool names hidden from this instance (absent from listings, cannot be invoked). Names matching no registered tool are inert. Mutually exclusive with `tools_allow`. Takes effe…
  • SCHOLAR_MCP_SERVER_NAME env
    Rename this server instance; defaults to the project name.
  • SCHOLAR_MCP_INSTANCE_DESCRIPTION env
    Concise routing context that distinguishes this deployment's material or responsibility.
  • SCHOLAR_MCP_INSTRUCTIONS_EXTRA env
    Deployment-specific behavioral policy added to the generated MCP instructions.
  • SCHOLAR_MCP_INSTRUCTIONS env
    Legacy: replaces all generated MCP instructions (deprecated; use _INSTANCE_DESCRIPTION for routing and _INSTRUCTIONS_EXTRA for policy).
  • SCHOLAR_MCP_LOG_LEVEL env
    Log level for every logger in the process, FastMCP's included (DEBUG / INFO / WARNING / ERROR / CRITICAL). The -v CLI flag overrides to DEBUG. The unprefixed FASTMCP_LOG_LEVEL still works for one maj…
  • SCHOLAR_MCP_LOG_FORMAT env
    Log rendering. rich is one colour event key=value line per record, for a terminal; json is one JSON object per record, for a collector. Unset picks rich when stderr is a terminal and json everywhere…
  • SCHOLAR_GITHUB_TOKEN secret env
    GitHub token used to raise rate limits when fetching standards documents from GitHub. Optional; unauthenticated requests work at reduced limits.
  • SCHOLAR_MCP_READ_ONLY env
    When true, write-tagged tools (PDF download and conversion cache writes) are hidden. Set false to enable them.
  • SCHOLAR_MCP_S2_API_KEY secret env
    Semantic Scholar API key. Optional but strongly recommended: a key has an introductory 1 req/s allowance; anonymous users share capacity and may be throttled. Request one at https://www.semanticschol…
  • SCHOLAR_MCP_DOCLING_URL env
    Base URL of a running docling-serve instance for PDF conversion (e.g. http://localhost:5001). When unset, PDF conversion tools return an error.
  • SCHOLAR_MCP_VLM_API_URL env
    OpenAI-compatible VLM endpoint for formula and figure enrichment during PDF conversion.
  • SCHOLAR_MCP_VLM_API_KEY secret required env
    API key for the VLM endpoint.
  • SCHOLAR_MCP_VLM_MODEL env
    Model name to use with the VLM endpoint.
  • SCHOLAR_MCP_VLM_PARAMS env
    JSON object of extra request parameters for every VLM call, overriding the defaults, for a model that needs them (e.g. {"temperature": 1}).
  • SCHOLAR_MCP_CACHE_DIR env
    Directory for the SQLite cache database (cache.db) and downloaded PDFs (pdfs/, md/).
  • SCHOLAR_MCP_CONTACT_EMAIL env
    Contact email for the OpenAlex polite pool (improves rate limits). Also enables Unpaywall lookups as a PDF fallback source.
  • SCHOLAR_MCP_EPO_CONSUMER_KEY secret env
    EPO Open Patent Services consumer key. Optional; patent tools are hidden when unset. Register at https://developers.epo.org/user/register.
  • SCHOLAR_MCP_EPO_CONSUMER_SECRET secret env
    EPO Open Patent Services consumer secret. Optional; patent tools are hidden when unset.
  • SCHOLAR_MCP_GOOGLE_BOOKS_API_KEY secret env
    Google Books API key. Optional; book tools work unauthenticated at reduced rate limits.
  • SCHOLAR_MCP_ACCESS_LINKS env
    Links to a paper through your library, offered when no PDF can be fetched and with each paper lookup: a JSON list of objects with a label and an http(s) URL template, in priority order. Placeholders:…
  • SCHOLAR_MCP_PDF_FETCH_ALLOW_PRIVATE env
    When false (the default), a PDF download is refused if the host, or a redirect target, resolves to a loopback, private, link-local or other non-public address. This covers URLs the caller supplies an…
  • SCHOLAR_MCP_JOBS_SOFT_DEADLINE_S env
    Seconds a long-running tool call may run in the foreground before it is promoted to a background job and a job handle is returned instead.
  • SCHOLAR_MCP_JOBS_RESULT_TTL_S env
    Seconds a background-job record (working or finished) is retained for polling before it expires from the store.
  • SCHOLAR_MCP_JOBS_MAX_PER_SUBJECT env
    Maximum live background jobs per calling subject; further promotions are rejected until older records expire.
  • SCHOLAR_MCP_TRANSFER_TTL_DEFAULT_S env
    Link lifetime in seconds when the caller requests no explicit TTL.
  • SCHOLAR_MCP_TRANSFER_TTL_MAX_S env
    Ceiling in seconds a caller-requested link TTL is clamped to.
  • SCHOLAR_MCP_TRANSFER_GRACE_TTL_S env
    Post-success grace window in seconds: a served token's TTL shrinks to this so a stalled transfer can retry within it.
  • SCHOLAR_MCP_TRANSFER_LEASE_S env
    Crashed-handler reclaim window in seconds for an in-flight reservation.
  • SCHOLAR_MCP_TRANSFER_MAX_UPLOAD_BYTES env
    Maximum size in bytes of a single upload.

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
1,063/wk
Connection
Runs on your computer
Transport
stdio, streamable-http
Latest versioni
3.2.0
Published to registryi
Nov 9, 2026
Code last changedi
Nov 18, 2026
Maker
pvliesdonk
Packages
pypi: pvliesdonk-scholar-mcp
oci: ghcr.io/pvliesdonk/scholar-mcp:v3.2.0
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account pvliesdonk, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed yesterday

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for pvliesdonk-scholar-mcp@3.2.0

Checks only this package version, not every dependency · checked Nov 15, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/pvliesdonk-scholar-mcp.svg)](https://mcp.popnx.com/en/servers/pvliesdonk-scholar-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Search & AI memoryi

  • More stars than 86% of the other 6394 servers in this category
  • Published to the registry more recently than 81% of the other 6394 servers in this category
  • Basic checks equal to or better than 99% of the other 6394 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Scholar MCP safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: SCHOLAR_MCP_VLM_API_KEY

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed yesterday, and the latest version (3.2.0) reached the registry 10 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv), Docker on your computer.

What can I use instead?

In the same category: OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

OpenSEO

Keyword research, site audits, rank tracking and AI visibility for your AI agent.

by every-appWidely used★ 28.2KUpdated 5 days ago

Runs in the cloud✓ everyapp.com

Exa

Connect AI agents to Exa for web search, content fetching, and multi-step research.

by exa-labsWidely used★ 5.2KUpdated 2 months ago

Runs in the cloud✓ service owner · exa.aiTried by the PopNx team

Microsoft Learn MCP

Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.

by MicrosoftDocsWidely used★ 2KUpdated 12 months ago

Runs in the cloud✓ service owner · microsoft.comTried by the PopNx team

Docs

Search and read Empryo's documentation. Read-only, no auth, no local access.

by proxysoulGrowing★ 1.6KUpdated 2 months ago

Runs in the cloud✓ empryo.com
Compared with similar ones
This one
Scholar MCP
OpenSEOExaMicrosoft Learn MCPDocsCOTAL actions (cotal.ai)
Runs whereInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyYesNoNoNoNoNo
Add with + in ClaudeNoYesYesYesNoNo
Basic checks3/35/52/44/44/44/4
LicenseMITMITMITCC-BY-4.0NOASSERTIONApache-2.0
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Scholar MCP

Scholarly papers, patents, books, standards and PDF conversion

[Documentation](https://pvliesdonk.github.io/scholar-mcp/) | [Config wizard](https://pvliesdonk.github.io/scholar-mcp/latest/reference/configuration-generator/) | [PyPI](https://pypi.org/project/pvliesdonk-scholar-mcp/) | [Docker](https://github.com/pvliesdonk/scholar-mcp/pkgs/container/scholar-mcp)

30 tools, organised by scholarly source type.

Source domains
  • Papers: full-text search with year/venue/field/citation filters; single-paper lookup by DOI, S2 ID, arXiv ID, ACM ID, or PubMed ID; author profile and name search; forward citations, backward references, BFS graph traversal, shortest-path bridge discovery; recommendations from positive/negative examples; BibTeX/CSL-JSON/RIS citation generation with OpenAlex venue enrichment.
  • Patents: search across 100+ patent offices via EPO OPS with CPC/applicant/inventor/jurisdiction filters; bibliographic, claims, description, family, legal, and citations sections; NPL-to-paper resolution via Semantic Scholar and paper-to-patent citation discovery. EPO credentials are optional; other domains work without them.
  • Books: Open Library search by title/author/keywords, no API key required; lookup by ISBN-10/13 or by Open Library work/edition ID; subject-based recommendations sorted by popularity; Google Books excerpts and preview links; WorldCat permalinks for library discovery; cover image caching. Papers with an ISBN in externalIds are automatically enriched with publisher, edition, cover URL, and subject data from Open Library.
  • Standards: identifier resolution, search, and metadata retrieval for NIST, IETF, W3C, and ETSI standards, with optional full-text fetch and Markdown conversion via docling. Tier 2 ISO, IEC, IEEE, Common Criteria (CC), and CEN/CENELEC metadata (including ISO/IEC/IEEE joint standards and the CC ↔ ISO/IEC 15408 cross-link) is synced locally via sync-standards. ISO, IEC, IEEE have a live-fetch fallback for unsynced identifiers; CC and CEN have no live API and require a sync first. Citations matching standards patterns (RFC, ISO, NIST SP, IEEE, EN, CC) are automatically enriched with structured standard_metadata including identifier, title, body, status, and full-text URL when available (see docs/use/standards.md).
Cross-cutting
  • Enrichment pipeline: phased enrichment from multiple sources: OpenAlex (OA status, affiliations, funders, concepts), CrossRef (publisher, page ranges, container titles), Google Books (preview links, excerpts), and Open Library (book metadata). Runs automatically on paper and book results.
  • PDF conversion: download open-access PDFs and convert to Markdown via docling-serve, with optional VLM enrichment for formulas and figures; automatic fallback to ArXiv, PubMed Central, and Unpaywall when Semantic Scholar has no OA link; direct URL download for PDFs found elsewhere; converted text is paged so large documents fit in MCP responses.
  • Uploads: a one-time upload link brings a PDF you downloaded yourself into the server's cache over HTTP.
  • Intelligent caching: SQLite-backed cache with per-table TTLs (30 days for papers/authors, 7 days for citations/references) and identifier aliasing.
Coverage by domain

Per-domain depth is uneven. Papers currently have the richest tool surface (citation graph, recommendations, cross-referencing to all three other domains); standards are the leanest. That reflects public data availability, not a value hierarchy: writing a paper typically needs all four source types for citations and prior art. Parity work is tracked in GitHub issues and milestones; the roadmap shows intent, not a completeness commitment.

Does it fit?

What the server can reach, what it changes and who gets in is set out in the security model; the block below says who it serves and where it stops.

With this server mounted in an MCP client (Claude, etc.), you can:

  • Survey a field: "Find the 20 most-cited papers on graph neural networks from 2020 to 2024 and draft a literature review outline." Composes search_papers + get_citations + enrich_paper.
  • Trace a citation path: "What's the shortest citation path from 'Attention is All You Need' to 'RLHF for dialogue agents'?" Uses find_bridge_papers + get_citation_graph.
  • Cross-reference prior art: "For this patent family, list academic papers it cites and any books or standards that show up in the description." Composes get_patent + batch_resolve + standards/book enrichment.
  • Generate a bibliography: "Emit BibTeX for these 30 DOIs with OpenAlex venue data." Uses generate_citations.
  • Look up a standard: "What's the latest status of RFC 9000, and fetch the Markdown full text." Uses resolve_standard_identifier + get_standard.

It reaches public scholarly metadata and open-access full text; it doesn't get past paywalls, and paywalled standards (ISO, IEC, IEEE) come back as metadata only. Patent tools need your own EPO OPS credentials.

Quick start

Pick the client you use. Each line installs the released version; the Get started tutorials carry on from there.

Claude Desktop. Download the .mcpb bundle from the releases page and open it with Claude Desktop (or Settings › Extensions › Advanced settings › Install Extension…). Claude Desktop asks for the required settings itself. Tutorial.

Claude Code. Two commands inside Claude Code; the second asks for a scope. Tutorial.

/plugin marketplace add pvliesdonk/claude-plugins

/plugin install scholar-mcp@pvliesdonk

A client that runs a command (stdio). To register it in Claude Code, see the Claude Code tutorial.

uv tool install "pvliesdonk-scholar-mcp"

scholar-mcp serve

A server for remote clients (streamable HTTP). A remote server connects the clients.

docker run --rm -p 8000:8000 --env-file .env ghcr.io/pvliesdonk/scholar-mcp:latest

A compose.yml ships at the repository root and runs as-is: copy .env.example to .env, then docker compose up -d. Deploy covers authentication, OIDC, a reverse proxy and system packages (.deb/.rpm on the releases page). The server answers /health and /health/ready outside the MCP mount, and its get_server_info tool reports the running version.

  • `[all]`: every production feature in one extra; the Linux packages and the Claude Desktop bundle install it.
  • `[debug]`: adds the remote debugger (debugpy); see Remote debugging.

The base package already carries FastMCP through fastmcp-pvl-core, so pip install pvliesdonk-scholar-mcp is enough to run scholar-mcp serve. The older [mcp] extra is kept so existing install commands keep working; it adds nothing beyond the base package.

Configuration

Everything is configured through environment variables with the SCHOLAR_MCP_ prefix. The ones most installs set:

VariableDefaultRequiredDescription
SCHOLAR_MCP_READ_ONLYtrueNoWhen true, write-tagged tools (PDF download and conversion cache writes) are hidden. Set false to enable them.
SCHOLAR_MCP_S2_API_KEY(none)NoSemantic Scholar API key. Optional but strongly recommended: a key has an introductory 1 req/s allowance; anonymous users share capacity and may be throttled. Request one at https://www.semanticscholar.org/product/api#api-key-form.
SCHOLAR_MCP_DOCLING_URL(none)NoBase URL of a running docling-serve instance for PDF conversion (such as http://localhost:5001). When unset, PDF conversion tools return an error.
SCHOLAR_MCP_CACHE_DIR/data/scholar-mcpNoDirectory for the SQLite cache database (cache.db) and downloaded PDFs (pdfs/, md/).
SCHOLAR_MCP_CONTACT_EMAIL(none)NoContact email for the OpenAlex polite pool (improves rate limits). Also enables Unpaywall lookups as a PDF fallback source.
SCHOLAR_MCP_OPENALEX_API_KEY(none)NoOpenAlex API key, sent as a Bearer token to OpenAlex only. Optional. Without a key, OpenAlex allows a smaller daily budget and fewer requests per second. Create one at https://openalex.org/settings/api-key.

Every variable the server reads, the shared ones included, is in the configuration reference; .env.example lists the same surface in copy-paste form, and the config wizard writes one for your deployment.

Documentation

  • Security model: what the server can reach, what it changes and who gets in.
  • Get started: a first success with your client.
  • Deploy: Docker, authentication, OIDC, reverse proxy.
  • Use: the features, for real tasks.
  • Reference: configuration, tools, resources, prompts, command line.
  • Upgrade: release channels,

Only the beginning is shown; read the rest in the repo