How do I install Lune?

Lune supports both local and remote installation. For local use, install it via npm (npx) and add the configuration to your AI app. For remote access, add the server URL to your MCP configuration.

What credentials does Lune need?

Lune requires the following credentials or environment variables: LUNE_API_KEY. You can find setup instructions on the server detail page.

What AI apps work with Lune?

Lune uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Lune MCP Server

by RetrogradeLabs

Developer ToolsLow Risk10.0MCP RegistryLocalRemote

Free

Server data from the Official MCP Registry

Search peer-reviewed papers and research methodology guidance from your AI agent.

About

Search peer-reviewed papers and research methodology guidance from your AI agent.

Remote endpoints: streamable-http: https://mcp.luneresearch.com/mcp

Security Report

10.0

Low Risk10.0Low Risk

Valid MCP server (3 strong, 1 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

6 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Lune personal access token. Generate one at https://luneresearch.com/dashboard/credentials.Required

Environment variable: LUNE_API_KEY

How to Install & Connect

Available as Local & Remote

This plugin can run on your machine or connect to a hosted endpoint. during install.

Documentation

View on GitHub

From the project's GitHub README.

@retrograde-labs/lune-mcp-server

Official Model Context Protocol server for Lune Research. Twelve tools for searching, retrieving, and subscribing to academic papers across security, ML, NLP, CV, and systems venues.

Two transports:

stdio: run locally via npx @retrograde-labs/lune-mcp-server. Reads LUNE_API_KEY from the environment.
Streamable HTTP: hosted at https://mcp.luneresearch.com/mcp. Pass your PAT or OAuth token as Authorization: Bearer ....

Get a token at luneresearch.com/dashboard/credentials.

Quick start

The fastest path is the dashboard installer: pick your AI app, click a button, and you're done. Manual installs follow.

Claude Code

claude mcp add lune --transport http \
  https://mcp.luneresearch.com/mcp \
  --header "Authorization: Bearer <YOUR_TOKEN>"

Claude Desktop, Cursor, VS Code, OpenCode, Codex, Gemini CLI, Windsurf, Zed

See the dashboard installer for per-client recipes verified against each client's official docs. The schemas vary subtly (e.g. VS Code uses type: "http", Cursor omits type, Gemini CLI uses httpUrl, Zed uses context_servers).

Tools

Tool	Description
`search_papers`	Hybrid vector + BM25 search across the corpus
`get_paper`	Fetch metadata for a paper
`get_paper_fulltext`	Parsed full text (markdown or JSON)
`get_paper_citations`	Citation graph (cited_by or cites)
`list_conferences`	Indexed venues, optionally by category
`get_conference_papers`	Paginated papers for a venue
`search_research_guidance`	Curated reproducibility / methodology corpus
`get_research_guidance_doc`	Full text of a guidance document
`list_conference_update_subscriptions`	Active conference update subscriptions
`subscribe_to_conference_updates`	Start receiving updates for a conference
`unsubscribe_from_conference_updates`	Stop receiving updates for a conference
`check_for_conference_updates`	Pull new papers since the last check

Authentication

The hosted Streamable HTTP transport at mcp.luneresearch.com/mcp supports both:

OAuth 2.1 + Dynamic Client Registration, advertised via https://mcp.luneresearch.com/.well-known/oauth-protected-resource. Authorization server is api.luneresearch.com. Clients (Claude Desktop, ChatGPT custom connectors) handle the flow automatically.
Personal Access Tokens (lune_*), passed as Authorization: Bearer .... Mint at luneresearch.com/dashboard/credentials.

MCP Registry

Published as com.luneresearch/lune at registry.modelcontextprotocol.io. DNS-authenticated under the luneresearch.com namespace.

Development

pnpm install
pnpm dev:watch        # tsup --watch
pnpm test
pnpm typecheck

Tests are unit + integration (tests/); no live network calls.

The hosted variant runs on ECS Fargate behind ALB. The npm-distributed binary (lune-mcp) is the same image entrypoint defaulting to stdio.

Releases

The npm package is built with tsup. Version is stamped into the bundle at build time from package.json via tsup.config.ts's define; the same version is asserted at serverInfo.version in the MCP initialize response and at /health.

License

MIT © Retrograde Labs

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

Lune MCP Server

About

Security Report

Findings (1)

Permissions Required

What You'll Need

How to Install & Connect

Documentation

@retrograde-labs/lune-mcp-server

Quick start

Claude Code

Claude Desktop, Cursor, VS Code, OpenCode, Codex, Gemini CLI, Windsurf, Zed

Tools

Authentication

MCP Registry

Development

Releases

License

Reviews

No reviews yet

More Developer Tools MCP Servers

Git

Toleno

mcp-creator-python

MarkItDown

mcp-creator-typescript

FinAgent