Install Lightsage MCP in Cursor

Cursor can connect to remote MCP servers from a global MCP config or a project-level MCP config. Use this guide to connect Cursor to the hosted Lightsage MCP endpoint.

Get your Lightsage API key

Open the Lightsage dashboard, copy your API key, and store it as LIGHTSAGE_API_KEY:

export LIGHTSAGE_API_KEY="ls_cli_your_api_key"

Do not put your API key in shared project config, screenshots, issue reports, or public repositories.

Add Lightsage MCP to Cursor

Add Lightsage MCP with the Cursor CLI:

cursor --add-mcp '{"name":"lightsage","url":"https://mcp.lightsage.com/mcp","headers":{"X-Lightsage-Api-Key":"${env:LIGHTSAGE_API_KEY}"}}'

You can also add Lightsage MCP to ~/.cursor/mcp.json for global access, or .cursor/mcp.json inside one project:

{
  "mcpServers": {
    "lightsage": {
      "url": "https://mcp.lightsage.com/mcp",
      "headers": {
        "X-Lightsage-Api-Key": "${env:LIGHTSAGE_API_KEY}"
      }
    }
  }
}

The CLI stores the same server under Cursor user settings.

Enable the server

Open Cursor Settings → Tools & Integrations → MCP tools and verify that lightsage is enabled.If you use Cursor Agent CLI in a headless environment, enable and verify the server from the project directory:

agent mcp enable lightsage
agent mcp list
agent mcp list-tools lightsage

Then run a read-only prompt:

Use the Lightsage MCP server to check my Lightsage auth status.

See the Cursor MCP docs for config locations and remote server authentication.

Getting Started

Clients

Install Lightsage MCP in Cursor