TOYBOX MCP Server
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.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@TOYBOX MCP Server Publish this code snippet to my TOYBOX"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 Server
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
{
"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 |
| 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:
toybox/
āāā src/artifacts/ # Your published artifacts
āāā TOYBOX_CONFIG.json # Site configuration
āāā (template files...) # React app infrastructureTroubleshooting
Authentication Issues
gh auth status # Check authentication
gh auth login # Re-authenticate if neededBuild 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.
Available Tools
5 toolsinitialize_toyboxA
Initialize a complete TOYBOX with local repository, GitHub remote, and Pages setup
Inputs: repoName, templateOwner, templateRepo, config, +4 more.
list_artifactsB
List all published artifacts in your TOYBOX
Inputs: no named parameters.
publish_artifactC
Publish a new artifact to your TOYBOX. Artifacts are uniquely identified by a slug-based ID with UUID suffix.
Inputs: code (required), metadata (required).
setup_remoteB
Set up a GitHub remote repository for an existing local TOYBOX (one-time setup)
Inputs: repoName (required), isPrivate, enablePages.
update_configC
Update TOYBOX configuration (title, theme, layout, etc.)
Inputs: config (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogā¦
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose with no overlap: initialization, listing artifacts, publishing artifacts, remote setup, and configuration updates. The descriptions clearly differentiate their functions, making misselection unlikely.
All tools follow a consistent verb_noun pattern (e.g., initialize_toybox, list_artifacts, publish_artifact), with no deviations in style or convention. This predictability enhances usability and clarity.
With 5 tools, the server is well-scoped for managing a TOYBOX system, covering core operations like setup, artifact management, and configuration without being overly sparse or bloated. Each tool serves a clear, necessary function.
The toolset provides good coverage for the TOYBOX domain, including initialization, artifact lifecycle (list/publish), remote setup, and configuration updates. A minor gap exists in artifact deletion or modification, but agents can likely work around this for basic workflows.
Related MCP Connectors
Build & publish sites ā or a game, a calendar, a report ā by chatting with Claude. Live in seconds.
Deploy static sites and connect custom domains from Claude, Cursor, or any MCP agent.
Publish AI-generated HTML to a private, unguessable link, straight from Claude or ChatGPT.
Publish AI-generated HTML to a live page on your own domain ā from Claude, ChatGPT, or Cursor.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceConnects Claude Desktop to GitHub repositories, enabling users to perform git operations and GitHub API interactions through natural conversation.497 npm-
- AlicenseNot gradedqualityNot gradedmaintenanceConnects Claude Desktop directly to GitHub repositories and git commands, enabling users to clone repos, check status, commit changes, push code, create repositories, and manage GitHub resources through natural conversation.497 npm-
- AlicenseAqualityDmaintenanceEnables users to upload files and generate tracked, shareable links directly from AI agents like Claude Desktop or Cursor. It supports publishing various file formats including text, PDFs, and images, while providing tools for artifact management and analytics.851 npmMIT
- AlicenseNot gradedqualityDmaintenancePublishes HTML pages straight from your AI assistant to a shareable URL, then lets you manage them - update, list, search, fetch, and delete pages in a public or private workspace. Turns "share what I just made" into a single tool call from Claude, Cursor, or any MCP client.MIT