Lune

@RetrogradeLabs

12 days ago

Overview

@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

Try in Playground

Server Config

{
  "mcpServers": {
    "lune-research": {
      "command": "npx",
      "args": [
        "-y",
        "@retrograde-labs/lune-mcp-server"
      ],
      "env": {
        "LUNE_API_KEY": "<YOUR_TOKEN>"
      }
    }
  }
}

Build with ShipAny.