@lightspot/mcp

MCP server for LightSpot.ai — run SEO & GEO audits and read their results 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 → Settings → API. API access is available on the Business and Enterprise 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:

{
  "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

| Variable | Required | Description | | --- | --- | --- | | LIGHTSPOT_API_KEY | yes | Your API key (lspai_live_…). | | LIGHTSPOT_BASE_URL | no | Override the API base URL (defaults to https://lightspot.ai). For self-hosted/testing only. |

Tools

| Tool | What it does | | --- | --- | | audit_and_wait | Run 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_audit | Start an audit without waiting (returns the audit id). | | get_audit_status | Lightweight status of an audit (PENDING/RUNNING/DONE/FAILED + progress 0–1). | | get_audit | Audit results — a trimmed summary by default, or the full payload with full: true. | | list_sites | List the sites on your account (with their latest score). | | get_site | A site's metadata and recent audits. | | list_site_audits | A site's paginated audit history. |

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."

Notes

• Quotas (audits/month, pages/audit) and per-key rate limits follow your LightSpot plan.
• The full REST API reference lives at lightspot.ai/docs/api.

License

MIT