> ## Documentation Index
> Fetch the complete documentation index at: https://lightsage.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Install Lightsage MCP in OpenClaw

> Save Lightsage MCP in OpenClaw's MCP server registry.

OpenClaw can save remote MCP server definitions in its MCP registry. Use this guide to connect OpenClaw-managed runtimes to the hosted Lightsage MCP endpoint.

<Steps>
  <Step title="Confirm MCP registry support">
    Confirm your OpenClaw build includes the MCP registry commands:

    ```bash theme={null}
    openclaw mcp --help
    ```

    The help output should include commands such as `set`, `status`, and `doctor`. If it only prints the top-level OpenClaw help, update OpenClaw or use another MCP client until your build includes the registry commands.
  </Step>

  <Step title="Get your Lightsage API key">
    Open the [Lightsage dashboard](https://app.lightsage.com/settings/api), copy your API key, and store it as `LIGHTSAGE_API_KEY`:

    ```bash theme={null}
    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.
  </Step>

  <Step title="Add Lightsage MCP to OpenClaw">
    Save Lightsage as a streamable HTTP MCP server:

    ```bash theme={null}
    openclaw mcp set lightsage "{\"url\":\"https://mcp.lightsage.com/mcp\",\"transport\":\"streamable-http\",\"headers\":{\"X-Lightsage-Api-Key\":\"${LIGHTSAGE_API_KEY}\"}}"
    ```

    Or write the JSON explicitly if you are editing a private local config:

    ```bash theme={null}
    openclaw mcp set lightsage '{"url":"https://mcp.lightsage.com/mcp","transport":"streamable-http","headers":{"X-Lightsage-Api-Key":"ls_cli_your_api_key"}}'
    ```

    Use direct JSON only on a private machine. Avoid committing literal API keys.
  </Step>

  <Step title="Verify OpenClaw tools">
    Run the OpenClaw static and live checks:

    ```bash theme={null}
    openclaw mcp status --verbose
    openclaw mcp doctor lightsage --probe
    ```

    Then run a read-only prompt in an OpenClaw runtime that uses the MCP registry:

    ```text theme={null}
    Use the Lightsage MCP server to check my Lightsage auth status.
    ```
  </Step>
</Steps>

See the [OpenClaw MCP docs](https://docs.openclaw.ai/cli/mcp) for registry commands, live probes, OAuth, and streamable HTTP options.
