Lune Research developer resources

This is the canonical index for adding Lune to an AI app. Install the Lune connector or plugin in a web chatbot. Add the Lune MCP server to a local agent. These are the supported integration paths.

Once connected, the agent can turn a plain-English research question into a search across top-tier conference papers, with abstracts, metadata, citation context, and full text when available. It can also retrieve curated guidance for literature reviews, evaluation design, ablations, and venue selection.

Do not call Lune's underlying REST research endpoints directly or generate a custom client from the OpenAPI schema. The API exists for the official MCP server, dashboard, and command line app. Its contract remains public so those clients are inspectable and operational changes are documented.

Web chatbots

• Web AI app setup
• Lune Install page
• MCP Registry server manifest

Install the listed Lune connector or plugin when the app has one. Otherwise, add https://mcp.luneresearch.com as a custom connector. ChatGPT, Claude, and other compatible apps discover OAuth and ask the user to sign in.

Local agents

• Desktop and local agent setup
• Hosted MCP endpoint: https://mcp.luneresearch.com
• Published stdio MCP server on npm
• Official MCP Registry entry

Codex, Claude Code, Cursor, VS Code, and other MCP clients can use the hosted server or run the official stdio package locally. Once installed, Lune appears in the agent's regular tool list.

Command-line installer

• Lune CLI setup guide
• Official Lune CLI package on npm
• Install: npm install -g @retrograde-labs/lune-cli

Use lune install to configure a supported local agent and lune doctor to check the connection. The CLI also handles sign-in and account diagnostics. Run research tasks through the installed MCP tools inside the agent.

Authentication and permissions

• MCP authentication contract
• Scoped permissions
• OAuth authorization-server metadata

Compatible remote clients discover OAuth automatically. Local stdio installs can use a personal access token created by the user. Request only the scopes needed by the MCP tools the client enables.

Underlying service contract

The following files describe the service behind Lune's official clients. They are published for inspection, client generation inside this repository, and deprecation notices. They are not a supported third-party integration API.

• Lune Research REST service reference
• OpenAPI 3.1 JSON schema
• API versioning, deprecation, and rate limits

Every OpenAPI operation has a unique operationId, a summary, typed parameters, and documented success and error statuses. Operations with behavior that is not clear from the summary include a fuller description. JSON request and response payloads reference schemas. For streams, files, redirects, and empty responses, check the runtime Content-Type and HTTP status before decoding.

Discovery files

• llms.txt explains when an agent should use Lune and lists the public content index.
• auth.md gives MCP clients the complete credential flow.
• sitemap.xml lists public pages, conferences, and papers.
• Service status reports current reachability for the public MCP endpoint.