{"_id":"@aesthetic.computer/mcp","_rev":"2-421af30d8e467ab57055fba1a49a4118","name":"@aesthetic.computer/mcp","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@aesthetic.computer/mcp","version":"1.0.0","keywords":["mcp","model-context-protocol","aesthetic-computer","creative-coding","kidlisp"],"author":{"name":"Jeffrey Alan Scudder"},"license":"MIT","_id":"@aesthetic.computer/mcp@1.0.0","maintainers":[{"name":"whistlegraph","email":"mail@aesthetic.computer"}],"bin":{"aesthetic-computer-mcp":"dist/index.js"},"dist":{"shasum":"deaf25a5a2f1c7cffd22e3bb616612445d4f9fc1","tarball":"https://registry.npmjs.org/@aesthetic.computer/mcp/-/mcp-1.0.0.tgz","fileCount":38,"integrity":"sha512-bfqLCgwl1WDysGSayo32LjJcbJx0GSAquFsMitgJbfmFKs/YEedWlwpgZVr7xmANkGe7/d8vmAbhQnjFOf4s+w==","signatures":[{"sig":"MEQCIFGKXeNwJzuwDKJV8F5SH/yLAc0dj5QVPR1svOXkVE9pAiBF2zGhkFo8K4JfvpgAFtu1j+R0DFli9yjAtG3zJXzRLg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":37052},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"19210e24e52e5c14fcd52be433f8bdaef3ac069d","scripts":{"dev":"tsc --watch","build":"tsc","prepare":"npm run build"},"_npmUser":{"name":"whistlegraph","email":"mail@aesthetic.computer"},"_npmVersion":"10.9.4","description":"MCP server for publishing and exploring pieces on aesthetic.computer","directories":{},"_nodeVersion":"22.22.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.0.0_1770880527209_0.2112424614177537","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@aesthetic.computer/mcp","version":"1.0.1","mcpName":"io.github.whistlegraph/aesthetic-computer","description":"MCP server for publishing and exploring pieces on aesthetic.computer","type":"module","main":"dist/index.js","bin":{"aesthetic-computer-mcp":"dist/index.js"},"scripts":{"build":"tsc","dev":"tsc --watch","prepare":"npm run build"},"keywords":["mcp","model-context-protocol","aesthetic-computer","creative-coding","kidlisp"],"author":{"name":"Jeffrey Alan Scudder"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/whistlegraph/aesthetic-computer.git","directory":"mcp-server"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.4"},"devDependencies":{"@types/node":"^22.10.2","typescript":"^5.7.2"},"engines":{"node":">=18"},"_id":"@aesthetic.computer/mcp@1.0.1","gitHead":"453766a447ce67a7c57261f034c607a403b948fb","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/whistlegraph/aesthetic-computer/issues"},"homepage":"https://github.com/whistlegraph/aesthetic-computer#readme","_nodeVersion":"22.22.0","_npmVersion":"10.9.4","dist":{"integrity":"sha512-wpjdVM4zq6plq2Gck+fnxSTTPtTAqAfbJNpgNNuauj6PIlbl7l/8gE+dDHP70btfYlzgAXM9bfBwzgAxW+3OuA==","shasum":"9d5a5e8b66e0de835b8d4c9d19685a4bcc1288ab","tarball":"https://registry.npmjs.org/@aesthetic.computer/mcp/-/mcp-1.0.1.tgz","fileCount":40,"unpackedSize":45688,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIF2ruFC042La3NakPsAXmq4DZ2K6hIjafSgiSPvlqJcrAiEA4j+gaLwi8EgCv0IA0kicGTOeXQQQsnrlkBXmpV+l3hw="}]},"_npmUser":{"name":"whistlegraph","email":"mail@aesthetic.computer"},"directories":{},"maintainers":[{"name":"whistlegraph","email":"mail@aesthetic.computer"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_1.0.1_1770882250695_0.7503967429879022"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-12T07:15:27.125Z","modified":"2026-02-12T07:44:10.988Z","1.0.0":"2026-02-12T07:15:27.386Z","1.0.1":"2026-02-12T07:44:10.846Z"},"author":{"name":"Jeffrey Alan Scudder"},"license":"MIT","keywords":["mcp","model-context-protocol","aesthetic-computer","creative-coding","kidlisp"],"description":"MCP server for publishing and exploring pieces on aesthetic.computer","maintainers":[{"name":"whistlegraph","email":"mail@aesthetic.computer"}],"readme":"# @aesthetic.computer/mcp\n\n[![npm version](https://badge.fury.io/js/@aesthetic.computer%2Fmcp.svg)](https://www.npmjs.com/package/@aesthetic.computer/mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nMCP (Model Context Protocol) server for [aesthetic.computer](https://aesthetic.computer) - enabling AI assistants to create and publish creative coding pieces.\n\n## What is this?\n\nThis MCP server allows AI assistants like **Claude**, **ChatGPT**, and other MCP-compatible tools to:\n- ✨ **Publish JavaScript pieces** to aesthetic.computer\n- 🎨 **Create and share KidLisp art** (a Lisp-based creative coding language)\n- 🎵 **Compose clock melodies** with pronounceable short codes\n- 📚 **Access API documentation** programmatically\n- 🚀 **Get starter templates** and references\n- 🔄 **Content deduplication** - same code returns same URL\n- 🌐 **Anonymous publishing** - no account required\n\n## Installation\n\n### NPM Global Install\n\n```bash\nnpm install -g @aesthetic.computer/mcp\n```\n\n### NPX (No Install - Recommended)\n\n```bash\nnpx @aesthetic.computer/mcp\n```\n\nNo installation required! The `-y` flag in MCP configs will automatically download and run the latest version.\n\n## Configuration\n\n### Claude Desktop\n\nAdd to your `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"aesthetic-computer\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@aesthetic-computer/mcp\"],\n      \"env\": {\n        \"AC_TOKEN\": \"your-auth0-bearer-token-here\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code (VS Code Extension)\n\nAdd to your `.vscode/mcp.json` or `~/.claude/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"aesthetic-computer\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@aesthetic-computer/mcp\"],\n      \"env\": {\n        \"AC_TOKEN\": \"your-auth0-bearer-token-here\"\n      }\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to your Cursor MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"aesthetic-computer\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@aesthetic-computer/mcp\"]\n    }\n  }\n}\n```\n\n### ChatGPT Developer Mode\n\nChatGPT now supports MCP servers! Add to your ChatGPT configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"aesthetic-computer\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@aesthetic.computer/mcp\"]\n    }\n  }\n}\n```\n\nSee [ChatGPT Developer Mode docs](https://platform.openai.com/docs/guides/developer-mode) for setup instructions.\n\n### Authentication (Optional)\n\nThe `AC_TOKEN` environment variable is **optional**. If not provided:\n- All publishing is **anonymous** (guest mode)\n- Pieces are still publicly accessible\n- To associate pieces with your account, provide a Bearer token from aesthetic.computer\n\n## Available Tools\n\n### `publish_piece`\n\nPublish a JavaScript piece to aesthetic.computer.\n\n**Input:**\n```json\n{\n  \"source\": \"export function boot($) { ... }\\nexport function paint($) { ... }\",\n  \"name\": \"my-piece\"\n}\n```\n\n**Output:**\n```json\n{\n  \"code\": \"drift\",\n  \"url\": \"https://aesthetic.computer/drift\",\n  \"cached\": false\n}\n```\n\n### `publish_kidlisp`\n\nPublish KidLisp code.\n\n**Input:**\n```json\n{\n  \"source\": \"(wipe blue)\\n(ink yellow)\\n(circle (/ w 2) (/ h 2) 100)\"\n}\n```\n\n**Output:**\n```json\n{\n  \"code\": \"xyz789\",\n  \"url\": \"https://aesthetic.computer/xyz789\",\n  \"cached\": false\n}\n```\n\n### `publish_clock`\n\nPublish a clock melody.\n\n**Input:**\n```json\n{\n  \"source\": \"c4 e4 g4 c5 g4 e4 c4\"\n}\n```\n\n**Output:**\n```json\n{\n  \"code\": \"bako\",\n  \"url\": \"https://aesthetic.computer/clock~bako\",\n  \"cached\": false\n}\n```\n\n### `get_api_info`\n\nFetch the full API documentation.\n\n## Available Resources\n\n### `aesthetic-computer://piece-template`\n\nReturns a starter template for a new aesthetic.computer piece with all lifecycle functions (boot, paint, sim, act).\n\n### `aesthetic-computer://kidlisp-reference`\n\nQuick reference guide for KidLisp syntax and common functions.\n\n## Available Prompts\n\n### `create-piece`\n\nA guided prompt for creating an aesthetic.computer piece.\n\n**Arguments:**\n- `name` (required): Name of the piece\n- `description` (required): What the piece should do\n\n## Why Use This?\n\n- **🎨 Creative Coding Made Easy**: Let AI assistants write aesthetic.computer pieces for you\n- **⚡ Instant Publishing**: Go from idea to live URL in seconds\n- **🔗 Shareable URLs**: Every piece gets a clean, shareable link\n- **🆓 No Account Required**: Anonymous publishing works out of the box\n- **♻️ Smart Deduplication**: Identical code returns the same URL\n- **🌍 Open Platform**: All pieces are publicly accessible\n\n## Example Conversations\n\nOnce configured, you can ask your AI assistant:\n\n### JavaScript Pieces\n> \"Create a piece that draws a bouncing ball\"\n>\n> \"Make an interactive drawing canvas where I can paint with my mouse\"\n>\n> \"Build a particle system that responds to sound\"\n\n### KidLisp Art\n> \"Make a KidLisp piece with a yellow circle on a blue background\"\n>\n> \"Create generative art using KidLisp with random shapes\"\n\n### Clock Melodies\n> \"Publish a clock melody using the C major scale\"\n>\n> \"Compose a pentatonic melody for the clock\"\n\n### Learning & Templates\n> \"Show me the piece template\"\n>\n> \"What functions can I use in KidLisp?\"\n\nThe AI will use the MCP tools to create and publish pieces automatically, returning live URLs you can visit immediately!\n\n## Development\n\n```bash\n# Clone the repo\ngit clone https://github.com/whistlegraph/aesthetic-computer\ncd aesthetic-computer/mcp-server\n\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Test locally\nnode dist/index.js\n```\n\n## Links\n\n- 🌐 [aesthetic.computer](https://aesthetic.computer)\n- 📖 [API Documentation](https://aesthetic.computer/api)\n- 🎨 [KidLisp Documentation](https://kidlisp.com)\n- 📝 [Write a Piece Guide](https://github.com/whistlegraph/aesthetic-computer/blob/main/WRITE-A-PIECE.md)\n- 🔧 [MCP Specification](https://modelcontextprotocol.io)\n\n## License\n\nMIT\n\n## Author\n\nJeffrey Alan Scudder\n","readmeFilename":"README.md","homepage":"https://github.com/whistlegraph/aesthetic-computer#readme","repository":{"type":"git","url":"git+https://github.com/whistlegraph/aesthetic-computer.git","directory":"mcp-server"},"bugs":{"url":"https://github.com/whistlegraph/aesthetic-computer/issues"}}