# Lightsage

## Quickstart
Set up Lightsage access, choose a client, and pull your first agent-ready work item.

## Migrate from Sapient to Lightsage
Update Sapient CLI, MCP, Public API, Agent Tracker, and Docs Agent integrations to their Lightsage names.

## Onboard your AI agent to Lightsage
Give your coding agent Lightsage skills, connected tools, workflows, and current documentation.

## Agent Skills
Install three Lightsage Agent Skills in a compatible coding agent.

## Lightsage MCP
Connect a compatible AI client to the hosted Lightsage MCP server.

## Lightsage CLI
Install the Lightsage CLI, authenticate your coding agent, and verify access.

## Workflows
Use repeatable prompts that help your coding agent act on Lightsage findings.

## Docs for agents
Give your AI agent current Lightsage documentation in a machine-readable format.

## Pull actionables into your agent
Copy a prompt that has your coding agent pull your Lightsage tasks and opportunities and ship fixes for them.

## Running evals
Create, fan out, monitor, and inspect coding-agent evals with the Lightsage CLI.

## Measure agent-attributed growth
Connect visits from recognized AI agent sources to sign-up, demo, checkout, and activation milestones in Agent Analytics.

## Google Cloud DNS integration
Set up Lightsage Agent Analytics for a domain managed in Google Cloud DNS by routing traffic through a Google load balancer and exporting request logs.

## Lightsage Docs Agent
Run Lightsage docs evals from GitHub pull requests before documentation changes ship.

## Run docs evals from GitHub
Use Lightsage slash commands on GitHub pull requests to run docs evals against staging documentation.

## CLI Reference
Install, authenticate, and navigate the Lightsage CLI.

## Visibility
Retrieve visibility metrics, citations, competitors, and prompt reports from the Lightsage CLI.

## Opportunities
List and retrieve ranked visibility opportunities from the Lightsage CLI.

## Tasks
Create, list, retrieve, and update daily tasks from the Lightsage CLI.

## Prompts
Create, list, retrieve, update, and delete Visibility prompts from the Lightsage CLI.

## Prompt topics
List and manage Visibility prompt topics from the Lightsage CLI.

## Prompt runs
List and retrieve stored prompt runs from the Lightsage CLI.

## Content
Generate drafts, finalize articles, and retrieve content from the Lightsage CLI.

## Site audits
Retrieve the latest website audit and inspect individual audited pages from the Lightsage CLI.

## Evals
Create and manage reusable coding-agent simulations from the Lightsage CLI.

## Eval runs
Start saved or direct eval runs and inspect their lifecycle state from the Lightsage CLI.

## Eval results
List and retrieve completed eval results from the Lightsage CLI.

## Agents
List available coding agents for eval runs from the Lightsage CLI.

## Repositories
Manage Git repository workspaces for eval configurations from the Lightsage CLI.

## Environments
List reusable runtime environments from the Lightsage CLI.

## MCP servers
List reusable MCP server integrations from the Lightsage CLI.

## CLIs
List reusable CLI tools from the Lightsage CLI.

## Skills
List reusable skills available to workflows and eval configurations from the Lightsage CLI.

## Install Lightsage MCP in ChatGPT
Connect ChatGPT developer mode to Lightsage MCP with a preconfigured public OAuth client.

## Install Lightsage MCP in Claude
Connect Claude hosted connector surfaces to Lightsage MCP with OAuth.

## Install Lightsage MCP in API Reference
Authenticate and call the Lightsage public API from your own integrations.

## Retrieve Current Visibility
Returns recommendation score, visibility score, ranks, and date-range metadata for the configured primary company. Metrics are computed from active prompts only; when no data exists, values are `null`.

## Retrieve Visibility Overview
Returns aggregate snapshot, daily trends, per-platform breakdowns, and competitor comparison. Calculated from active prompts only.

## List Top Cited Urls
Returns URL-level citation counts ranked from most to least cited. Results can be filtered by platform and to owned or external sources.

## Retrieve Prompt Visibility Report
Returns per-topic and per-prompt visibility metrics including recommendation score, rank, visibility score, average position, and citation counts.

## List Prompts
Returns active and inactive prompts by default. Set `include_archived` to include archived prompts.

## Create Prompts
Creates prompts in a batch. Each item is validated independently, so the response can contain both created prompts and individual errors.

## List Topics
Returns all prompt topics available to the organization.

## Create Topic
Creates a prompt topic and returns the saved topic.

## Update Topic
Renames a prompt topic and returns the updated topic.

## List Opportunities
Returns ranked opportunities computed from stored prompt visibility results. Each includes an `execution_prompt` with context for an AI agent. Default window is 30 days.

## List Agent Analytics Sites
Returns every site with tracked visits. Use a `site_id` from this list to read that site's agent traffic.

## Frequently asked questions about Lightsage
Answers to common questions about Lightsage's AEO platform, supported AI platforms, credit system, billing, and how to get started tracking your API.