Semantic Scholar

Claude Code

1. Run this in a terminal, in your project folder:

claude mcp add --transport stdio semantic-scholar --env "SEMANTIC_SCHOLAR_API_KEY=<YOUR_SEMANTIC_SCHOLAR_API_KEY>" -- uvx s2-mcp-server

1. Start Claude Code and type /mcp. semantic-scholar should show as connected.

Add --scope user to make it available in every project. Replace the placeholders with your own values.

Claude Desktop

1. Open Settings → Developer → Edit Config. It opens claude_desktop_config.json. Add:

{
  "mcpServers": {
    "semantic-scholar": {
      "command": "uvx",
      "args": [
        "s2-mcp-server"
      ],
      "env": {
        "SEMANTIC_SCHOLAR_API_KEY": "<YOUR_SEMANTIC_SCHOLAR_API_KEY>"
      }
    }
  }
}

1. Save the file and restart Claude Desktop. Replace the placeholders with your own values.

Needs uv (Python) on your computer. The file lives in ~/Library/Application Support/Claude/ on macOS and %APPDATA%\Claude\ on Windows.

Cursor

Añadir a Cursor (se abre en una pestaña nueva)

Or add it by hand to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project):

{
  "mcpServers": {
    "semantic-scholar": {
      "command": "uvx",
      "args": [
        "s2-mcp-server"
      ],
      "env": {
        "SEMANTIC_SCHOLAR_API_KEY": "<YOUR_SEMANTIC_SCHOLAR_API_KEY>"
      }
    }
  }
}

Needs uv (Python) on your computer. Replace the placeholders with your own values.

VS Code

Add it to .vscode/mcp.json. VS Code asks for the secret the first time and stores it securely:

{
  "servers": {
    "semantic-scholar": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "s2-mcp-server"
      ],
      "env": {
        "SEMANTIC_SCHOLAR_API_KEY": "${input:semantic-scholar-api-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "semantic-scholar-api-key",
      "description": "SEMANTIC_SCHOLAR_API_KEY",
      "password": true
    }
  ]
}

Needs uv (Python) on your computer.

Devin Desktop

1. Add it to ~/.config/devin/mcp_config.json (macOS and Linux) or %APPDATA%\devin\mcp_config.json (Windows):

{
  "mcpServers": {
    "semantic-scholar": {
      "command": "uvx",
      "args": [
        "s2-mcp-server"
      ],
      "env": {
        "SEMANTIC_SCHOLAR_API_KEY": "<YOUR_SEMANTIC_SCHOLAR_API_KEY>"
      }
    }
  }
}

1. Refresh the MCP server list in Cascade. Replace the placeholders with your own values.

Devin Desktop is the new name for Windsurf.

Codex

codex mcp add semantic-scholar --env "SEMANTIC_SCHOLAR_API_KEY=<YOUR_SEMANTIC_SCHOLAR_API_KEY>" -- uvx s2-mcp-server

Or edit ~/.codex/config.toml directly:

[mcp_servers.semantic-scholar]
command = "uvx"
args = ["s2-mcp-server"]
env = { SEMANTIC_SCHOLAR_API_KEY = "<YOUR_SEMANTIC_SCHOLAR_API_KEY>" }

Needs uv (Python) on your computer. Replace the placeholders with your own values.

Gemini CLI

gemini mcp add -e "SEMANTIC_SCHOLAR_API_KEY=<YOUR_SEMANTIC_SCHOLAR_API_KEY>" semantic-scholar uvx s2-mcp-server

This adds it to the current project. Add -s user to use it everywhere.

Any client

Most clients that start local servers accept this shape:

{
  "mcpServers": {
    "semantic-scholar": {
      "command": "uvx",
      "args": [
        "s2-mcp-server"
      ],
      "env": {
        "SEMANTIC_SCHOLAR_API_KEY": "<YOUR_SEMANTIC_SCHOLAR_API_KEY>"
      }
    }
  }
}

Zed puts servers under context_servers in its settings, with the same command, args and env fields.

Needs uv (Python) on your computer. Replace the placeholders with your own values.

Insignia para README

[![Semantic Scholar on mcp.tc](https://mcp.tc/i/semantic-scholar/badge.svg)](https://mcp.tc/i/semantic-scholar)

<a href="https://mcp.tc/i/semantic-scholar"><img src="https://mcp.tc/i/semantic-scholar/badge.svg" alt="Semantic Scholar on mcp.tc" height="20"></a>

Sigue el modo claro u oscuro de quien lee. Añade ?theme=light o ?theme=dark para fijarlo, o ?style=compact para mostrar el símbolo sin la palabra.

Tarjeta para web

<script src="https://mcp.tc/w/semantic-scholar.js" async></script>

La tarjeta aparece donde esté la etiqueta. Añade data-theme="dark" o data-size="compact" a la etiqueta para cambiarla. El archivo contiene todo lo que necesita, así que no hace otras solicitudes ni instala cookies.

iframe

<iframe src="https://mcp.tc/embed/semantic-scholar" title="Semantic Scholar on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>

Úsalo en páginas que no permiten scripts. Añade ?theme=light o ?theme=dark a la dirección para fijar los colores.

JSON

La ficha como datos para tus propias páginas y herramientas: nombre, descripción corta, comando de instalación, herramientas y los enlaces «Add to». Cualquier web puede leerla (CORS abierto).

https://mcp.tc/i/semantic-scholar.json

Qué significa cada campo