# Lightsage

## Docs

- [Quickstart](https://lightsage.com/docs/index.md): Set up Lightsage access, choose a client, and pull your first agent-ready work item.
- [Migrate from Sapient to Lightsage](https://lightsage.com/docs/migration-guide.md): Update Sapient CLI, MCP, Public API, Agent Tracker, and Docs Agent integrations to their Lightsage names.
- [Pull actionables into your agent](https://lightsage.com/docs/workflows/pull-actionables-into-your-agent.md): Copy a prompt that has your coding agent pull your Lightsage tasks and opportunities and ship fixes for them.
- [Measure agent-attributed growth](https://lightsage.com/docs/agent-analytics/attributed-growth.md): Connect visits from recognized AI agent sources to sign-up, demo, checkout, and activation milestones in Agent Analytics.
- [Google Cloud DNS integration](https://lightsage.com/docs/agent-analytics/integrations/google-cloud-dns.md): 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](https://lightsage.com/docs/lightsage-docs-agent/overview.md): Run Lightsage docs evals from GitHub pull requests before documentation changes ship.
- [Run docs evals from GitHub](https://lightsage.com/docs/lightsage-docs-agent/github-pr-evals.md): Use Lightsage slash commands on GitHub pull requests to run docs evals against staging documentation.
- [CLI Reference](https://lightsage.com/docs/cli-reference/index.md): Install, authenticate, and navigate the Lightsage CLI.
- [Custom eval runs](https://lightsage.com/docs/cli-reference/eval-runs.md): Run custom evals, list executions, and inspect live run state and traces from the Lightsage CLI.
- [Prompts](https://lightsage.com/docs/cli-reference/prompts.md): Create, list, retrieve, update, and delete Visibility prompts from the Lightsage CLI.
- [Topics](https://lightsage.com/docs/cli-reference/prompt-topics.md): Create, update, and delete Visibility prompt topics from the Lightsage CLI.
- [Actions](https://lightsage.com/docs/cli-reference/prompt-actions.md): List prompt actionables, cited pages, and opportunities from the Lightsage CLI.
- [Runs](https://lightsage.com/docs/cli-reference/api-performance-runs.md): List API Performance eval runs, retrieve a run, and diagnose failures from the Lightsage CLI.
- [Targets](https://lightsage.com/docs/cli-reference/api-performance-targets.md): List API Performance text models, coding agents, and target objects from the Lightsage CLI.
- [Configuration](https://lightsage.com/docs/cli-reference/api-performance-config.md): Read and update API Performance evaluation configuration from the Lightsage CLI.
- [Sources](https://lightsage.com/docs/cli-reference/api-performance-sources.md): List API Performance sources and scheduled targets from the Lightsage CLI.
- [Skills](https://lightsage.com/docs/cli-reference/api-performance-skills.md): List API Performance skills from the Lightsage CLI.
- [Eval definitions](https://lightsage.com/docs/cli-reference/api-performance-evals.md): List, retrieve, and update API Performance eval definitions from the Lightsage CLI.
- [Custom eval definitions](https://lightsage.com/docs/cli-reference/api-performance-custom-evals.md): Create and manage custom API Performance eval definitions from the Lightsage CLI.
- [Starter projects](https://lightsage.com/docs/cli-reference/api-performance-starter-projects.md): Create and manage API Performance starter projects from the Lightsage CLI.
- [Actions](https://lightsage.com/docs/cli-reference/api-performance-actions.md): List, refresh, update, and verify API Performance actions from the Lightsage CLI.
- [Lightsage MCP](https://lightsage.com/docs/mcp-reference/index.md): Choose a client and connect Lightsage MCP to coding agents and MCP-capable tools.
- [Install Lightsage MCP in ChatGPT](https://lightsage.com/docs/mcp-reference/chatgpt.md): Connect ChatGPT developer mode to Lightsage MCP with a preconfigured public OAuth client.
- [Install Lightsage MCP in Claude](https://lightsage.com/docs/mcp-reference/claude.md): Connect Claude hosted connector surfaces to Lightsage MCP with OAuth.
- [Install Lightsage MCP in Claude Code](https://lightsage.com/docs/mcp-reference/claude-code.md): Connect Claude Code to Lightsage MCP with a remote HTTP server and the X-Lightsage-Api-Key header.
- [Install Lightsage MCP in Codex](https://lightsage.com/docs/mcp-reference/codex.md): Connect Codex to Lightsage MCP with a streamable HTTP server in config.toml.
- [Install Lightsage MCP in Cursor](https://lightsage.com/docs/mcp-reference/cursor.md): Connect Cursor to Lightsage MCP with a global or project MCP JSON config.
- [Install Lightsage MCP in Gemini CLI](https://lightsage.com/docs/mcp-reference/gemini-cli.md): Connect Gemini CLI to Lightsage MCP with a streamable HTTP MCP server.
- [Install Lightsage MCP in GitHub Copilot](https://lightsage.com/docs/mcp-reference/github-copilot.md): Connect GitHub Copilot to Lightsage MCP from VS Code or Copilot CLI.
- [Install Lightsage MCP in Kilo](https://lightsage.com/docs/mcp-reference/kilo.md): Connect Kilo to Lightsage MCP with a remote MCP server entry.
- [Install Lightsage MCP in OpenCode](https://lightsage.com/docs/mcp-reference/opencode.md): Connect OpenCode to Lightsage MCP with a remote MCP server entry.
- [API Reference](https://lightsage.com/docs/api-reference/introduction.md): Authenticate and call the Lightsage public API from your own integrations.
- [Get Status](https://lightsage.com/docs/api-reference/status/get-status.md)
- [Get Auth Status](https://lightsage.com/docs/api-reference/status/get-auth-status.md)
- [List Prompts](https://lightsage.com/docs/api-reference/prompts/list-prompts.md)
- [Create Prompts](https://lightsage.com/docs/api-reference/prompts/create-prompts.md)
- [Retrieve Prompt Config](https://lightsage.com/docs/api-reference/prompts/retrieve-prompt-config.md)
- [Create Topic](https://lightsage.com/docs/api-reference/prompts/create-topic.md)
- [Delete Topic](https://lightsage.com/docs/api-reference/prompts/delete-topic.md)
- [Update Topic](https://lightsage.com/docs/api-reference/prompts/update-topic.md)
- [Retrieve Prompt](https://lightsage.com/docs/api-reference/prompts/retrieve-prompt.md)
- [Delete Prompt](https://lightsage.com/docs/api-reference/prompts/delete-prompt.md)
- [Update Prompt](https://lightsage.com/docs/api-reference/prompts/update-prompt.md)
- [List Opportunities](https://lightsage.com/docs/api-reference/opportunities/list-opportunities.md): List prompt opportunities with execution prompts.
- [List Tasks](https://lightsage.com/docs/api-reference/tasks/list-tasks.md): List the persisted daily tasks for the organization.
- [Retrieve Task](https://lightsage.com/docs/api-reference/tasks/retrieve-task.md): Retrieve a single daily task and its execution prompt.
- [Update Task](https://lightsage.com/docs/api-reference/tasks/update-task.md): Update the status and delegation of a single daily task.
- [Create Eval Run](https://lightsage.com/docs/api-reference/eval-runs/create-eval-run.md): Start a durable eval run and return the parent job ID to poll.
- [Retrieve Eval Run](https://lightsage.com/docs/api-reference/eval-runs/retrieve-eval-run.md): Retrieve status and progress for a durable eval run.
- [Generate Content Draft](https://lightsage.com/docs/api-reference/content/generate-content-draft.md): Generate a draft marketing/blog article and save it as draft content.
- [Generate Content Final](https://lightsage.com/docs/api-reference/content/generate-content-final.md): Polish an existing draft into final, publish-ready content.
- [Get Content Endpoint](https://lightsage.com/docs/api-reference/content/get-content-endpoint.md): Retrieve a content record (title, markdown body, slug, status).
- [Retrieve Current Visibility](https://lightsage.com/docs/api-reference/visibility/retrieve-current-visibility.md): Retrieve current visibility metrics for the organization.
- [Retrieve Visibility Overview](https://lightsage.com/docs/api-reference/visibility/retrieve-visibility-overview.md): Retrieve the visibility overview for the organization.
- [Retrieve Prompt Visibility Report](https://lightsage.com/docs/api-reference/visibility/retrieve-prompt-visibility-report.md): Retrieve the prompt visibility report for the organization.
- [List Targets](https://lightsage.com/docs/api-reference/api-performance/list-targets.md)
- [List Eval Runs](https://lightsage.com/docs/api-reference/api-performance/list-eval-runs.md)
- [Retrieve Eval Run](https://lightsage.com/docs/api-reference/api-performance/retrieve-eval-run.md)
- [Diagnose Eval Runs](https://lightsage.com/docs/api-reference/api-performance/diagnose-eval-runs.md)
- [Retrieve Eval Config](https://lightsage.com/docs/api-reference/api-performance/retrieve-eval-config.md)
- [Update Eval Config](https://lightsage.com/docs/api-reference/api-performance/update-eval-config.md)
- [List Sources](https://lightsage.com/docs/api-reference/api-performance/list-sources.md)
- [List Skills](https://lightsage.com/docs/api-reference/api-performance/list-skills.md)
- [List Eval Definitions](https://lightsage.com/docs/api-reference/api-performance/list-eval-definitions.md)
- [Retrieve Eval Definition](https://lightsage.com/docs/api-reference/api-performance/retrieve-eval-definition.md)
- [Update Eval Definition](https://lightsage.com/docs/api-reference/api-performance/update-eval-definition.md)
- [List Custom Evals](https://lightsage.com/docs/api-reference/api-performance/list-custom-evals.md)
- [Create Custom Eval](https://lightsage.com/docs/api-reference/api-performance/create-custom-eval.md)
- [List Custom Eval History](https://lightsage.com/docs/api-reference/api-performance/list-custom-eval-history.md): List custom eval history rows for the organization.
- [Retrieve Custom Eval](https://lightsage.com/docs/api-reference/api-performance/retrieve-custom-eval.md)
- [Delete Custom Eval](https://lightsage.com/docs/api-reference/api-performance/delete-custom-eval.md)
- [Update Custom Eval](https://lightsage.com/docs/api-reference/api-performance/update-custom-eval.md)
- [List Starter Projects](https://lightsage.com/docs/api-reference/api-performance/list-starter-projects.md)
- [Create Starter Project](https://lightsage.com/docs/api-reference/api-performance/create-starter-project.md)
- [Retrieve Starter Project](https://lightsage.com/docs/api-reference/api-performance/retrieve-starter-project.md)
- [Delete Starter Project](https://lightsage.com/docs/api-reference/api-performance/delete-starter-project.md)
- [Update Starter Project](https://lightsage.com/docs/api-reference/api-performance/update-starter-project.md)
- [List Actions](https://lightsage.com/docs/api-reference/api-performance/list-actions.md)
- [Refresh Actions](https://lightsage.com/docs/api-reference/api-performance/refresh-actions.md)
- [Retrieve Action](https://lightsage.com/docs/api-reference/api-performance/retrieve-action.md)
- [Update Action](https://lightsage.com/docs/api-reference/api-performance/update-action.md)
- [Verify Action](https://lightsage.com/docs/api-reference/api-performance/verify-action.md)
- [Changelog](https://lightsage.com/docs/changelog.md): Developer-facing Lightsage CLI and public API changes.
- [How Lightsage credits work and how to estimate usage](https://lightsage.com/docs/account/credits.md): Learn how Lightsage credits work, what each platform type costs per run, and how to estimate your monthly usage before choosing a plan.
- [Frequently asked questions about Lightsage](https://lightsage.com/docs/account/faq.md): Answers to common questions about Lightsage's AEO platform, supported AI platforms, credit system, billing, and how to get started tracking your API.
- [Lightsage pricing: Free, Pro, and Enterprise plans](https://lightsage.com/docs/account/plans.md): Compare Free, Pro, and Enterprise plans to find the right fit for tracking and improving your API's visibility across AI coding agents.
- [AGENTS](https://lightsage.com/docs/AGENTS.md)
- [Agent Tracking: See Which AI Agents Visit Your Docs](https://lightsage.com/docs/features/agent-tracking.md): Add one line of middleware to detect AI coding agent visits to your website and documentation in real time, with zero performance impact.
- [API Performance: Benchmark How Agents Use Your API](https://lightsage.com/docs/features/api-performance.md): Benchmark how AI coding agents discover, call, and execute your API endpoints. See letter grades, per-endpoint pass rates, and actionable fixes across agents.
- [Opportunities Engine: AI-Powered Visibility Insights](https://lightsage.com/docs/features/opportunities-engine.md): Automatically surface competitor gaps, quick wins, content opportunities, and technical fixes ranked by impact and effort across your AI visibility data.
- [Visibility Analytics: Track Your AI Brand Presence](https://lightsage.com/docs/features/visibility-analytics.md): Monitor your brand mention rate, share of voice, and average position across 17 AI platforms—including coding agents, answer engines, and frontier models.
- [Detect AI agent visits with agent tracking middleware](https://lightsage.com/docs/guides/agent-tracking-middleware.md): Install Lightsage's lightweight middleware on Next.js, Vercel, Cloudflare, Express, Astro, or Netlify to detect coding agent visits to your docs in real time.
- [Add llms.txt to improve coding agent discoverability](https://lightsage.com/docs/guides/llms-txt.md): Create a machine-readable API description at your domain root to give coding agents immediate context about what your API does and how to make their first call.
- [Build an MCP server for direct coding agent access](https://lightsage.com/docs/guides/mcp-servers.md): Learn what the Model Context Protocol is, what makes a high-scoring MCP server, and how to submit your server to Devtool Arena for public benchmarking.
- [Optimize your API for AI coding agent discovery](https://lightsage.com/docs/guides/optimize-for-agents.md): Work through the 4-layer coding agent decision stack — training data, web search, context retrieval, and tool execution — to boost your recommendation rate.
- [How to track coding agent recommendations for your API](https://lightsage.com/docs/guides/track-coding-agents.md): Learn which metrics matter for coding agent tracking, how to define implementation prompts in Lightsage, establish baselines, and read your dashboard effectively.
- [What is Lightsage? AI Engine Optimization for APIs](https://lightsage.com/docs/introduction.md): Lightsage tracks how AI coding agents discover and use your API across 17 platforms — so you can close the gap where developer adoption actually happens.
- [Key concepts: Lightsage terminology and metrics explained](https://lightsage.com/docs/key-concepts.md): Definitions for every term you'll encounter in Lightsage — from GEO and AEO to Visibility Score, API Performance, credits, llms.txt, and MCP.
- [Devtool Arena changelog: scores, companies, categories](https://lightsage.com/docs/leaderboard/changelog.md): A running record of all notable changes to the Devtool Arena leaderboard: new companies, new categories, new leaderboard types, and ranking updates.
- [Devtool Arena: the coding agent API leaderboard](https://lightsage.com/docs/leaderboard/overview.md): Devtool Arena is a free, public leaderboard benchmarking 85+ developer tools against AI coding agents across API, CLI, and MCP evaluation types.
- [How Devtool Arena scores are calculated](https://lightsage.com/docs/leaderboard/scoring.md): Learn how Eval Score and Discovery Score combine into an overall score, what the A–D grade thresholds mean, and what the checklist columns measure.
- [Submit your API to Devtool Arena for evaluation](https://lightsage.com/docs/leaderboard/submit-api.md): Learn how to submit your API or developer tool for a live Devtool Arena evaluation, what the process covers, and how to maximize your score before submitting.
- [Install Lightsage MCP in Hermes](https://lightsage.com/docs/mcp-reference/hermes.md): Connect Hermes to Lightsage MCP with a streamable HTTP MCP server config.
- [Install Lightsage MCP in Microsoft Copilot](https://lightsage.com/docs/mcp-reference/microsoft-copilot.md): Connect Lightsage MCP to Microsoft Copilot Studio agents.
- [Install Lightsage MCP in OpenClaw](https://lightsage.com/docs/mcp-reference/openclaw.md): Save Lightsage MCP in OpenClaw's MCP server registry.
- [Install Lightsage MCP in Perplexity](https://lightsage.com/docs/mcp-reference/perplexity.md): Connect Perplexity custom remote MCP connectors to Lightsage MCP.
- [Install Lightsage MCP in Pi](https://lightsage.com/docs/mcp-reference/pi.md): Connect Pi to Lightsage MCP with pi-mcp-extension.
- [Quickstart: get your first API evaluation in 10 min](https://lightsage.com/docs/quickstart.md): Create a free Lightsage account, add your API, run your first evaluation, and install agent tracking middleware to start measuring AI visibility.

## OpenAPI Specs

- [openapi](https://lightsage.com/docs/openapi.yml)