Unpaywall MCP Server

Open-access availability for 120M+ scholarly articles via the Unpaywall API

Local serverstdioPython

What is the Unpaywall MCP server?

Unpaywall MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. Open-access availability for 120M+ scholarly articles via the Unpaywall API.

What you get

An MCP (Model Context Protocol) server for the Unpaywall API — open-access availability for 120M+ scholarly articles.

What the assistant can call

Once Unpaywall is connected, these are the calls the assistant has available:

  • unpaywall_lookup — Look up open-access availability by DOI — returns OA status, PDF/landing page URLs, license, all OA locations
  • unpaywall_search — Search 120M+ article titles with OA filtering and pagination
  • unpaywall_export_ris — Export results as RIS (for Zotero, EndNote, etc.)
  • unpaywall_export_bibtex — Export results as BibTeX

Configuration and credentials

You will need one environment variable: UNPAYWALL_EMAIL. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Setting it up

unpaywall-mcp-server on PyPI is all you need. Most clients run it directly, so configuration is a few lines and a restart.

Choosing this one

Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Unpaywall's toolset — unpaywall_lookup, unpaywall_search, unpaywall_export_ris and 1 more — is a fair guide to whether it matches your workflow. It is maintained by SMABoundless; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the unpaywall mcp server does with a few real requests.

Available tools

ToolWhat it does
unpaywall_lookupLook up open-access availability by DOI — returns OA status, PDF/landing page URLs, license, all OA locations
unpaywall_searchSearch 120M+ article titles with OA filtering and pagination
unpaywall_export_risExport results as RIS (for Zotero, EndNote, etc.)
unpaywall_export_bibtexExport results as BibTeX

How to install the Unpaywall MCP server

{
  "mcpServers": {
    "unpaywall": {
      "command": "uvx",
      "args": ["unpaywall-mcp-server"],
      "env": {
        "UNPAYWALL_EMAIL": "your-email@example.com"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
UNPAYWALL_EMAILConfiguration value read at startup.Optional

Example prompts to try

  • Use Unpaywall to unpaywall lookup.
  • Use Unpaywall to unpaywall search.
  • Use Unpaywall to unpaywall export ris.

Frequently asked questions

It connects Unpaywall to MCP-compatible AI assistants such as Claude and Cursor, exposing 4 tools (unpaywall_lookup, unpaywall_search, unpaywall_export_ris, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Unpaywall directly.