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.