Connects to a Supabase database to manage website projects, browse professionally crafted design styles and color palettes, and retrieve AI-powered design recommendations for local businesses.
Click on "Install 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., "@WebForge MCP Serversuggest a design style and color palette for a local pet grooming shop"
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.
WebForge MCP Server
Model Context Protocol (MCP) server for WebForge - Create and manage websites for local businesses through any MCP-compatible IDE.
Features
π¨ 100 Design Styles - Access to professionally crafted design styles
π 40 Color Palettes - Curated color schemes for different business types
π€ Smart Recommendations - AI-powered style+palette combinations based on business type
π Project Management - Create and manage website projects
π Compatibility Matrix - Intelligent scoring system for design combinations
π§ MCP Protocol - Works with Claude Code, Cursor, Google Antigravity, and other MCP clients
Compatible IDEs
Claude Code
Add to your Claude configuration:
Cursor
Install the package:
npm install -g @joytorm/webforge-mcpAdd to Cursor's MCP settings:
{ "webforge": { "command": "webforge-mcp" } }
Google Antigravity
Install:
npm install -g @joytorm/webforge-mcpConfigure in Antigravity's MCP servers section:
{ "name": "webforge", "command": "webforge-mcp", "transport": "stdio" }
Prerequisites
1. Supabase Setup
You need to create the required database tables in your Supabase instance. Execute this SQL in your Supabase SQL Editor:
2. Seed the Database
After creating the tables, run the seeding script to populate them with WebForge's design data:
Installation
Global Installation (Recommended)
Local Development
Available Tools
Design Discovery
webforge_list_styles- List all 100 available design styleswebforge_list_palettes- List all 40 available color paletteswebforge_recommend_design- Get top 5 style+palette recommendations for a business type
Design Details
webforge_get_style_details- Get complete style information including CSS tokenswebforge_get_palette_details- Get complete palette information including all colors
Project Management
webforge_create_project- Create a new website projectwebforge_list_projects- List existing projects with filteringwebforge_get_project- Get detailed project informationwebforge_update_project- Update project settings
Usage Examples
Get Design Recommendations
Create a New Project
Get Style Details
Environment Variables
The MCP server connects to the WebForge Supabase instance automatically. No additional environment configuration is required.
Supabase URL:
https://supabase.optihost.proAuthentication: Handled automatically via service keys
Development
API Reference
Recommendation Engine
The recommendation system uses a compatibility matrix that scores style+palette combinations from 1-5 based on:
Industry alignment - How well the style fits the business type
Visual harmony - Color theory and design compatibility
Brand perception - Mood and professional appropriateness
User experience - Usability for the target audience
Style Categories
Minimalist - Clean, modern designs with lots of whitespace
Creative - Bold, artistic layouts with unique elements
Professional - Traditional business-focused designs
E-commerce - Product-focused layouts with strong CTAs
Local Business - Community-oriented designs with local appeal
Palette Moods
Professional - Conservative colors for business credibility
Friendly - Warm, welcoming colors for service businesses
Modern - Contemporary color schemes for tech/startups
Elegant - Sophisticated palettes for premium brands
Energetic - Vibrant colors for fitness/entertainment
Contributing
Fork the repository
Create your feature branch:
git checkout -b feature/amazing-featureCommit your changes:
git commit -m 'Add amazing feature'Push to the branch:
git push origin feature/amazing-featureOpen a Pull Request
License
This project is licensed under the MIT License - see the LICENSE file for details.
Support
GitHub Issues: https://github.com/joytorm/webforge-mcp/issues
Email: contact@joytorm.com
Documentation: WebForge MCP Docs
Built with β€οΈ by the Joytorm team