Proto-Blocks MCP Server

The Ultimate MCP Server for Proto-Blocks - providing comprehensive AI guidance for creating WordPress Gutenberg blocks with PHP templates.

Features

• 12 Specialized Tools for Proto-Blocks development guidance
• Complete Documentation covering all aspects of block creation
• Examples from basic to expert level complexity
• Troubleshooting Guides for common issues
• Block Generator to create blocks from descriptions
• No Build Step Required - runs directly with npx

Installation

Claude Desktop

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "Proto-Blocks MCP": {
      "command": "npx",
      "args": ["-y", "github:GustavoGomez092/proto-blocks-mcp"]
    }
  }
}

Local Development

cd mcp
npm install
node index.js

Available Tools

Getting Started

• proto_blocks_get_started - Comprehensive introduction to Proto-Blocks
• proto_blocks_quick_reference - Quick cheat sheet for common patterns

Documentation

• proto_blocks_field_types - Complete field type documentation (text, wysiwyg, image, link, repeater, innerblocks)
• proto_blocks_control_types - Complete control type documentation (text, select, toggle, range, color, etc.)
• proto_blocks_templates - PHP template patterns and best practices
• proto_blocks_styling - Styling with Vanilla CSS or Tailwind
• proto_blocks_interactivity - Frontend interactivity (plain JS, ES modules, WordPress Interactivity API)
• proto_blocks_schema - Complete block.json schema reference

Examples & Troubleshooting

• proto_blocks_examples - Working examples at all complexity levels (basic, intermediate, advanced, expert)
• proto_blocks_troubleshooting - Solutions for common issues

Advanced Features

• proto_blocks_repeaters - Comprehensive guide to repeaters (basic to complex, nested repeaters, Interactivity API integration)

Block Generation

• proto_blocks_generate - Generate complete blocks from a description

Usage Examples

Get Started

Use the proto_blocks_get_started tool to learn about Proto-Blocks

Get Field Details

Use proto_blocks_field_types with fieldType="repeater" to learn about repeater fields

Get Examples

Use proto_blocks_examples with complexity="advanced" for advanced examples

Learn About Repeaters

Use proto_blocks_repeaters for complete repeater documentation
Use proto_blocks_repeaters with topic="nested" for nested repeater patterns

Generate a Block

Use proto_blocks_generate with:
- name: "feature-card"
- title: "Feature Card"
- description: "A card with image, title, description, and link button"

What is Proto-Blocks?

Proto-Blocks is a WordPress plugin that enables developers to create Gutenberg blocks using PHP/HTML templates instead of React. Key features:

• PHP-First Development - Write blocks in familiar PHP
• Single Source of Truth - Everything in block.json
• Optional Tailwind CSS - Built-in Tailwind support
• WordPress Interactivity API - Full support for reactive UIs
• Template Caching - Optimized performance

Resources

• Proto-Blocks Documentation
• MCP Server Repository

License

MIT