Lune

SSE

by RetrogradeLabs

1.4k downloads Not rated yet

GitHub Website SSE

About

# @retrograde-labs/lune-mcp-server  [![npm](https://img.shields.io/npm/v/@retrograde-labs/lune-mcp-server.svg)](https://www.npmjs.com/package/@retrograde-labs/lune-mcp-server) [![MCP…

Details

Transport: SSE

Explore

- Twelve tools for paper search, retrieval, citation, and conference updates
- Hybrid vector + BM25 search across the academic paper corpus
- Streamable HTTP and stdio transports
- OAuth 2.1 and Personal Access Token authentication
- Published in MCP Registry as com.luneresearch/lune

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Lune

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

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

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.

`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

| 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 |

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

@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

Authentication

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

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

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Explore

Setting up with Highlight

From the repository

search_papers

get_paper

get_paper_fulltext

get_paper_citations

list_conferences

get_conference_papers

search_research_guidance

get_research_guidance_doc

list_conference_update_subscriptions

subscribe_to_conference_updates

unsubscribe_from_conference_updates

check_for_conference_updates

Claude Desktop / Cursor

McpServers

@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

More like this

Sequential Thinking

Aws Kb Retrieval Server

Memory

Brave Search

`search_papers`

`get_paper`

`get_paper_fulltext`

`get_paper_citations`

`list_conferences`

`get_conference_papers`

`search_research_guidance`

`get_research_guidance_doc`

`list_conference_update_subscriptions`

`subscribe_to_conference_updates`

`unsubscribe_from_conference_updates`

`check_for_conference_updates`