{"id":"07da5e80-0981-408a-94ad-0abdbd4711d0","slug":"lightspot-mcp","kind":"mcp","name":"lightspot-mcp","summary":"MCP server for LightSpot: audit a website for SEO and AI search visibility (ChatGPT, Perplexity, Gemini) from any MCP client.","owner":"nmarijane","repoUrl":"https://github.com/nmarijane/lightspot-mcp","license":"MIT","licenseTier":"permissive","trust":"community","stars":0,"match":null,"fewStars":true,"format":"mcp","createdAt":"2026-09-29T18:20:36.000Z","addedAt":"2026-10-14T05:51:07.705Z","logoUrl":"https://avatars.githubusercontent.com/u/24276702?u=fae6bd72fa18db5fa1c109e974e055cbae012a68&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["search","cloud-infra","writing"],"tags":["ai-search","generative-engine-optimization","geo","seo"],"runtime":"node","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":true,"reviewed":false,"syncedAt":"2026-10-17T17:34:49.492Z","sample":false,"url":"https://conduits.dev/tools/lightspot-mcp","language":"TypeScript","transports":["stdio"],"install":{"npm":"@lightspot/mcp"},"requirements":{"env":[{"name":"LIGHTSPOT_API_KEY","secret":true,"required":true,"description":"LightSpot API key (lspai_live_…), created in the LightSpot app"},{"name":"LIGHTSPOT_BASE_URL","secret":false,"required":false,"description":"Optional API base URL, defaults to https://lightspot.ai"}],"upstreamMayCharge":false},"tools":null,"readme":"# @lightspot/mcp\n\n[![M8ven Score](https://m8ven.ai/badge/mcp/nmarijane-lightspot-mcp-1m6lay)](https://m8ven.ai/mcp/nmarijane-lightspot-mcp-1m6lay?s=readme)\n\nMCP server for [LightSpot.ai](https://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, …).\n\nIt 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.\n\n## Requirements\n\n- A LightSpot **API key** (`lspai_live_…`) — create one in **LightSpot → Integrations → API keys**. API access is included in the **Eclat** and **Zenith** plans.\n- Node.js ≥ 18 (run on demand via `npx`, nothing to install globally).\n\n## Setup\n\nAdd the server to your MCP client config and set your API key:\n\n```json\n{\n  \"mcpServers\": {\n    \"lightspot\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@lightspot/mcp\"],\n      \"env\": {\n        \"LIGHTSPOT_API_KEY\": \"lspai_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"\n      }\n    }\n  }\n}\n```\n\n- **Claude Desktop** → `claude_desktop_config.json`\n- **Claude Code** → `claude mcp add` or your project's `.mcp.json`\n- **Cursor** → `~/.cursor/mcp.json`\n\n### Environment variables\n\n| Variable | Required | Description |\n| --- | --- | --- |\n| `LIGHTSPOT_API_KEY` | yes | Your API key (`lspai_live_…`). |\n| `LIGHTSPOT_BASE_URL` | no | Override the API base URL (defaults to `https://lightspot.ai`). For self-hosted/testing only. |\n\n### Claude plugin\n\nThe [`plugin/`](plugin) folder packages this server as a Claude plugin: it pins `@lightspot/mcp`, asks for your API key once and stores it in your system's secure credential store, and adds an `ai-visibility-audit` skill. See [`plugin/README.md`](plugin/README.md).\n\n## Tools\n\n| Tool | What it does |\n| --- | --- |\n| `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.\" |\n| `run_audit` | Start an audit without waiting (returns the audit id). |\n| `get_audit_status` | Lightweight status of an audit (`PENDING`/`RUNNING`/`DONE`/`FAILED` + progress 0–1). |\n| `get_audit` | Audit results — a trimmed summary by default, or the full payload with `full: true`. |\n| `list_sites` | List the sites in your team (with their latest score). |\n| `get_site` | A site's metadata and recent audits. |\n| `list_site_audits` | A site's paginated audit history. |\n| `get_competitors` | Get a site's latest competitor analysis (detected competitors, tiers, citations, recommendations). Read-only — does not trigger a new analysis. Requires the Zenith plan. |\n| `get_expert_report` | Read 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. |\n| `get_editorial_calendar` | Read a site's calendar over an ISO date range, including imported slots and content already preparing, scheduled, or published. |\n| `create_editorial_calendar` | Import or update up to 50 dated editorial slots. Idempotent with `externalId`; it does not generate or publish content. |\n\n## Example prompts\n\n- \"Audit https://example.com and give me the top 3 things to fix for AI visibility.\"\n- \"List my LightSpot sites and which one has the lowest score.\"\n- \"Get the full results for audit `<id>` and group the issues by severity.\"\n- \"What competitors were detected for my site `<siteId>`, and what should I do about them?\"\n- \"Read the experts' report for my site `<siteId>` and fix what the structured-data expert recommends in my codebase.\"\n- \"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.\"\n- \"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.\"\n\n## Notes\n\n- Quotas (audits/month, pages/audit) and per-key rate limits follow your LightSpot plan.\n- Importing editorial slots does not consume AI credits and never generates, schedules, or publishes content automatically.\n- The full REST API reference lives at [lightspot.ai/docs/api](https://lightspot.ai/docs/api).\n\n## License\n\nMIT\n"}