{"_id":"@bmhall2/skylight-mcp","_rev":"5-ed44e11643744de1033632b5085b3a6d","name":"@bmhall2/skylight-mcp","dist-tags":{"latest":"1.1.11"},"versions":{"1.1.7":{"name":"@bmhall2/skylight-mcp","version":"1.1.7","keywords":["mcp","skylight","calendar","model-context-protocol","claude","ai","family","chores"],"author":{"name":"Ben Hall","email":"bmhall2@gmail.com"},"license":"MIT","_id":"@bmhall2/skylight-mcp@1.1.7","maintainers":[{"name":"bmhall2","email":"bmhall2@gmail.com"}],"homepage":"https://github.com/bmhall2/skylight-mcp#readme","bugs":{"url":"https://github.com/bmhall2/skylight-mcp/issues"},"bin":{"skylight-mcp":"dist/index.js"},"dist":{"shasum":"00483e159e22625510c75601ab2ec1ca6829028e","tarball":"https://registry.npmjs.org/@bmhall2/skylight-mcp/-/skylight-mcp-1.1.7.tgz","fileCount":119,"integrity":"sha512-vV2wiDaGl+8zkOzYGzCz37XAWHBPELJaLOcmAyzML7m2nSjuURjRBOrKVB6kCQxU29gkRRO0zDzBlL11BShKbA==","signatures":[{"sig":"MEYCIQDJ4rdTjfuysmhWi209VptawQb6Qdh+Dqs5MMjqy44jXgIhANQY+uhMtKq6BMnKicfPl8XDmPvfQyuPIR6Xu68FSvKE","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1349103},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"c32284e1e75dcba02827fc77e01ea5dc4595e99e","scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src/","test":"vitest","build":"tsc","start":"node dist/index.js","prepare":"npm run build","typecheck":"tsc --noEmit","test:coverage":"vitest --coverage","generate:types":"openapi-typescript ../skylight-api/docs/openapi/openapi.yaml -o src/api/generated-types.ts"},"_npmUser":{"name":"bmhall2","email":"bmhall2@gmail.com"},"repository":{"url":"git+https://github.com/bmhall2/skylight-mcp.git","type":"git"},"_npmVersion":"10.9.3","description":"MCP server for Skylight Calendar API - enables agentic interactions for calendar, chores, lists, and family management","directories":{},"_nodeVersion":"22.20.0","dependencies":{"zod":"^3.24.1","@modelcontextprotocol/sdk":"^1.11.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","eslint":"^8.57.0","vitest":"^1.6.0","typescript":"^5.4.5","@types/node":"^20.12.2","openapi-typescript":"^7.0.0","@typescript-eslint/parser":"^7.0.0","@typescript-eslint/eslint-plugin":"^7.0.0"},"_npmOperationalInternal":{"tmp":"tmp/skylight-mcp_1.1.7_1776039590643_0.06190716035811561","host":"s3://npm-registry-packages-npm-production"}},"1.1.8":{"name":"@bmhall2/skylight-mcp","version":"1.1.8","keywords":["mcp","skylight","calendar","model-context-protocol","claude","ai","family","chores"],"author":{"name":"Ben Hall","email":"bmhall2@gmail.com"},"license":"MIT","_id":"@bmhall2/skylight-mcp@1.1.8","maintainers":[{"name":"bmhall2","email":"bmhall2@gmail.com"}],"homepage":"https://github.com/bmhall2/skylight-mcp#readme","bugs":{"url":"https://github.com/bmhall2/skylight-mcp/issues"},"bin":{"skylight-mcp":"dist/index.js"},"dist":{"shasum":"48db19c1f67a3e8d0c3a25175962c9dd2395ff15","tarball":"https://registry.npmjs.org/@bmhall2/skylight-mcp/-/skylight-mcp-1.1.8.tgz","fileCount":119,"integrity":"sha512-fn5StW0cojqoOk+F4I8xPj5458BY/QTD76ZgQyMpVuVN+wBuC31g09KnvMThzXd2fZ9kZ2CTUw8m5uO3+tNHnA==","signatures":[{"sig":"MEYCIQCbMx30qV91dOXggLub1+q659rDWnkdVEZGVRe7XIMzmwIhAJZsIdkT8x/pl3pdrN83mQku7qVcC3MxT3Elw8oC9pBs","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bmhall2%2fskylight-mcp@1.1.8","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":1348159},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"072f5a36a77e6f332f136a3c5c2f019cdecf67a3","scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src/","test":"vitest","build":"tsc","start":"node dist/index.js","prepare":"npm run build","typecheck":"tsc --noEmit","test:coverage":"vitest --coverage","generate:types":"openapi-typescript ../skylight-api/docs/openapi/openapi.yaml -o src/api/generated-types.ts"},"_npmUser":{"name":"bmhall2","email":"bmhall2@gmail.com"},"repository":{"url":"git+https://github.com/bmhall2/skylight-mcp.git","type":"git"},"_npmVersion":"10.9.7","description":"MCP server for Skylight Calendar API - enables agentic interactions for calendar, chores, lists, and family management","directories":{},"_nodeVersion":"22.22.2","dependencies":{"zod":"^3.24.1","@modelcontextprotocol/sdk":"^1.11.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","eslint":"^8.57.0","vitest":"^1.6.0","typescript":"^5.4.5","@types/node":"^20.12.2","openapi-typescript":"^7.0.0","@typescript-eslint/parser":"^7.0.0","@typescript-eslint/eslint-plugin":"^7.0.0"},"_npmOperationalInternal":{"tmp":"tmp/skylight-mcp_1.1.8_1776042589254_0.9544058448142267","host":"s3://npm-registry-packages-npm-production"}},"1.1.9":{"name":"@bmhall2/skylight-mcp","version":"1.1.9","keywords":["mcp","skylight","calendar","model-context-protocol","claude","ai","family","chores"],"author":{"name":"Ben Hall","email":"bmhall2@gmail.com"},"license":"MIT","_id":"@bmhall2/skylight-mcp@1.1.9","maintainers":[{"name":"bmhall2","email":"bmhall2@gmail.com"}],"homepage":"https://github.com/bmhall2/skylight-mcp#readme","bugs":{"url":"https://github.com/bmhall2/skylight-mcp/issues"},"bin":{"skylight-mcp":"dist/index.js"},"dist":{"shasum":"9777ff7e065e5f14aadc3113b5700bcc23fe89da","tarball":"https://registry.npmjs.org/@bmhall2/skylight-mcp/-/skylight-mcp-1.1.9.tgz","fileCount":119,"integrity":"sha512-FxEw9J/Eh23Xvxc2IiAo3d5h1pPk6WbUtiYb3J5apLJRHs3K6l1M8Y6wB7d7d6gHhMRfzSYhWDoiEe9PLHZmng==","signatures":[{"sig":"MEYCIQDMi3kcqU9ily+eMb2AIlT9h68gquYmwiQRFkcvt+wDeQIhAJ+5aycan46uDQ0OZ5bpUpriouGoxYrTcKCxwQurjzcS","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bmhall2%2fskylight-mcp@1.1.9","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":1348234},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"73635aa813f76b6ca5e5d9e0f0f64895140769c7","scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src/","test":"vitest","build":"tsc","start":"node dist/index.js","prepare":"npm run build","typecheck":"tsc --noEmit","test:coverage":"vitest --coverage","generate:types":"openapi-typescript ../skylight-api/docs/openapi/openapi.yaml -o src/api/generated-types.ts"},"_npmUser":{"name":"bmhall2","email":"bmhall2@gmail.com"},"repository":{"url":"git+https://github.com/bmhall2/skylight-mcp.git","type":"git"},"_npmVersion":"10.9.7","description":"MCP server for Skylight Calendar API - enables agentic interactions for calendar, chores, lists, and family management","directories":{},"_nodeVersion":"22.22.2","dependencies":{"zod":"^3.24.1","@modelcontextprotocol/sdk":"^1.11.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","eslint":"^8.57.0","vitest":"^1.6.0","typescript":"^5.4.5","@types/node":"^20.12.2","openapi-typescript":"^7.0.0","@typescript-eslint/parser":"^7.0.0","@typescript-eslint/eslint-plugin":"^7.0.0"},"_npmOperationalInternal":{"tmp":"tmp/skylight-mcp_1.1.9_1776044148162_0.7221107801881776","host":"s3://npm-registry-packages-npm-production"}},"1.1.10":{"name":"@bmhall2/skylight-mcp","version":"1.1.10","keywords":["mcp","skylight","calendar","model-context-protocol","claude","ai","family","chores"],"author":{"name":"Ben Hall","email":"bmhall2@gmail.com"},"license":"MIT","_id":"@bmhall2/skylight-mcp@1.1.10","maintainers":[{"name":"bmhall2","email":"bmhall2@gmail.com"}],"homepage":"https://github.com/bmhall2/skylight-mcp#readme","bugs":{"url":"https://github.com/bmhall2/skylight-mcp/issues"},"bin":{"skylight-mcp":"dist/index.js"},"dist":{"shasum":"eb8f5165753e4f6e64856be08f8513df97057679","tarball":"https://registry.npmjs.org/@bmhall2/skylight-mcp/-/skylight-mcp-1.1.10.tgz","fileCount":123,"integrity":"sha512-gzo2u2lIlb57w8DsYp6che+Jf2xmRgz4tPjf21HM8MJm5OhyNfM+N55JMpf99/pdhtrd3COM3RoAYtJ4dPwgaw==","signatures":[{"sig":"MEYCIQDPfFWCmum4lf4N2M3bYC1n0X2bOujk/1cRvL770JxrNQIhAJM8STUgNIRSpjKTZPP0OsFSpCYQpSyzCLieV3UGjrFu","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bmhall2%2fskylight-mcp@1.1.10","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":1367238},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"cbfb9e5a59ad5535b9999d8631039e7c3baac40e","scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src/","test":"vitest","build":"tsc","start":"node dist/index.js","prepare":"npm run build","typecheck":"tsc --noEmit","test:coverage":"vitest --coverage","generate:types":"openapi-typescript ../skylight-api/docs/openapi/openapi.yaml -o src/api/generated-types.ts"},"_npmUser":{"name":"bmhall2","email":"bmhall2@gmail.com"},"repository":{"url":"git+https://github.com/bmhall2/skylight-mcp.git","type":"git"},"_npmVersion":"10.9.7","description":"MCP server for Skylight Calendar API - enables agentic interactions for calendar, chores, lists, and family management","directories":{},"_nodeVersion":"22.22.2","dependencies":{"zod":"^3.24.1","@modelcontextprotocol/sdk":"^1.11.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","eslint":"^8.57.0","vitest":"^1.6.0","typescript":"^5.4.5","@types/node":"^20.12.2","openapi-typescript":"^7.0.0","@typescript-eslint/parser":"^7.0.0","@typescript-eslint/eslint-plugin":"^7.0.0"},"_npmOperationalInternal":{"tmp":"tmp/skylight-mcp_1.1.10_1776303691962_0.7122008311703105","host":"s3://npm-registry-packages-npm-production"}},"1.1.11":{"_id":"@bmhall2/skylight-mcp@1.1.11","bin":{"skylight-mcp":"dist/index.js"},"bugs":{"url":"https://github.com/bmhall2/skylight-mcp/issues"},"dist":{"shasum":"94c094ef17a764c6588f955552e6471a127655f3","tarball":"https://registry.npmjs.org/@bmhall2/skylight-mcp/-/skylight-mcp-1.1.11.tgz","fileCount":127,"integrity":"sha512-heGQMLosgk/YOAe2glGtoso1sD+CyeShxZ+B91TYVOnHv4I6pRRFB0oAk8mYIwrBmaJ/Qhif8jnGVSsNEmmWmw==","signatures":[{"sig":"MEUCIQC4NnDzMUQ2SfBDFRpENqKVBdaIjBNXqHJFxgpquSjP/gIgTqtRFcr/DST/8xQp9kIvaCwb37xrJCs8pRmiF5cRbTg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFCMnIbdm0Gi3GjhpoMuxaJK1bQqOdjZiDu6/Wti7zq7AiAgWIYxdH/OT1Ef3P3hImw7FoW2L2XLXgjNNP7j9zr8+Q=="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bmhall2%2fskylight-mcp@1.1.11","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":1391400},"main":"dist/index.js","name":"@bmhall2/skylight-mcp","type":"module","types":"./dist/index.d.ts","author":{"name":"Ben Hall","email":"bmhall2@gmail.com"},"engines":{"node":">=18.0.0"},"gitHead":"da22dea7fe200468c07ec6eb4ca0f2892a0948de","license":"MIT","scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src/","test":"vitest","build":"tsc","start":"node dist/index.js","prepare":"npm run build","typecheck":"tsc --noEmit","test:coverage":"vitest --coverage","generate:types":"openapi-typescript ../skylight-api/docs/openapi/openapi.yaml -o src/api/generated-types.ts"},"version":"1.1.11","_npmUser":{"name":"bmhall2","email":"bmhall2@gmail.com"},"homepage":"https://github.com/bmhall2/skylight-mcp#readme","keywords":["mcp","skylight","calendar","model-context-protocol","claude","ai","family","chores"],"repository":{"url":"git+https://github.com/bmhall2/skylight-mcp.git","type":"git"},"_npmVersion":"10.9.9","description":"MCP server for Skylight Calendar API - enables agentic interactions for calendar, chores, lists, and family management","directories":{},"maintainers":[{"name":"bmhall2","email":"bmhall2@gmail.com"}],"_nodeVersion":"22.23.3","dependencies":{"zod":"^3.24.1","@modelcontextprotocol/sdk":"^1.11.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","eslint":"^8.57.0","vitest":"^1.6.0","typescript":"^5.4.5","@types/node":"^20.12.2","openapi-typescript":"^7.0.0","@typescript-eslint/parser":"^7.0.0","@typescript-eslint/eslint-plugin":"^7.0.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/skylight-mcp_1.1.11_1790818052604_0.9923410271235926"}}},"time":{"created":"2026-04-13T00:19:50.551Z","modified":"2026-10-01T01:27:32.991Z","1.1.7":"2026-04-13T00:19:50.789Z","1.1.8":"2026-04-13T01:09:49.471Z","1.1.9":"2026-04-13T01:35:48.295Z","1.1.10":"2026-04-16T01:41:32.099Z","1.1.11":"2026-10-01T01:27:32.686Z"},"bugs":{"url":"https://github.com/bmhall2/skylight-mcp/issues"},"author":{"name":"Ben Hall","email":"bmhall2@gmail.com"},"license":"MIT","homepage":"https://github.com/bmhall2/skylight-mcp#readme","keywords":["mcp","skylight","calendar","model-context-protocol","claude","ai","family","chores"],"repository":{"url":"git+https://github.com/bmhall2/skylight-mcp.git","type":"git"},"description":"MCP server for Skylight Calendar API - enables agentic interactions for calendar, chores, lists, and family management","maintainers":[{"name":"bmhall2","email":"bmhall2@gmail.com"}],"readme":"# Skylight MCP Server\n\n> **Maintained fork** of [TheEagleByte/skylight-mcp](https://github.com/TheEagleByte/skylight-mcp). The original project appears to be abandoned; this fork continues active development.\n\nAn MCP (Model Context Protocol) server for the Skylight Calendar API. Enables AI assistants like Claude to interact with your Skylight family calendar, chores, lists, and more.\n\n## Features\n\n- **Calendar**: Query calendar events (\"What's on my calendar today?\")\n- **Chores**: View and create chores (\"Add emptying dishwasher to chores\")\n- **Lists**: View grocery and to-do lists (\"What's on the grocery list?\")\n- **Tasks**: Add items to the task box (\"Add XYZ to my task list\")\n- **Family**: View family members and devices\n- **Rewards**: Check reward points and available rewards\n\n## Quick Start\n\n### Installation\n\n#### Option 1: npm package (Recommended)\n\n**mcp.json:**\n```json\n{\n  \"mcpServers\": {\n    \"skylight\": {\n      \"command\": \"npx\",\n      \"args\": [\"@bmhall2/skylight-mcp\"],\n      \"env\": {\n        \"SKYLIGHT_EMAIL\": \"your_email@example.com\",\n        \"SKYLIGHT_PASSWORD\": \"your_password\",\n        \"SKYLIGHT_FRAME_ID\": \"your_frame_id\"\n      }\n    }\n  }\n}\n```\n\n**Claude Code:**\n```bash\nclaude mcp add skylight npx @bmhall2/skylight-mcp \\\n  -e SKYLIGHT_EMAIL=your_email@example.com \\\n  -e SKYLIGHT_PASSWORD=your_password \\\n  -e SKYLIGHT_FRAME_ID=your_frame_id\n```\n\n#### Option 2: From source\n\n```bash\ngit clone https://github.com/bmhall2/skylight-mcp.git\ncd skylight-mcp && npm install && npm run build\n```\n\nThen use in mcp.json:\n```json\n{\n  \"mcpServers\": {\n    \"skylight\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/skylight-mcp/dist/index.js\"],\n      \"env\": {\n        \"SKYLIGHT_EMAIL\": \"your_email@example.com\",\n        \"SKYLIGHT_PASSWORD\": \"your_password\",\n        \"SKYLIGHT_FRAME_ID\": \"your_frame_id\"\n      }\n    }\n  }\n}\n```\n\n### Instructions for AI\n\nCopy this into your AI's custom instructions or system prompt:\n\n> You have access to the Skylight MCP server. Skylight is a smart family calendar display that shows calendars, chores, grocery lists, meals, and rewards. Use the Skylight tools to help manage family schedules and organization.\n>\n> Tips:\n> - Call `get_family_members` before assigning chores to get member names\n> - Grocery items default to the main grocery list if no list specified\n> - Dates accept \"today\", \"tomorrow\", day names, or YYYY-MM-DD format\n> - Some tools (rewards, meals, photos) require Skylight Plus subscription\n\n## Prerequisites\n\n- Node.js 18+\n- A Skylight account with an active subscription\n- Your Skylight Frame ID (see [Finding your Frame ID](#finding-your-frame-id))\n\n## Authentication\n\nThe MCP server supports two authentication methods:\n\n### Option 1: Email/Password (Recommended)\n\nUse your Skylight account credentials. The server will automatically log in and manage tokens.\n\nThe token is cached in `~/.skylight-mcp/token.json` (override with `SKYLIGHT_TOKEN_CACHE`) and shared by every server process on the machine, so the login form is only used when the cached token and its refresh token have both expired. Delete that file to force a fresh login.\n\n```env\nSKYLIGHT_EMAIL=your_email@example.com\nSKYLIGHT_PASSWORD=your_password\nSKYLIGHT_FRAME_ID=your_frame_id\n```\n\n### Option 2: Manual Token (Legacy)\n\nCapture a token from the Skylight app using a proxy tool.\n\n```env\nSKYLIGHT_TOKEN=your_token_here\nSKYLIGHT_FRAME_ID=your_frame_id\nSKYLIGHT_AUTH_TYPE=bearer\n```\n\n### Finding your Frame ID\n\nYou still need to find your frame ID (the household identifier):\n\n1. Use a proxy tool ([Proxyman](https://proxyman.io/), [Charles](https://www.charlesproxy.com/), or [mitmproxy](https://mitmproxy.org/))\n2. Capture any API request from the Skylight app\n3. Look at the URL path: `/api/frames/{frameId}/...`\n4. Example: `/api/frames/abc123/chores` → frame ID is `abc123`\n\n## Configuration\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `SKYLIGHT_EMAIL` | Option 1 | Your Skylight account email |\n| `SKYLIGHT_PASSWORD` | Option 1 | Your Skylight account password |\n| `SKYLIGHT_TOKEN` | Option 2 | Your API token (if not using email/password) |\n| `SKYLIGHT_AUTH_TYPE` | No | `bearer` (default) or `basic` (for manual token) |\n| `SKYLIGHT_FRAME_ID` | Yes | Your household frame ID |\n| `SKYLIGHT_TIMEZONE` | No | Default timezone (default: `America/New_York`) |\n| `SKYLIGHT_TOKEN_CACHE` | No | Token cache path for email/password auth (default: `~/.skylight-mcp/token.json`) |\n\n### Example .env file:\n\n```env\n# Email/password auth (recommended)\nSKYLIGHT_EMAIL=your_email@example.com\nSKYLIGHT_PASSWORD=your_password\nSKYLIGHT_FRAME_ID=your_frame_id\nSKYLIGHT_TIMEZONE=America/New_York\n```\n\n## Available Tools\n\n### Calendar Tools\n\n| Tool | Description |\n|------|-------------|\n| `get_calendar_events` | Get calendar events for a date range |\n| `get_source_calendars` | List connected calendar sources (Google, iCloud, etc.) |\n\n### Chore Tools\n\n| Tool | Description |\n|------|-------------|\n| `get_chores` | Get chores with optional filters (date, assignee, status) |\n| `create_chore` | Create a new chore with optional recurrence |\n\n### List Tools\n\n| Tool | Description |\n|------|-------------|\n| `get_lists` | Get all available lists |\n| `get_list_items` | Get items from a specific list |\n\n### Task Tools\n\n| Tool | Description |\n|------|-------------|\n| `create_task` | Add a task to the task box |\n\n### Family Tools\n\n| Tool | Description |\n|------|-------------|\n| `get_family_members` | Get family member profiles |\n| `get_frame_info` | Get household/frame information |\n| `get_devices` | List Skylight devices |\n\n### Reward Tools\n\n| Tool | Description |\n|------|-------------|\n| `get_rewards` | Get available rewards |\n| `get_reward_points` | Get reward points balance |\n\n## Example Queries\n\nOnce configured, you can ask Claude things like:\n\n- \"What's on my calendar today?\"\n- \"What chores do I need to do this week?\"\n- \"Add 'take out trash' to my chores for tomorrow\"\n- \"What's on the grocery list?\"\n- \"Add milk to my task list\"\n- \"Who are the family members on Skylight?\"\n- \"How many reward points does each person have?\"\n\n## Development\n\n```bash\n# Run in development mode (with hot reload)\nnpm run dev\n\n# Build\nnpm run build\n\n# Run tests\nnpm test\n\n# Type check\nnpm run typecheck\n```\n\n## API Documentation\n\nThis MCP server is built on top of the reverse-engineered Skylight API. The API endpoints were documented using the [skylight-api](https://github.com/TheEagleByte/skylight-api) project, which converts browser network traffic (HAR files) into an OpenAPI specification.\n\n**API Resources:**\n- [Interactive API Docs (Swagger UI)](https://theeaglebyte.github.io/skylight-api/swagger.html)\n- [API Reference (ReDoc)](https://theeaglebyte.github.io/skylight-api/redoc.html)\n- [OpenAPI Specification](https://theeaglebyte.github.io/skylight-api/openapi/openapi.yaml)\n\nIf you discover new API endpoints or find issues with the current documentation, please contribute to the [skylight-api](https://github.com/TheEagleByte/skylight-api) repository.\n\n## Contributing\n\nContributions are welcome! Here's how you can help:\n\n1. **Fork the repository** and create a feature branch\n2. **Make your changes** with clear, descriptive commits\n3. **Run tests** (`npm test`) and linting (`npm run lint`) before submitting\n4. **Open a pull request** with a description of your changes\n\n### Development Setup\n\n```bash\ngit clone https://github.com/bmhall2/skylight-mcp.git\ncd skylight-mcp\nnpm install\nnpm run dev  # Start with hot reload\n```\n\n### Areas for Contribution\n\n- Adding support for new Skylight API endpoints\n- Improving error handling and edge cases\n- Enhancing documentation\n- Writing additional tests\n\n## Issues & Support\n\n- **Bug reports**: [Open an issue](https://github.com/bmhall2/skylight-mcp/issues/new) with steps to reproduce\n- **Feature requests**: [Open an issue](https://github.com/bmhall2/skylight-mcp/issues/new) describing the use case\n- **Questions**: [Start a discussion](https://github.com/bmhall2/skylight-mcp/discussions) or open an issue\n\nPlease include relevant details like your Node.js version, error messages, and configuration (with sensitive values redacted).\n\n## License\n\nMIT\n\n## Disclaimer\n\nThis is an unofficial integration. The Skylight API is reverse-engineered and may change without notice. Use at your own risk.\n","readmeFilename":"README.md"}