LightSpot

io.github.nmarijanePublished by GitHub account nmarijanev0.6.0Updated Nov 8, 2026

Audit a website for SEO and AI search visibility (ChatGPT, Perplexity, Gemini) and read the fixes.

The publisher's own server: Spot

Overview

AI-generated overview

Runs LightSpot SEO and AI-visibility audits on a website and returns scores, issues, expert reports and competitor analysis to an assistant.

What you can do
  • Run audits on a URL, either waiting for the result or starting one and polling its status
  • Read audit results as a trimmed summary or the full payload, and browse a site's audit history
  • List team sites with their latest scores and view site metadata
  • Read competitor analysis and the latest expert report, by chapter or in full
  • Read and import dated editorial calendar slots for a site
When to use it
Useful when you want an assistant to audit a site's SEO and AI search visibility, explain why assistants such as ChatGPT or Perplexity may not cite it, and turn the findings into concrete fixes or an editorial plan.
Requirements
Runs locally via npx, so Node.js 18 or newer is needed. Requires a LightSpot API key in the LIGHTSPOT_API_KEY environment variable, created in the LightSpot app; API access is included in the Eclat, Halo and Zenith plans. An optional LIGHTSPOT_BASE_URL overrides the API endpoint. Network access to LightSpot is required.
Before you install
The API key is a secret passed in the environment; keep it out of shared configs. Audits count against your plan's monthly quotas and per-key rate limits, and some tools require the Halo or Zenith plan. Importing editorial slots writes data to your LightSpot account, though it does not generate, schedule or publish content. Site URLs and audit data are sent to LightSpot's API.

Installation

In SourceWeft

  1. Open LightSpot in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@lightspot/mcp

[M8ven Score]

MCP server for LightSpot.ai — run SEO and AI-visibility audits, read their results and our experts' reports, and import editorial calendars from any MCP client (Claude Desktop, Claude Code, Cursor, …).

It wraps the LightSpot public API (/v1) as MCP tools, so an AI assistant can "audit this site and tell me why ChatGPT doesn't cite it" in one step.

Requirements

  • A LightSpot API key (lspai_live_…) — create one in LightSpot → Integrations → API keys. API access is included in the Eclat, Halo and Zenith plans.
  • Node.js ≥ 18 (run on demand via npx, nothing to install globally).

Setup

Add the server to your MCP client config and set your API key:

json
{  "mcpServers": {    "lightspot": {      "command": "npx",      "args": ["-y", "@lightspot/mcp"],      "env": {        "LIGHTSPOT_API_KEY": "lspai_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"      }    }  }}
  • Claude Desktop → claude_desktop_config.json
  • Claude Code → claude mcp add or your project's .mcp.json
  • Cursor → ~/.cursor/mcp.json

Environment variables

VariableRequiredDescription
LIGHTSPOT_API_KEYyesYour API key (lspai_live_…).
LIGHTSPOT_BASE_URLnoOverride the API base URL (defaults to https://lightspot.ai). For self-hosted/testing only.

Claude plugin

The plugin/ folder is the Claude plugin. It connects Claude to LightSpot's hosted MCP server (https://mcp.lightspot.ai/mcp, same tools, OAuth sign-in instead of an API key) and adds an ai-visibility-audit skill. See plugin/README.md.

Tools

ToolWhat it does
audit_and_waitRun an audit on a URL, wait for it to finish, and return a summary (score, top actions, main issues). The one-shot "audit this and tell me what's wrong."
run_auditStart an audit without waiting (returns the audit id).
get_audit_statusLightweight status of an audit (PENDING/RUNNING/DONE/FAILED + progress 0–1).
get_auditAudit results — a trimmed summary by default, or the full payload with full: true.
list_sitesList the sites in your team (with their latest score).
get_siteA site's metadata and recent audits.
list_site_auditsA site's paginated audit history.
get_competitorsGet a site's latest competitor analysis (detected competitors, tiers, citations, recommendations). Read-only — does not trigger a new analysis. Requires the Halo or Zenith plan.
get_expert_reportRead the latest report from our 8 experts (technical SEO, content, AI visibility, structured data, sitemaps, performance, visual, brand authority) for a site or a given audit: prioritized findings, recommended actions with steps, limitations and ready-to-apply artifacts. Summary by default, full: true for everything, expert to read one chapter. Read-only — does not trigger an analysis.
get_editorial_calendarRead a site's calendar over an ISO date range, including imported slots and content already preparing, scheduled, or published.
create_editorial_calendarImport or update up to 50 dated editorial slots. Idempotent with externalId; it does not generate or publish content.

Example prompts

  • "Audit https://example.com and give me the top 3 things to fix for AI visibility."
  • "List my LightSpot sites and which one has the lowest score."
  • "Get the full results for audit <id> and group the issues by severity."
  • "What competitors were detected for my site <siteId>, and what should I do about them?"
  • "Read the experts' report for my site <siteId> and fix what the structured-data expert recommends in my codebase."
  • "Create a four-week editorial calendar for my site <siteId> with two LinkedIn posts and one educational Reddit post per week, then import it into LightSpot."
  • "Show me everything planned or published for site <siteId> between 2026-08-01T00:00:00+02:00 and 2026-09-01T00:00:00+02:00."

Notes

  • Quotas (audits/month, pages/audit) and per-key rate limits follow your LightSpot plan.
  • Importing editorial slots does not consume AI credits and never generates, schedules, or publishes content automatically.
  • The full REST API reference lives at lightspot.ai/docs/api.

License

MIT

Source: README.md at commit cbbda32

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

3
  1. v0.6.0LatestOct 4, 2026
  2. v0.5.1Oct 3, 2026
  3. v0.5.0Oct 3, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Spot integrations