Page Design Guide MCP Server

MCP server providing modern web design guidance, color psychology, typography, layout patterns, and UI best practices for AI assistants

Local serverstdio

What is the Page Design Guide MCP MCP server?

MCP server providing modern web design guidance, color psychology, typography, layout patterns, and UI best practices for AI assistants. The page design guide mcp mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 11 defined tools rather than through you.

What it actually does

An MCP (Model Context Protocol) server that provides design guidance to help LLMs generate better, more modern web pages. This server focuses on teaching design principles and best practices rather than providing code templates.

  • [layout] Layout Guidance - When and how to use F-Pattern, Z-Pattern, Bento Grid, etc
  • [palette] Color Psychology - Color meanings, scheme types, and palette recommendations
  • [type] Typography - Hierarchy, font pairings, and readability best practices
  • [grid] Responsive Design - Mobile-first strategies and breakpoint guidance
  • [layers] Visual Hierarchy - Principles of contrast, whitespace, alignment
  • [component] Component Guidance - Design principles for buttons, cards, forms, navigation

Adding it to your client

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.

Its toolset

Everything the assistant can do here goes through one of these:

  • get_design_principles — Get foundational design principles (hierarchy, whitespace, contrast, alignment, etc.) with guidelines and common mistakes to avoid
  • get_layout_guidance — Get layout recommendations based on page type. Explains when and why to use F-Pattern, Z-Pattern, Bento Grid, Split Screen, etc
  • get_color_guidance — Get color psychology, scheme types (monochromatic, complementary, etc.), and palette recommendations based on mood and industry
  • get_typography_guidance — Get typography hierarchy, font pairing recommendations for different styles, and best practices for readable text
  • get_section_guidance — Get guidance for specific page sections: header, hero, features, testimonials, pricing, cta, footer, faq - including purpose, structure, and best
  • get_responsive_guidance — Get responsive design principles, breakpoint strategies, and mobile-first best practices
  • get_component_guidance — Get design guidance for UI components: buttons, cards, forms, navigation, modals, icons - including sizing, states, and accessibility
  • get_animation_guidance — Get animation principles, timing guidelines, and performance considerations for different types of motion
  • get_accessibility_guidance — Get accessibility requirements including contrast ratios, focus states, semantic HTML, and motion preferences
  • get_modern_trends — Get current web design trends (2024-2026) with guidance on when and how to use them appropriately
  • review_design_approach — Describe your design and get feedback with scores, identified strengths, concerns, and recommendations

Configuration

  • Node.js >= 18.0.0 - Claude Desktop app

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 11 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Page Design Guide MCP.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the page design guide mcp mcp server does with a few real requests.

When to reach for it

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Page Design Guide MCP's toolset — get_design_principles, get_layout_guidance, get_color_guidance and 8 more — is a fair guide to whether it matches your workflow. It is maintained by chihebnabil; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Available tools

ToolWhat it does
get_design_principlesGet foundational design principles (hierarchy, whitespace, contrast, alignment, etc.) with guidelines and common mistakes to avoid.
get_layout_guidanceGet layout recommendations based on page type. Explains when and why to use F-Pattern, Z-Pattern, Bento Grid, Split Screen, etc.
get_color_guidanceGet color psychology, scheme types (monochromatic, complementary, etc.), and palette recommendations based on mood and industry.
get_typography_guidanceGet typography hierarchy, font pairing recommendations for different styles, and best practices for readable text.
get_section_guidanceGet guidance for specific page sections: header, hero, features, testimonials, pricing, cta, footer, faq - including purpose, structure, and best practices.
get_responsive_guidanceGet responsive design principles, breakpoint strategies, and mobile-first best practices.
get_component_guidanceGet design guidance for UI components: buttons, cards, forms, navigation, modals, icons - including sizing, states, and accessibility.
get_animation_guidanceGet animation principles, timing guidelines, and performance considerations for different types of motion.
get_accessibility_guidanceGet accessibility requirements including contrast ratios, focus states, semantic HTML, and motion preferences.
get_modern_trendsGet current web design trends (2024-2026) with guidance on when and how to use them appropriately.
review_design_approachDescribe your design and get feedback with scores, identified strengths, concerns, and recommendations.

How to install the Page Design Guide MCP MCP server

{
  "mcpServers": {
    "page-design-guide": {
      "command": "npx",
      "args": ["-y", "page-design-guide-mcp"]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Node.js >= 18.0.0 - Claude Desktop app

Example prompts to try

  • Use Page Design Guide MCP to get design principles.
  • Use Page Design Guide MCP to get layout guidance.
  • Use Page Design Guide MCP to get color guidance.

Frequently asked questions

It connects Page Design Guide MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 11 tools (get_design_principles, get_layout_guidance, get_color_guidance, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Page Design Guide MCP directly.