@byscott-io/widgetsbyscott
v0.1.16
Published
Local stdio MCP that mirrors widgets.byscott.io — create, view, and share charts/markdown/html/grid/tabs/index widgets in-memory with a live browser dashboard. Successor to chartsbyscott.
Maintainers
Readme
@byscott-io/widgetsbyscott
A local stdio MCP server that lets an AI agent build charts, markdown, HTML, tables and nested layouts, and watch them appear in a live browser dashboard.
Widgets live in memory for the life of the process. Nothing is written to disk and nothing is sent anywhere — close the server and they are gone. It mirrors the tool names and argument shapes of the hosted MCP at widgets.byscott.io, so an agent can move between local and hosted without knowing which one it is talking to.
Successor to chartsbyscott.
Use it
No install required:
npx @byscott-io/widgetsbyscottIt speaks MCP over stdio, so normally you point a client at it rather than running it yourself. For Claude Code:
{
"mcpServers": {
"widgetsbyscott": {
"command": "npx",
"args": ["-y", "@byscott-io/widgetsbyscott"]
}
}
}On the first tool call it opens http://localhost:3110 in your browser. The
dashboard updates over a WebSocket as widgets are created and changed, so you
can leave it open beside the conversation.
Tools
| Tool | Does |
|---|---|
| create_widget | Create one. Requires type and title. |
| update_widget | Change a widget by id or slug; pass only the fields you want changed. |
| list_widgets | Metadata only, no content. Optional type filter, limit (default 50, max 200). |
| get_widget | One widget with full content, by id or slug. Use this to read data back for analysis. |
| delete_widget | Remove one by id or slug. |
Widget types
Leaf types carry their own content:
chart—chart_type(line,bar,pie,doughnut,radar,polarArea,bubble,scatter) plusdataand optionaloptions, in Chart.js shape:{ labels, datasets: [{ label, data }] }.markdown—source.html—html, sanitized unless you passsanitized: false.table—data, same shape aschart.
Container types take a children array of { widget_id, position?, label? }
instead of content:
grid— children laid out together.tabs— children as tabs, using each child'slabel.index— a listing of children; optionaldisplay_modeoflist,cardsortable.
Every widget has a visibility of private, account (the default) or
public, and a slug that forms its address.
Configuration
| Variable | Default | Effect |
|---|---|---|
| WBS_HTTP_PORT | 3110 | Port for the dashboard and its WebSocket. |
| WBS_NO_OPEN | unset | Set it to stop the browser being opened on the first tool call. The dashboard still runs and its URL is logged to stderr. Set to 0, false or no to keep the default opening behaviour. |
WBS_NO_OPEN is what you want in CI, on a headless host, or in any test that
calls a tool — without it, exercising a single tool hijacks whatever browser is
to hand.
Logs go to stderr only. Stdout is reserved for the MCP protocol, so anything printed there would corrupt the stream.
License
MIT.
