Creates and manages repositories for storing and versioning artifacts published from Claude Desktop.
Automatically deploys published artifacts to a personal portfolio website with customizable themes and layouts.
Supports React-based artifacts that can be published to the portfolio site.
Supports TypeScript-based artifacts that can be published to the portfolio site.
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!
Related MCP server: GitHub MCP Tools
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 loginand 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
For production use, pin to a specific version:
Usage
1. Initialize Your TOYBOX
In Claude Desktop:
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:
Claude will:
Generate a unique ID for your artifact
Commit and push to GitHub
Provide the live URL
3. Manage Your Collection
Available Commands
Command | Description |
| Set up a new TOYBOX repository |
| Publish an artifact to your TOYBOX |
| Show all published artifacts |
| Modify TOYBOX settings |
Configuration Options
Title: Display name for your portfolio
Description: Subtitle text
Theme:
auto,light, ordarkLayout:
gridorlistviewFooter: Show/hide footer section
Repository Structure
When initialized, your TOYBOX repository contains:
Troubleshooting
Authentication Issues
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_toyboxfirstCheck 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.