{"_id":"xenon-mcp","_rev":"3-e4a9dbad0bfec4aa28fc6c299e6b952b","name":"xenon-mcp","dist-tags":{"latest":"1.0.1"},"versions":{"0.0.0-stage":{"name":"xenon-mcp","version":"0.0.0-stage","_id":"xenon-mcp@0.0.0-stage","stub":true,"maintainers":[{"name":"marcimastro98","email":"marcellomastroeni4@gmail.com"}],"dist":{"shasum":"f4951de424610531a694ce528ee806fefd9403d8","tarball":"https://registry.npmjs.org/xenon-mcp/-/xenon-mcp-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-qQso9T79kCzfbeXfAHHgS4bviLhF3fY1Jy0ebS2Lg5CooCfw++J+bdKCku+8dfP/6lR7NAS235by3Y7TY7zgKQ==","signatures":[{"sig":"MEUCIQCbe/uiAYTdLFNonxt/x+t2jmGTPaVa1iMzShCXvDCQ5gIgO63V6KZabGUVlNAbrPPk352uVI29Yl4MUKgWgaNwPfQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":331},"_npmUser":{"name":"marcimastro98","email":"marcellomastroeni4@gmail.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"1.0.0":{"name":"xenon-mcp","version":"1.0.0","keywords":["mcp","model-context-protocol","xenon","widgets","dashboard","claude-code","codex"],"author":{"url":"https://github.com/marcimastro98","name":"Marcello Mastroeni"},"license":"SEE LICENSE IN LICENSE","_id":"xenon-mcp@1.0.0","maintainers":[{"name":"marcimastro98","email":"marcellomastroeni4@gmail.com"}],"homepage":"https://xenon-app.com/create/#mcp","bugs":{"url":"https://github.com/marcimastro98/Xenon/issues"},"bin":{"xenon-mcp":"bin/xenon-mcp.js"},"dist":{"shasum":"3323abc230ef269b814a6dca9ee369e998a35c29","tarball":"https://registry.npmjs.org/xenon-mcp/-/xenon-mcp-1.0.0.tgz","fileCount":8,"integrity":"sha512-18pjwp2Dm2k8Lr1zNNQqkkfVKL6PrarPcR30LzM5itl3h/h1xi4/reguje6+qIkp8Z8AD6E9iClX7y0N4ypPyA==","signatures":[{"sig":"MEQCIAup+liJONJkHJoNqajx8a6NLy2POWSGTrhFr6atn6wNAiAo9VvRd8QrefH7hXru0d56kj8Kt/Y88HBmL+TiiaB4Ow==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIFrwSW89Hs473B8sUUUwLhQPUWK9zggWD2a6/oauFtg0AiEA5VYqdL6io1BN0DEfnizVYk3bx+PsWbETEIKmUKNrR2s=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":31642},"type":"commonjs","engines":{"node":">=18"},"gitHead":"ed6814170908da9ece7252ac97ce64c9e020e1a5","mcpName":"io.github.marcimastro98/xenon-widgets","scripts":{"test":"node --test \"test/*.test.mjs\"","prepack":"node -e \"require('fs').copyFileSync('../../LICENSE','LICENSE')\""},"_npmUser":{"name":"marcimastro98","email":"marcellomastroeni4@gmail.com"},"repository":{"url":"git+https://github.com/marcimastro98/Xenon.git","type":"git","directory":"packages/mcp"},"_npmVersion":"11.6.1","description":"Build widgets for the Xenon dashboard from Claude Code, Codex or any MCP client: read the SDK, install, see errors and a picture of the tile.","directories":{},"_nodeVersion":"24.11.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/xenon-mcp_1.0.0_1793368376160_0.7717573318556117","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"_id":"xenon-mcp@1.0.1","bin":{"xenon-mcp":"bin/xenon-mcp.js"},"bugs":{"url":"https://github.com/marcimastro98/Xenon/issues"},"dist":{"shasum":"1ef48dd6dd09bb947f7daa728c9734a1369d133d","tarball":"https://registry.npmjs.org/xenon-mcp/-/xenon-mcp-1.0.1.tgz","fileCount":8,"integrity":"sha512-9RcUN2dH3CGDNQgF79QA0Zxe94Xh7BnnoS46Kr36Q4/I+rOXRHI3+EYD/KjVngfT21ZhS8X+4QLPbd2e+WnyNg==","signatures":[{"sig":"MEQCIB9nwQz/AVKMrwwuLw8ht40lFUKKJxDJXkmAXPxnxZxIAiBAwqJ1KEbN5IchmDLWRPJ1Pm1VkFvgXNwnriDLESP8FQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDK6wzU34TDrFML8TTQ5Bi72/HCBMDFpn7AvMuOXDMfnAIgKSbzYmUYY1bBeuZ51eycZx+p1wWtAaVC+xuBT+ulC64="}],"unpackedSize":31715},"name":"xenon-mcp","type":"commonjs","author":{"url":"https://github.com/marcimastro98","name":"Marcello Mastroeni"},"engines":{"node":">=18"},"gitHead":"c49a143d7f024ee4014a6b475ba3ef03a229b8d4","license":"SEE LICENSE IN LICENSE","mcpName":"io.github.marcimastro98/xenon-widgets","scripts":{"test":"node --test \"test/*.test.mjs\"","prepack":"node -e \"require('fs').copyFileSync('../../LICENSE','LICENSE')\""},"version":"1.0.1","_npmUser":{"name":"marcimastro98","email":"marcellomastroeni4@gmail.com"},"homepage":"https://xenon-app.com/create/#mcp","keywords":["mcp","model-context-protocol","xenon","widgets","dashboard","claude-code","codex"],"repository":{"url":"git+https://github.com/marcimastro98/Xenon.git","type":"git","directory":"packages/mcp"},"_npmVersion":"11.19.1","description":"Build widgets for the Xenon dashboard from Claude Code, Codex or any MCP client: read the SDK, install, see errors and a picture of the tile.","directories":{},"maintainers":[{"name":"marcimastro98","email":"marcellomastroeni4@gmail.com"}],"_nodeVersion":"24.22.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/xenon-mcp_1.0.1_1794302792859_0.9394587077805754"}}},"time":{"created":"2026-10-30T13:50:48.732Z","modified":"2026-11-10T09:26:33.486Z","0.0.0-stage":"2026-10-30T13:50:48.732Z","1.0.0":"2026-10-30T13:52:56.253Z","1.0.1":"2026-11-10T09:26:32.935Z"},"bugs":{"url":"https://github.com/marcimastro98/Xenon/issues"},"author":{"url":"https://github.com/marcimastro98","name":"Marcello Mastroeni"},"license":"SEE LICENSE IN LICENSE","homepage":"https://xenon-app.com/create/#mcp","keywords":["mcp","model-context-protocol","xenon","widgets","dashboard","claude-code","codex"],"repository":{"url":"git+https://github.com/marcimastro98/Xenon.git","type":"git","directory":"packages/mcp"},"description":"Build widgets for the Xenon dashboard from Claude Code, Codex or any MCP client: read the SDK, install, see errors and a picture of the tile.","maintainers":[{"name":"marcimastro98","email":"marcellomastroeni4@gmail.com"}],"readme":"# xenon-mcp\r\n\r\nBuild widgets for [Xenon](https://xenon-app.com), the dashboard for any spare screen, from Claude Code, Codex or any\r\nother MCP client. Your assistant reads the Widget SDK, writes the widget in a folder, installs it, puts it on your\r\ndashboard, reads the errors it hits while it runs and looks at a picture of its tile, then fixes what is wrong.\r\n\r\nIt talks only to the Xenon running on your own computer. Nothing goes to the internet.\r\n\r\n## Add it\r\n\r\nXenon 5.0.0 or newer must be running. In Xenon, **Settings, Widgets & sharing, Build widgets with Claude Code or Codex** has a\r\nbutton for each that does this for you. By hand:\r\n\r\n```sh\r\n# Claude Code\r\nclaude mcp add --scope user xenon-widgets -- npx -y xenon-mcp\r\n\r\n# Codex\r\ncodex mcp add xenon-widgets -- npx -y xenon-mcp\r\n```\r\n\r\nAny other MCP client: run `npx -y xenon-mcp` as a stdio server. It needs Node.js 18 or newer.\r\n\r\nIn Claude Code you can install it as a plugin instead, which adds a `build-widget` skill that knows the loop\r\n(read the SDK, write, install, look, fix):\r\n\r\n```text\r\n/plugin install xenon-widgets --marketplace marcimastro98/Xenon\r\n```\r\n\r\nThe first time the assistant uses a tool, Xenon asks on its dashboard: **Let this tool build widgets?** Press Allow.\r\nThe connection is remembered in `~/.xenon/mcp.json` and listed in that same Settings card, where Remove ends it.\r\n\r\n## Then ask\r\n\r\n> Make me a Xenon widget that shows my GPU temperature as a big number, in a folder called gpu-temp.\r\n\r\n## Tools\r\n\r\n| Tool | What it does |\r\n|---|---|\r\n| `xenon_status` | Is Xenon running, which SDK version, are community widgets on, is a dashboard open |\r\n| `sdk_reference` | The Widget SDK reference, by section |\r\n| `new_widget` | A working starter (manifest, HTML, CSS, JS) in a new or empty folder |\r\n| `check_widget` | The checks an install runs, without installing: package rules, sandbox, Store review notes |\r\n| `install_widget` | Install or update from the folder, put the widget on your dashboard and show its page |\r\n| `widget_issues` | Errors, blocked requests, whether its permissions are approved, how heavy it is |\r\n| `widget_screenshot` | A picture of the tile as it is on screen now |\r\n| `my_widgets` | Your own widgets; with an id and a folder, writes one out to keep working on it |\r\n| `share_widget` | A share code anyone can paste into Xenon, plus the Store review notes |\r\n\r\nThe folder's name is the widget id unless you pass `id` (a-z, 0-9 and dashes).\r\n\r\n## What it can and cannot do\r\n\r\n- It never approves a widget's permissions. A widget that reads data or runs actions waits for you to allow it on\r\n  the dashboard, as any widget does.\r\n- It can read, change and share only widgets you made, never ones from the Store or from someone's share code.\r\n- It works only from this computer: a paired phone or tablet cannot reach it.\r\n- Errors thrown in widget code arrive as \"Script error.\" because widgets run in a sandbox on another origin. Wrap\r\n  code in `try`/`catch` and `console.error` the message: those arrive in full.\r\n- The screenshot is that box of the screen, so a window over the dashboard shows in it. It does not work on Linux\r\n  under Wayland.\r\n\r\n## Settings\r\n\r\n| Variable | Default | |\r\n|---|---|---|\r\n| `XENON_URL` | `http://127.0.0.1:3030` | Another local Xenon address. Loopback only. |\r\n| `XENON_MCP_STORE` | `~/.xenon/mcp.json` | Where the connection is remembered. |\r\n\r\n## License\r\n\r\nPart of Xenon, under the same custom non-commercial license: see `LICENSE`.\r\n","readmeFilename":"README.md"}