Install Lightsage MCP in Pi

1

Get your Lightsage API key

Open the Lightsage dashboard and copy your API key.Do not put your API key in shared project config, screenshots, issue reports, or public repositories.

2

Install the Pi MCP extension

Install the MCP extension package:

pi install npm:pi-mcp-extension

3

Add Lightsage MCP and verify

Add Lightsage MCP to ~/.pi/agent/mcp.json or .pi/mcp.json. pi-mcp-extension does not expand ${VAR} references in config, so put the API key directly in the headers value:

{
  "mcpServers": {
    "lightsage": {
      "transport": "streamable-http",
      "url": "https://mcp.lightsage.com/mcp",
      "lifecycle": "eager",
      "headers": {
        "X-Lightsage-Api-Key": "ls_cli_your_api_key"
      }
    }
  }
}

Because the key is stored literally, keep this config on a private machine and out of shared repositories.Start Pi and use /mcp to check server status.Then run a read-only prompt:

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

Getting Started

Clients

Install Lightsage MCP in Pi