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

> Connect Hermes to Lightsage MCP with a streamable HTTP MCP server config.

Hermes can connect to streamable HTTP MCP servers from its MCP server configuration. Use this guide to connect Hermes to the hosted Lightsage MCP endpoint.

<Steps>
  <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 Hermes">
    Add Lightsage MCP to your Hermes MCP configuration:

    ```yaml theme={null}
    mcp_servers:
      lightsage:
        url: https://mcp.lightsage.com/mcp
        headers:
          X-Lightsage-Api-Key: ${LIGHTSAGE_API_KEY}
        tools:
          resources: false
          prompts: false
    ```

    Hermes identifies a remote MCP server by the presence of `url`. There is no separate `transport` field.
  </Step>

  <Step title="Reload MCP">
    Reload MCP after changing the config:

    ```text theme={null}
    /reload-mcp
    ```

    Then run a read-only prompt:

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

See the [Hermes MCP guide](https://hermes-agent.nousresearch.com/docs/guides/use-mcp-with-hermes/) for config policy, tool filtering, and troubleshooting.
