aesthetic.computer / core
Monorepo for Aesthetic.Computer aesthetic.computer
fork atom
core / mcp-server / SUBMISSION_GUIDE.md
at main 5.6 kB view raw view code
Jeffrey Alan Scudder restore 4270 files deleted by papers oven auto-build (aaa62f4a1)
ea1fd8af

MCP Registry Submission Guide#

This guide covers how to submit the @aesthetic.computer/mcp server to various MCP registries and directories.

Official MCP Registry#

The official registry at https://registry.modelcontextprotocol.io uses a command-line publisher tool.

Prerequisites#

  1. You've already published to npm: ✅ @aesthetic.computer/mcp@1.0.0
  2. You need to authenticate using one of these methods:
    • GitHub OAuth (login as whistlegraph)
    • Domain verification for aesthetic.computer

Submission Steps#

  1. Clone the registry repository:

    git clone https://github.com/modelcontextprotocol/registry
cd registry

  2. Build the publisher tool:

    make publisher

  3. Authenticate:

    # Option 1: GitHub OAuth (as whistlegraph user)
./bin/mcp-publisher auth github

# Option 2: Domain verification (for aesthetic.computer namespace)
./bin/mcp-publisher auth dns aesthetic.computer

  4. Publish the server:

    ./bin/mcp-publisher publish \
  --package @aesthetic.computer/mcp \
  --name "aesthetic.computer" \
  --description "Publish creative coding pieces to aesthetic.computer" \
  --category "creative-tools" \
  --tags "creative-coding,javascript,kidlisp,art,music"

Alternative Registries & Directories#

1. MCP.so Community Registry#

Visit https://mcp.so/ and search for submission instructions.

2. Cline MCP Marketplace#

Repository: https://github.com/cline/mcp-marketplace

Create a PR adding a JSON file for your server:

{
  "name": "aesthetic.computer",
  "package": "@aesthetic.computer/mcp",
  "description": "Publish creative coding pieces to aesthetic.computer",
  "author": "Jeffrey Alan Scudder",
  "repository": "https://github.com/whistlegraph/aesthetic-computer/tree/main/mcp-server",
  "homepage": "https://aesthetic.computer",
  "categories": ["creative-tools", "publishing"],
  "tags": ["javascript", "kidlisp", "creative-coding", "art", "music"]
}

3. PulseMCP Directory#

Visit https://www.pulsemcp.com/ and look for "Submit Server" option.

Package Metadata for Submission#

Use this information when filling out registry forms:

Basic Info#

  • Name: aesthetic.computer
  • Package: @aesthetic.computer/mcp
  • Version: 1.0.0
  • License: MIT
  • Author: Jeffrey Alan Scudder

Description#

MCP server for aesthetic.computer - enabling AI assistants to create and publish
JavaScript pieces, KidLisp art, and clock melodies. Supports anonymous publishing
with instant shareable URLs.

Tags/Keywords#

creative-coding, javascript, kidlisp, art, music, generative, publishing,
web-platform, anonymous, real-time

Categories#

  • Creative Tools
  • Publishing
  • Development Tools

Features#

  • ✨ Publish JavaScript pieces to aesthetic.computer
  • 🎨 Create and share KidLisp art (Lisp-based creative coding)
  • 🎵 Compose clock melodies with pronounceable short codes
  • 📚 Access API documentation programmatically
  • 🚀 Get starter templates and references
  • 🔄 Content deduplication - same code returns same URL
  • 🌐 Anonymous publishing - no account required

Compatible Clients#

  • Claude Desktop
  • Claude Code (VS Code Extension)
  • ChatGPT Developer Mode
  • Cursor
  • Any MCP-compatible client

Installation Command#

npx @aesthetic.computer/mcp

Configuration Example (Claude Desktop)#

{
  "mcpServers": {
    "aesthetic-computer": {
      "command": "npx",
      "args": ["-y", "@aesthetic.computer/mcp"],
      "env": {
        "AC_TOKEN": "optional-bearer-token"
      }
    }
  }
}

Social Media Announcement Template#

Once published to registries, you can announce it:

Twitter/X#

🎨 Just published @aesthetic.computer MCP server!

Now Claude, ChatGPT & other AI assistants can:
✨ Create JavaScript pieces
🎨 Generate KidLisp art
🎵 Compose clock melodies

Try it: npx @aesthetic.computer/mcp

#MCP #CreativeCoding #AI

Mastodon/Bluesky#

🎨 The aesthetic.computer MCP server is now live!

AI assistants (Claude, ChatGPT, etc.) can now create and publish creative coding
pieces directly to aesthetic.computer.

✨ JavaScript pieces
🎨 KidLisp art (Lisp-based creative coding)
🎵 Clock melodies with shareable URLs
🌐 Anonymous publishing - no account needed

Install: npx @aesthetic.computer/mcp
Docs: https://aesthetic.computer/api

#ModelContextProtocol #CreativeCoding #AI #OpenSource

Monitoring & Updates#

After submission:

  1. Monitor npm stats: https://www.npmjs.com/package/@aesthetic.computer/mcp
  2. Check registry listings: Search for "aesthetic.computer" on:
  3. Update version: When releasing new versions, re-publish to registries
  4. Respond to issues: Monitor GitHub issues for user feedback

Version Updates#

When releasing a new version:

  1. Update package.json version
  2. Build: npm run build
  3. Publish to npm: npm publish
  4. Re-publish to MCP registry: ./bin/mcp-publisher publish ...
  5. Update README with new features
  6. Create GitHub release tag

Status:

  • ✅ Published to npm (1.0.0)
  • ⏳ Pending MCP registry submission
  • ⏳ Pending community registry listings