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-Blocksproto_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 practicesproto_blocks_styling- Styling with Vanilla CSS or Tailwindproto_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
License
MIT