{"_id":"timepicker-ui-mcp","_rev":"7-0f82cd6ad56a72b35348a23596ce2081","name":"timepicker-ui-mcp","dist-tags":{"latest":"2.2.0"},"versions":{"0.0.0-stage":{"name":"timepicker-ui-mcp","version":"0.0.0-stage","_id":"timepicker-ui-mcp@0.0.0-stage","stub":true,"maintainers":[{"name":"pglejzer","email":"glejzerpiotr@gmail.com"}],"dist":{"shasum":"747c034a3c51e863412a4436bd1234068c9c43df","tarball":"https://registry.npmjs.org/timepicker-ui-mcp/-/timepicker-ui-mcp-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-hmCiASKsDfavaKSMhLaksCBXTXSKj6evkucnoEmFV97iXlwsee4UjsxCuVFtwDmXW3shOOBLUAPODqbyhINkuQ==","signatures":[{"sig":"MEYCIQCDj/m7YjKRQUHgoNil6rrXryUFigMOmS5MUlDddPQE6wIhANc4wMPICPqxDJTJ0q6aeUynvLHL/UylLAcoX9oKX+jk","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":339},"_npmUser":{"name":"pglejzer","email":"glejzerpiotr@gmail.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"1.0.0":{"name":"timepicker-ui-mcp","version":"1.0.0","keywords":["mcp","modelcontextprotocol","model-context-protocol","mcp-server","claude","timepicker","timepicker-ui","time-picker"],"author":{"url":"@pglejzer","name":"Piotr Glejzer"},"license":"MIT","_id":"timepicker-ui-mcp@1.0.0","maintainers":[{"name":"pglejzer","email":"glejzerpiotr@gmail.com"}],"homepage":"https://github.com/pglejzer/timepicker-ui/tree/main/mcp-server#readme","bugs":{"url":"https://github.com/pglejzer/timepicker-ui/issues"},"bin":{"timepicker-ui-mcp":"build/index.js"},"dist":{"shasum":"a8d14886aaaa400a815d1076c3f0a5b2d7a1ef3e","tarball":"https://registry.npmjs.org/timepicker-ui-mcp/-/timepicker-ui-mcp-1.0.0.tgz","fileCount":15,"integrity":"sha512-mbeAUU+g0c9toQG/kLhSUBDd63YLrQBMjuH8E198ZCqYzoRc9s01biKX1ZNut7fJkQeX7buU4luTchBQccf9uQ==","signatures":[{"sig":"MEUCIQCcnju6Vkso2/Gg9ipCXhxvV4IH84KRVzpGF5+aYiZs/wIgU6RctEGWRD6F3uR32jHv0G6yBZcKye7EbomHaAFkJSM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIFWYiU+PzhQ8V3OVyHYUKFJhyvpo07Riy7ELqIJc23U+AiA17o7Tg9/m6wuWOP94xxt5/jxAaROHLmrBypVRgWgPjw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":133403},"type":"module","engines":{"node":">=18"},"gitHead":"5307b0c618fb70114a2a08415c58a2fb8d15744f","mcpName":"io.github.pglejzer/timepicker-ui-mcp","scripts":{"test":"node scripts/smoke.mjs","build":"node scripts/generate.mjs && tsc && node scripts/postbuild.mjs","start":"node build/index.js","watch":"tsc --watch","inspect":"npx @modelcontextprotocol/inspector node build/index.js","generate":"node scripts/generate.mjs","prepublishOnly":"npm run build"},"_npmUser":{"name":"pglejzer","email":"glejzerpiotr@gmail.com"},"repository":{"url":"git+https://github.com/pglejzer/timepicker-ui.git","type":"git","directory":"mcp-server"},"_npmVersion":"11.19.0","description":"MCP server for timepicker-ui: exposes themes, UI modes, plugins, grouped options, events, the public API, config-snippet and custom-theme generation, and time validation as tools for Claude and other MCP clients.","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.9.2"},"_npmOperationalInternal":{"tmp":"tmp/timepicker-ui-mcp_1.0.0_1792138392686_0.86683943258967","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"timepicker-ui-mcp","version":"1.0.1","keywords":["mcp","modelcontextprotocol","model-context-protocol","mcp-server","claude","timepicker","timepicker-ui","time-picker"],"author":{"url":"@pglejzer","name":"Piotr Glejzer"},"license":"MIT","_id":"timepicker-ui-mcp@1.0.1","maintainers":[{"name":"pglejzer","email":"glejzerpiotr@gmail.com"}],"homepage":"https://github.com/pglejzer/timepicker-ui/tree/main/mcp-server#readme","bugs":{"url":"https://github.com/pglejzer/timepicker-ui/issues"},"bin":{"timepicker-ui-mcp":"build/index.js"},"dist":{"shasum":"dc248361039452f195e02ab3cb8c3ef5c9798bce","tarball":"https://registry.npmjs.org/timepicker-ui-mcp/-/timepicker-ui-mcp-1.0.1.tgz","fileCount":15,"integrity":"sha512-gDU+NGEasWT9wTfvif+FUTyYia6Uo3Tbwj/Bdkw4ei0Hrt4KNdKRI2VD3zfzLEit1jxxQUGnscLMHTIBZ6aMLQ==","signatures":[{"sig":"MEYCIQDHZkrwwzRDjIegEX/CofiM2a2RoZjNXB+pvGht6YLv/AIhAPH5NpYCgb68DzpeHjJp0QKAQKbdFlmAFBEQtClPpqXT","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQDlJGYVTD1b+mXQ8SnVopYH2oxEKrhe3NtKgw/ru2vx6wIhAOHXH5N7v5jSK6ge6iwgDC6Wrr+Ltu16esYsuyLOZm4O","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":134157},"type":"module","engines":{"node":">=18"},"gitHead":"4ba38118034d91169a312b187081e8de569cbb2e","mcpName":"io.github.pglejzer/timepicker-ui-mcp","scripts":{"test":"node scripts/smoke.mjs","build":"node scripts/generate.mjs && tsc && node scripts/postbuild.mjs","start":"node build/index.js","watch":"tsc --watch","inspect":"npx @modelcontextprotocol/inspector node build/index.js","generate":"node scripts/generate.mjs","prepublishOnly":"npm run build"},"_npmUser":{"name":"pglejzer","email":"glejzerpiotr@gmail.com"},"repository":{"url":"git+https://github.com/pglejzer/timepicker-ui.git","type":"git","directory":"mcp-server"},"_npmVersion":"11.19.0","description":"MCP server for timepicker-ui: options, events, themes, public API, snippets and time validation.","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.9.2"},"_npmOperationalInternal":{"tmp":"tmp/timepicker-ui-mcp_1.0.1_1792139761244_0.6066003910494797","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"timepicker-ui-mcp","version":"1.0.2","keywords":["mcp","modelcontextprotocol","model-context-protocol","mcp-server","claude","timepicker","timepicker-ui","time-picker"],"author":{"url":"@pglejzer","name":"Piotr Glejzer"},"license":"MIT","_id":"timepicker-ui-mcp@1.0.2","maintainers":[{"name":"pglejzer","email":"glejzerpiotr@gmail.com"}],"homepage":"https://github.com/pglejzer/timepicker-ui/tree/main/mcp-server#readme","bugs":{"url":"https://github.com/pglejzer/timepicker-ui/issues"},"bin":{"timepicker-ui-mcp":"build/index.js"},"dist":{"shasum":"b0424c108e29305ebc136e0d47bb74145db92d57","tarball":"https://registry.npmjs.org/timepicker-ui-mcp/-/timepicker-ui-mcp-1.0.2.tgz","fileCount":15,"integrity":"sha512-CeQ3+vz0ealSjF+m17CO2M7w8DvQ3DKTHmbk1mcLQR/oQDj1Ls54mtXJVT0q4zjN9G1xNGaAGbGXxM/yVwfZlQ==","signatures":[{"sig":"MEUCIAk8GtYEnM/Ney1NNIV5O8hxSz6uwJux5IBRGN/NBvBhAiEAhUzOYVYIyOUhqUSB5jcK/NouMrwXKnO/jHM5Yk7fBVM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQChOUWSFkffggN1fDL0kooDNPUADRPIJFCJwYOCV1O3ngIhANSYJ89HNYFUcSaX8EM2Asg5SAh+qjmsYp0mNlhsrggn","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":134273},"type":"module","engines":{"node":">=18"},"gitHead":"8f501082dc3fad241dcd5d02d0e4b426579f438d","mcpName":"io.github.pglejzer/timepicker-ui-mcp","scripts":{"test":"node scripts/smoke.mjs","build":"node scripts/generate.mjs && tsc && node scripts/postbuild.mjs","start":"node build/index.js","watch":"tsc --watch","inspect":"npx @modelcontextprotocol/inspector node build/index.js","generate":"node scripts/generate.mjs","prepublishOnly":"npm run build"},"_npmUser":{"name":"pglejzer","email":"glejzerpiotr@gmail.com"},"repository":{"url":"git+https://github.com/pglejzer/timepicker-ui.git","type":"git","directory":"mcp-server"},"_npmVersion":"11.19.0","description":"MCP server for timepicker-ui: exposes themes, UI modes, plugins, grouped options, events, the public API, config-snippet and custom-theme generation, and time validation as tools for Claude and other MCP clients.","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.9.2"},"_npmOperationalInternal":{"tmp":"tmp/timepicker-ui-mcp_1.0.2_1792139827126_0.46192864833980396","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"timepicker-ui-mcp","version":"2.0.0","keywords":["mcp","modelcontextprotocol","model-context-protocol","mcp-server","claude","timepicker","timepicker-ui","time-picker"],"author":{"url":"@pglejzer","name":"Piotr Glejzer"},"license":"MIT","_id":"timepicker-ui-mcp@2.0.0","maintainers":[{"name":"pglejzer","email":"glejzerpiotr@gmail.com"}],"homepage":"https://github.com/pglejzer/timepicker-ui/tree/main/mcp-server#readme","bugs":{"url":"https://github.com/pglejzer/timepicker-ui/issues"},"bin":{"timepicker-ui-mcp":"build/index.js"},"dist":{"shasum":"c13518bd34259a71ebef1e9d18d6d9e7a6031fe3","tarball":"https://registry.npmjs.org/timepicker-ui-mcp/-/timepicker-ui-mcp-2.0.0.tgz","fileCount":19,"integrity":"sha512-m3+jUgSzNKkuvgSGxs7IC1xkMvyab8mT3MZr1fL3Q6efHolGdw9vg+FvbhaksirIVABArtsPpAHp6RfnPXkB4w==","signatures":[{"sig":"MEUCIBCTl8/BLtfPHbZOTroGcLzLEyfPKvZ8hv8qA4PtySPEAiEAsNomAWjsnAVPhT8iCdRpQf1+O/2pan3Stm/VD2PEPCE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCBOfwP52/qTm7ngPPnTZKbka3M+x/NxICWJCuBvqNI9QIgb58u3/+vmKcr8ixEq8NRXJToBSm1u+Mt4p6hYjAD7ck=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":209216},"type":"module","engines":{"node":">=20"},"gitHead":"e1f7f10287bfd40e0486c2031c29e723a347375e","mcpName":"io.github.pglejzer/timepicker-ui-mcp","scripts":{"test":"node scripts/smoke.mjs","build":"node scripts/generate.mjs && tsc && node scripts/postbuild.mjs","start":"node build/index.js","watch":"tsc --watch","inspect":"npx @modelcontextprotocol/inspector node build/index.js","generate":"node scripts/generate.mjs","prepublishOnly":"npm run build"},"_npmUser":{"name":"pglejzer","email":"glejzerpiotr@gmail.com"},"repository":{"url":"git+https://github.com/pglejzer/timepicker-ui.git","type":"git","directory":"mcp-server"},"_npmVersion":"11.19.0","description":"MCP server for timepicker-ui: options, events, CSS variables, themes, the public API, migration guides, setup snippets, custom themes, time validation and reference search for Claude and other MCP clients.","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^4.6.0","@modelcontextprotocol/server":"^2.3.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.9.2","@modelcontextprotocol/client":"^2.3.1"},"_npmOperationalInternal":{"tmp":"tmp/timepicker-ui-mcp_2.0.0_1792167980372_0.7020739523180899","host":"s3://npm-registry-packages-npm-production"}},"2.1.0":{"name":"timepicker-ui-mcp","version":"2.1.0","keywords":["mcp","modelcontextprotocol","model-context-protocol","mcp-server","claude","timepicker","timepicker-ui","time-picker"],"author":{"url":"@pglejzer","name":"Piotr Glejzer"},"license":"MIT","_id":"timepicker-ui-mcp@2.1.0","maintainers":[{"name":"pglejzer","email":"glejzerpiotr@gmail.com"}],"homepage":"https://github.com/pglejzer/timepicker-ui/tree/main/mcp-server#readme","bugs":{"url":"https://github.com/pglejzer/timepicker-ui/issues"},"bin":{"timepicker-ui-mcp":"build/index.js"},"dist":{"shasum":"324f67f08db2b38aae94291b1613f95b7ac3d549","tarball":"https://registry.npmjs.org/timepicker-ui-mcp/-/timepicker-ui-mcp-2.1.0.tgz","fileCount":19,"integrity":"sha512-kTHoCZxrfsF+2s65RfIyDNFDdcgFg5c6mr99Uj6P4O3aSvaMaM9PlHcnUREQ9IeNH03ywTBwBQn4TjvSPDcmsg==","signatures":[{"sig":"MEYCIQDice9oUT/YicIeAGKscLpxLBDsabmZ57DlHFvF1wyjUAIhANeqCbC5i9zZqnM609KYzEEqOBIru9ZSxfi+JHQITd+m","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQC3apUBxkw4dpoyc+91ERQcIVAs+HfWbc7VS1uJqevp6wIgGmK9OXBCsaecmY8Bua2+jQXcMA/b3z/rJi9Y3PoGX/Y=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":212105},"type":"module","engines":{"node":">=20"},"gitHead":"639a4565cfce05fb0263988da7bbbc305cb1aa5b","mcpName":"io.github.pglejzer/timepicker-ui-mcp","scripts":{"test":"node scripts/smoke.mjs","build":"node scripts/generate.mjs && tsc && node scripts/postbuild.mjs","start":"node build/index.js","watch":"tsc --watch","inspect":"npx @modelcontextprotocol/inspector node build/index.js","generate":"node scripts/generate.mjs","prepublishOnly":"npm run build"},"_npmUser":{"name":"pglejzer","email":"glejzerpiotr@gmail.com"},"repository":{"url":"git+https://github.com/pglejzer/timepicker-ui.git","type":"git","directory":"mcp-server"},"_npmVersion":"11.19.0","description":"MCP server for timepicker-ui: options, events, CSS variables, themes, the public API, migration guides, setup snippets, custom themes, time validation and reference search for Claude and other MCP clients.","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^4.6.0","@modelcontextprotocol/server":"^2.3.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.9.2","@modelcontextprotocol/client":"^2.3.1"},"_npmOperationalInternal":{"tmp":"tmp/timepicker-ui-mcp_2.1.0_1792421631764_0.9149815033169613","host":"s3://npm-registry-packages-npm-production"}},"2.2.0":{"_id":"timepicker-ui-mcp@2.2.0","bin":{"timepicker-ui-mcp":"build/index.js"},"bugs":{"url":"https://github.com/pglejzer/timepicker-ui/issues"},"dist":{"shasum":"1aeaf7f11721e3d7402bc5ced6be97f5e3555cc9","tarball":"https://registry.npmjs.org/timepicker-ui-mcp/-/timepicker-ui-mcp-2.2.0.tgz","fileCount":19,"integrity":"sha512-EP2fSOhCqTABXHCmW5CCERKksuSb+nrrlBGEcxbqvS0q44K8vrqKw9E935XgtZ9HJ9rZY1kSJLRa/9DMir+/1g==","signatures":[{"sig":"MEYCIQDrNzurHwPGtC5QD1QL0JxLUG6ZHZQ5Vw4YGRG0BpoEiAIhAMVldRj4Z2hzIGvF6uyfo2r3yW8rnsDEGsV0yI72EjdA","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDRCfwpU3Da3goeE/uvaVzC4ahFs+EsxA96QSUynKdxAwIge8tgtw0NLwayWxkF8rbMsHhWxah+vnm//OfrAHsOK34="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/timepicker-ui-mcp@2.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":223220},"name":"timepicker-ui-mcp","type":"module","author":{"url":"@pglejzer","name":"Piotr Glejzer"},"engines":{"node":">=20"},"gitHead":"a00cdcdd1f96a614b9ea5afe4282ba379600ae72","license":"MIT","mcpName":"io.github.pglejzer/timepicker-ui-mcp","scripts":{"test":"node scripts/smoke.mjs","build":"node scripts/generate.mjs && tsc && node scripts/postbuild.mjs","start":"node build/index.js","watch":"tsc --watch","inspect":"npx @modelcontextprotocol/inspector node build/index.js","generate":"node scripts/generate.mjs","prepublishOnly":"npm run build"},"version":"2.2.0","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"8f210d80-4a99-4346-80c4-cad725fbb5fb"}},"homepage":"https://github.com/pglejzer/timepicker-ui/tree/main/mcp-server#readme","keywords":["mcp","modelcontextprotocol","model-context-protocol","mcp-server","claude","timepicker","timepicker-ui","time-picker"],"repository":{"url":"git+https://github.com/pglejzer/timepicker-ui.git","type":"git","directory":"mcp-server"},"_npmVersion":"11.19.1","description":"MCP server for timepicker-ui: options, events, CSS variables, themes, the public API, migration guides, setup snippets, custom themes, time validation and reference search for Claude and other MCP clients.","directories":{},"maintainers":[{"name":"pglejzer","email":"glejzerpiotr@gmail.com"}],"_nodeVersion":"24.22.2","dependencies":{"zod":"^4.6.0","@modelcontextprotocol/server":"^2.3.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.9.2","@modelcontextprotocol/client":"^2.3.1"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/timepicker-ui-mcp_2.2.0_1794409767616_0.7021302161563583"}}},"time":{"created":"2026-10-16T08:10:34.226Z","modified":"2026-11-11T15:09:28.347Z","0.0.0-stage":"2026-10-16T08:10:34.226Z","1.0.0":"2026-10-16T08:13:12.779Z","1.0.1":"2026-10-16T08:36:01.329Z","1.0.2":"2026-10-16T08:37:07.235Z","2.0.0":"2026-10-16T16:26:20.470Z","2.1.0":"2026-10-19T14:53:51.867Z","2.2.0":"2026-11-11T15:09:27.759Z"},"bugs":{"url":"https://github.com/pglejzer/timepicker-ui/issues"},"author":{"url":"@pglejzer","name":"Piotr Glejzer"},"license":"MIT","homepage":"https://github.com/pglejzer/timepicker-ui/tree/main/mcp-server#readme","keywords":["mcp","modelcontextprotocol","model-context-protocol","mcp-server","claude","timepicker","timepicker-ui","time-picker"],"repository":{"url":"git+https://github.com/pglejzer/timepicker-ui.git","type":"git","directory":"mcp-server"},"description":"MCP server for timepicker-ui: options, events, CSS variables, themes, the public API, migration guides, setup snippets, custom themes, time validation and reference search for Claude and other MCP clients.","maintainers":[{"name":"pglejzer","email":"glejzerpiotr@gmail.com"}],"readme":"# timepicker-ui MCP server\r\n\r\nAn MCP server for `timepicker-ui`. Connect it to Claude Code, Claude Desktop or another MCP client and the model can look up options, events, CSS variables and themes, search the reference, generate setup snippets and custom themes, and get migration steps. Options, events, payloads, CSS variables, classes, troubleshooting and the 5.0 rename tables are generated from the library source and the docs site. Themes, modes, plugins, the method list, framework recipes and migration notes are written by hand in `src/data.ts` and `src/content.ts`.\r\n\r\nEvery tool only reads this reference data and is marked `readOnlyHint`. Deprecated options and events are flagged, and left out of lists unless a tool is asked for them. Results link to the docs at https://timepicker-ui.vercel.app.\r\n\r\nIt runs over stdio and needs Node 20 or newer. It is built on the MCP TypeScript SDK v2 and serves clients on the 2025 protocol (`initialize`) and on the 2026-07-28 revision.\r\n\r\n## Tools\r\n\r\n| Tool                     | Description                                                                                         |\r\n| ------------------------ | --------------------------------------------------------------------------------------------------- |\r\n| `search_reference`       | Keyword search across options, nested fields, events, CSS variables, classes, methods and fixes.    |\r\n| `get_options`            | Grouped options with type, default, description and nested fields. `group`, `includeDeprecated`.  |\r\n| `explain_option`         | One option (`group` + `name`, dotted for nested fields such as `disabledTime.ranges`).            |\r\n| `list_events`            | Events with payload fields. `includeInternal`, `includeDeprecated`.                                |\r\n| `list_api`               | Instance and static methods with deprecations, plus the `getValue`/`setValue` contract.            |\r\n| `list_css_variables`     | `--tp-` variables with group and default. `group`, `includeUnread`.                               |\r\n| `list_css_classes`       | `tp-ui-` class names and state modifiers with example selectors.                                   |\r\n| `list_themes`            | Built-in themes and their CSS import paths.                                                         |\r\n| `get_theme`              | The `--tp-` variables a built-in theme sets.                                                       |\r\n| `list_modes`             | UI modes (`clock`, `wheel`, `compact-wheel`) and the plugin each needs.                             |\r\n| `list_plugins`           | Optional plugins (range, timezone, wheel) with import paths and registration.                       |\r\n| `framework_recipe`       | Recipe and SSR notes for vanilla, react, react-wrapper (`timepicker-ui-react`), next, vue, angular, svelte. |\r\n| `migration_guide`        | `v3->v4`, `v4.3->v4.4`, `v4.4->v4.5` (with every renamed option), `v4.6->v4.7` or `v4.5->v5` (draft). |\r\n| `generate_snippet`       | Vanilla JS or React setup with theme, mode, clock type, seconds and plugins.                        |\r\n| `generate_custom_theme`  | CSS for a theme applied with `ui.cssClass`, from `overrides` or as a scaffold.                     |\r\n| `validate_time`          | Checks `HH:MM`, `HH:MM:SS`, `h:MM AM/PM` or `h:MM:SS AM/PM` against a 12h or 24h clock.             |\r\n| `validate_disabled_time` | Checks a `clock.disabledTime` config (hours, minutes, seconds, range strings).                      |\r\n\r\nWrong arguments, such as an unknown option name, come back with `isError: true` and a hint, so the model can correct the call.\r\n\r\n## Resources\r\n\r\n| URI                                  | Description                                              |\r\n| ------------------------------------ | -------------------------------------------------------- |\r\n| `timepicker-ui://reference`          | Grouped-options summary.                                 |\r\n| `timepicker-ui://css-variables`      | Every `--tp-` variable with group, default and notes.    |\r\n| `timepicker-ui://custom-theme-guide` | How to style the picker with `ui.cssClass`.              |\r\n| `timepicker-ui://troubleshooting`    | The docs troubleshooting entries with fixes and code.    |\r\n\r\n## Prompts\r\n\r\n| Prompt               | Argument      | Purpose                                                  |\r\n| -------------------- | ------------- | -------------------------------------------------------- |\r\n| `integrate`          | `framework`   | Walk through a framework integration (with completion).  |\r\n| `build-custom-theme` | `description` | Turn a palette into a theme.                             |\r\n| `migrate-v3-to-v4`   | `code`        | Convert v3 code to v4 grouped options.                   |\r\n| `prepare-for-v5`     | `code`        | Replace deprecated 4.x API with the names 5.0 keeps.     |\r\n\r\n## Build and test\r\n\r\n```bash\r\ncd mcp-server\r\nnpm install\r\nnpm run build      # generate data, compile, copy generated JSON into build/\r\nnpm test           # start the server and check that tools, resources and prompts respond\r\nnpm run inspect    # open the MCP Inspector against the built server\r\n```\r\n\r\n## Where the data comes from\r\n\r\n`npm run build` first runs `scripts/generate.mjs`, which writes `src/generated/*.json`:\r\n\r\n- From the library source in `../app` and the root `package.json`: options with defaults, examples, nested fields and `@deprecated` notes (`options.d.ts`), events and payloads (`EventEmitter.ts`, `types.d.ts`), the variables each built-in theme sets, and the library version.\r\n- From the docs site in `../docs-app`: CSS variables and classes (`lib/generated/css-reference.json`, built from the published package CSS), the troubleshooting entries, and the renamed and removed tables of the 5.0 migration guide.\r\n\r\nThe generated JSON is committed, so the server works without `app/` and `docs-app/` next to it. A source that is missing keeps its existing JSON. After changing the library or those docs pages, run `npm run build` again. When the CSS changes, regenerate the docs CSS reference first.\r\n\r\n## Adding it to Claude Code\r\n\r\nNo API keys or env vars are needed. `--scope user` makes it available in every project. Leave it out to register it for the current project only. Check it with `claude mcp list`, which should show `timepicker-ui  ✓ Connected`.\r\n\r\n```bash\r\nclaude mcp add --scope user timepicker-ui -- npx -y timepicker-ui-mcp\r\n```\r\n\r\nOn native Windows, wrap `npx` in `cmd /c`:\r\n\r\n```bash\r\nclaude mcp add --scope user timepicker-ui -- cmd /c npx -y timepicker-ui-mcp\r\n```\r\n\r\nTo run a local build instead, build it first and point at the built file:\r\n\r\n```bash\r\nclaude mcp add --scope user timepicker-ui -- node /absolute/path/to/timepicker-ui/mcp-server/build/index.js\r\n```\r\n\r\nIf you work in this repo, you can also add a project `.mcp.json` (after `npm install && npm run build` in `mcp-server/`):\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"timepicker-ui\": {\r\n      \"command\": \"node\",\r\n      \"args\": [\"mcp-server/build/index.js\"]\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n## Adding it to Claude Desktop\r\n\r\nEdit `claude_desktop_config.json`. It's in `%APPDATA%\\Claude\\` on Windows and `~/Library/Application Support/Claude/` on macOS.\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"timepicker-ui\": {\r\n      \"command\": \"node\",\r\n      \"args\": [\"/absolute/path/to/timepicker-ui/mcp-server/build/index.js\"]\r\n    }\r\n  }\r\n}\r\n```\r\n\r\nRestart Claude Desktop after saving.\r\n","readmeFilename":"README.md"}