Skip to main content
Glama

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

  1. GitHub Account: Create one at github.com

  2. GitHub CLI: Install from cli.github.com

  3. 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.

Available Tools

5 tools
initialize_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

    A3.6/5.0

    Scored across 5 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Connects Claude Desktop to GitHub repositories, enabling users to perform git operations and GitHub API interactions through natural conversation.
      497 npm
      -
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Connects 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
      -
    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      8
      51 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Publishes 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