LightSpot MCP server

@lightspot/mcp

MCP server for LightSpot.ai — run SEO & GEO 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 (lspailive…) — create one in LightSpot → Integrations → API keys. API access is included in the Zenith plan.
• 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:

{
  "mcpServers": {
    "lightspot": {
      "command": "npx",
      "args": ["-y", "@lightspot/mcp"],
      "env": {
        "LIGHTSPOT_API_KEY": "lspai_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

• Claude Desktop → claudedesktopconfig.json
• Claude Code → claude mcp add or your project's .mcp.json
• Cursor → ~/.cursor/mcp.json

Environment variables

Tools

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 and group the issues by severity."
• "What competitors were detected for my site , and what should I do about them?"
• "Read the experts' report for my site and fix what the structured-data expert recommends in my codebase."
• "Create a four-week editorial calendar for my site with two LinkedIn posts and one educational Reddit post per week, then import it into LightSpot."
• "Show me everything planned or published for site between 2026-08-01T00:00:00+02:00 and 2026-09-01T00:00:00+02:00."

Notes

Shortened. The full README is on GitHub.