TOYBOX MCP Server

Zero-friction publishing platform for Claude artifacts via Model Context Protocol (MCP).

Overview

TOYBOX MCP Server enables Claude Desktop users to publish their artifacts to a personal GitHub Pages portfolio site through simple conversational commands. No technical knowledge required!

Features

🚀 Zero-friction setup: Initialize your TOYBOX with one command
📦 Instant publishing: Publish artifacts directly from Claude Desktop
🎨 Professional presentation: Automated portfolio site with responsive design
🔧 Customizable: Configure themes, layouts, and branding
📱 Mobile-friendly: Works perfectly on all devices
🔒 Secure: All code validation and safe deployment practices

Prerequisites

GitHub Account: Create one at github.com
GitHub CLI: Install from cli.github.com
Authentication: Run gh auth login and follow the browser flow

Installation

No installation required! TOYBOX uses npx for zero-friction setup.

Configuration

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\\Claude\\claude_desktop_config.json

{
  "mcpServers": {
    "toybox": {
      "command": "npx",
      "args": ["@isnbh0/toybox-mcp-server@latest"]
    }
  }
}

For production use, pin to a specific version:

{
  "mcpServers": {
    "toybox": {
      "command": "npx",
      "args": ["@isnbh0/toybox-mcp-server@1.0.0"]
    }
  }
}

Usage

1. Initialize Your TOYBOX

In Claude Desktop:

"I want to create a TOYBOX for my projects"

Claude will:

Check your GitHub authentication
Create a repository from the TOYBOX template
Enable GitHub Pages
Set up local development environment

2. Publish Artifacts

Create any artifact in Claude Desktop, then:

"Publish this to my TOYBOX"

Claude will:

Generate a unique ID for your artifact
Commit and push to GitHub
Provide the live URL

3. Manage Your Collection

"Show me all my TOYBOX projects"
"Update my TOYBOX theme to dark mode"
"Change my TOYBOX title to 'My Creative Projects'"

Available Commands

Command	Description
`initialize_toybox`	Set up a new TOYBOX repository
`publish_artifact`	Publish an artifact to your TOYBOX
`list_artifacts`	Show all published artifacts
`update_config`	Modify TOYBOX settings

Configuration Options

Title: Display name for your portfolio
Description: Subtitle text
Theme: auto, light, or dark
Layout: grid or list view
Footer: Show/hide footer section

Repository Structure

When initialized, your TOYBOX repository contains:

toybox/
├── src/artifacts/          # Your published artifacts
├── TOYBOX_CONFIG.json      # Site configuration
└── (template files...)     # React app infrastructure

Troubleshooting

Authentication Issues

gh auth status              # Check authentication
gh auth login               # Re-authenticate if needed

Build Failures

Ensure your artifact code is valid React/TypeScript
Check for syntax errors or missing imports
Verify all dependencies are available

Repository Not Found

Make sure you've run initialize_toybox first
Check that the repository exists on GitHub
Verify GitHub Pages is enabled

Contributing

This project is part of the TOYBOX ecosystem. See the main repository for contribution guidelines.

License

MIT License - see LICENSE file for details.