Quickstart - Lightsage

Use this quickstart to get from a Lightsage account to your first agent-ready task.

You will create an API key, choose how your agent connects to Lightsage, and confirm that you can fetch work with execution prompts.

Before you start

You need:

• A Lightsage organization with Visibility or API Performance data.
• Access to Settings > API Keys in the Lightsage dashboard.
• A terminal for the Lightsage CLI, or an agent that supports Lightsage MCP.

Create an API key

1. Open Settings > API Keys.
2. Click Create API key.
3. Copy the key when it appears.
4. Store it in your shell or secret manager.

export LIGHTSAGE_API_KEY="ls_cli_your_api_key"

API keys are shown once. Do not paste them into prompts or commit them to your repository.

Choose how to connect

Use the CLI when you want repeatable terminal commands or CI-friendly exports. Use MCP when you want an agent to fetch Lightsage context directly during a working session.

Fetch your first work item

Start with active daily tasks. Each task includes prompt context and a paste-ready execution_prompt for an agent.

curl "https://api.lightsage.com/v1/tasks?status=active" \
  -H "X-Lightsage-Api-Key: $LIGHTSAGE_API_KEY"

You can also list prompt opportunities directly:

curl "https://api.lightsage.com/v1/opportunities?limit=10" \
  -H "X-Lightsage-Api-Key: $LIGHTSAGE_API_KEY"

Next step

Use the workflow guide to hand those tasks or opportunities to a coding agent and schedule the resulting work.

Export Lightsage actionables, hand them to a coding agent, and schedule the work in your task system.