Motion Menu Director is an MCP server published by io.github.MotionMenu, hosted at www.motionmenu.ca. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 15 tools, including list_patterns, get_pattern, get_kit, get_design_digest, check_updates.
A design director for coding agents: it picks, validates and refuses before you build.
904 connections through 4 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
List Motion Menu patterns. Every row is "number slug <role> [tags] · title". ROLE is where the pattern goes on a page (hero, nav, pricing, background, product, form…) — filter by it when you are building a page rather than hunting an effect. The SLUG is the permanent identity — prefer it. Filter by tag (e.g. "scroll", "webgl", "seam", "commerce"), by collection slug (e.g. "seams-handoffs"), by free-text query, or by legacy section letter. Call with no arguments to see the whole catalogue and its tag vocabulary.
| Parameter | Type | Description |
|---|---|---|
| tag | string | optional tag, e.g. "scroll", "glsl", "commerce" |
| role | string | WHERE IT GOES on a page — hero, nav, footer, pricing, background, gallery, product, form, stats, testimonial, cta, content, seam, chrome, type. Start here when building a page. |
| query | string | optional substring filter on title/description |
| section | string | legacy section letter, e.g. "J" — tags supersede this |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| collection |
| string |
| optional collection slug, e.g. "webgl-3d" |
{
"name": "list_patterns",
"description": "List Motion Menu patterns. Every row is \"number slug <role> [tags] · title\". ROLE is where the pattern goes on a page (hero, nav, pricing, background, product, form…) — filter by it when you are building a page rather than hunting an effect. The SLUG is the permanent identity — prefer it. Filter by tag (e.g. \"scroll\", \"webgl\", \"seam\", \"commerce\"), by collection slug (e.g. \"seams-handoffs\"), by free-text query, or by legacy section letter. Call with no arguments to see the whole catalogue and its tag vocabulary.",
"inputSchema": {
"type": "object",
"properties": {
"tag": {
"type": "string",
"description": "optional tag, e.g. \"scroll\", \"glsl\", \"commerce\""
},
"role": {
"type": "string",
"description": "WHERE IT GOES on a page — hero, nav, footer, pricing, background, gallery, product, form, stats, testimonial, cta, content, seam, chrome, type. Start here when building a page."
},
"query": {
"type": "string",
"description": "optional substring filter on title/description"
},
"section": {
"type": "string",
"description": "legacy section letter, e.g. \"J\" — tags supersede this"
},
"collection": {
"type": "string",
"description": "optional collection slug, e.g. \"webgl-3d\""
}
}
}
}Get one pattern by number, including its complete transplantable HTML, CSS and JS. Pass framework to get a ready-to-use component wrapper (react .tsx, vue .vue, svelte .svelte, or vanilla .ts).
| Parameter | Type | Description |
|---|---|---|
| slug | string | permanent identity, e.g. "velocity-image-bend" — preferred |
| number | string | pattern number, e.g. "84" — a permanent alias for the slug |
| framework | string | component wrapper format (default: raw HTML/CSS/JS) |
{
"name": "get_pattern",
"description": "Get one pattern by number, including its complete transplantable HTML, CSS and JS. Pass framework to get a ready-to-use component wrapper (react .tsx, vue .vue, svelte .svelte, or vanilla .ts).",
"inputSchema": {
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "permanent identity, e.g. \"velocity-image-bend\" — preferred"
},
"number": {
"type": "string",
"description": "pattern number, e.g. \"84\" — a permanent alias for the slug"
},
"framework": {
"enum": [
"react",
"vue",
"svelte",
"vanilla"
],
"type": "string",
"description": "component wrapper format (default: raw HTML/CSS/JS)"
}
}
}
}Get the Motion Menu build kit: the design laws, the one-page act protocol, stack pins, known gotchas, and the full pattern index. Call this FIRST before building a page.
No parameters.
{
"name": "get_kit",
"description": "Get the Motion Menu build kit: the design laws, the one-page act protocol, stack pins, known gotchas, and the full pattern index. Call this FIRST before building a page.",
"inputSchema": {
"type": "object",
"properties": {}
}
}Get the machine-readable Motion Menu quality contract. Call before build_page. It defines anti-generic composition rules, motion lifecycle, responsive requirements, truth constraints, and release verification gates.
No parameters.
{
"name": "get_design_digest",
"description": "Get the machine-readable Motion Menu quality contract. Call before build_page. It defines anti-generic composition rules, motion lifecycle, responsive requirements, truth constraints, and release verification gates.",
"inputSchema": {
"type": "object",
"properties": {}
}
}Check whether patterns you already built with have changed. Pass the library version you last built against (from `version` in a previous check_updates or /p/manifest.json) and get back exactly which slugs were added, changed or removed — so you re-pull three patterns instead of all of them. Call with no arguments to read the current version and library counts. Record the version you get back alongside the code you generate.
| Parameter | Type | Description |
|---|---|---|
| since | string | The library version you built against. Omit to just read the current one. |
{
"name": "check_updates",
"description": "Check whether patterns you already built with have changed. Pass the library version you last built against (from `version` in a previous check_updates or /p/manifest.json) and get back exactly which slugs were added, changed or removed — so you re-pull three patterns instead of all of them. Call with no arguments to read the current version and library counts. Record the version you get back alongside the code you generate.",
"inputSchema": {
"type": "object",
"properties": {
"since": {
"type": "string",
"description": "The library version you built against. Omit to just read the current one."
}
}
}
}Intent-aware pattern recommendations. Describe what you are building — industry, style, mood, technical needs — and get scored results with reasons and compatibility suggestions. Returns metadata only (number, slug, title, role, score, reason, compatible_with). Call get_pattern to retrieve the actual code for any recommendation.
| Parameter | Type | Description |
|---|---|---|
| role | string | Optional page-role filter (hero, nav, pricing, footer, background, etc.) |
| seed | ["string","number"] | Reproducible creative seed. The same brief and seed return the same candidates; change it to explore another valid realization. |
| count | number | Max results (default 5, max 20) |
| intent * | string | What you are building, e.g. "premium SaaS landing page for enterprise AI startup" or "dark minimal portfolio with dramatic 3D hero" |
| context | array | Slugs or numbers already chosen for this page (order does not matter here). Recommendations that clash with any of them are excluded, a pattern already at its own max_per_page in context is skipped, and a WebGL pattern in context or in the results auto-adds device-tier-gate (245) as the fallback. |
| history | array | Recently used pattern slugs or numbers. They receive a strong cooldown penalty instead of dominating every session. |
| exclusions | array | Pattern slugs or numbers that must not be returned. |
{
"name": "recommend_patterns",
"description": "Intent-aware pattern recommendations. Describe what you are building — industry, style, mood, technical needs — and get scored results with reasons and compatibility suggestions. Returns metadata only (number, slug, title, role, score, reason, compatible_with). Call get_pattern to retrieve the actual code for any recommendation.",
"inputSchema": {
"type": "object",
"required": [
"intent"
],
"properties": {
"role": {
"type": "string",
"description": "Optional page-role filter (hero, nav, pricing, footer, background, etc.)"
},
"seed": {
"type": [
"string",
"number"
],
"description": "Reproducible creative seed. The same brief and seed return the same candidates; change it to explore another valid realization."
},
"count": {
"type": "number",
"description": "Max results (default 5, max 20)"
},
"intent": {
"type": "string",
"description": "What you are building, e.g. \"premium SaaS landing page for enterprise AI startup\" or \"dark minimal portfolio with dramatic 3D hero\""
},
"context": {
"type": "array",
"items": {
"type": "string"
},
"description": "Slugs or numbers already chosen for this page (order does not matter here). Recommendations that clash with any of them are excluded, a pattern already at its own max_per_page in context is skipped, and a WebGL pattern in context or in the results auto-adds device-tier-gate (245) as the fallback."
},
"history": {
"type": "array",
"items": {
"type": "string"
},
"description": "Recently used pattern slugs or numbers. They receive a strong cooldown penalty instead of dominating every session."
},
"exclusions": {
"type": "array",
"items": {
"type": "string"
},
"description": "Pattern slugs or numbers that must not be returned."
}
}
}
}Turn a business/page brief into three deliberately different design genomes before choosing components. Each direction defines layout grammar, typography, imagery, motion physics, density rhythm, and explicit avoid rules. Pass a returned direction_id into build_page with the same brief and seed.
| Parameter | Type | Description |
|---|---|---|
| seed | ["string","number"] | Reproducible creative seed. |
| brief * | string | Business, audience, offer, conversion goal, real assets, and brand constraints. |
{
"name": "propose_directions",
"description": "Turn a business/page brief into three deliberately different design genomes before choosing components. Each direction defines layout grammar, typography, imagery, motion physics, density rhythm, and explicit avoid rules. Pass a returned direction_id into build_page with the same brief and seed.",
"inputSchema": {
"type": "object",
"required": [
"brief"
],
"properties": {
"seed": {
"type": [
"string",
"number"
],
"description": "Reproducible creative seed."
},
"brief": {
"type": "string",
"description": "Business, audience, offer, conversion goal, real assets, and brand constraints."
}
}
}
}Design a complete page from intent. Returns an act map — 5–7 acts in page order, each with a purpose, recommended patterns (by slug), and a density rating (loud/quiet). Follows the one-page protocol: density wave pacing, one GL spectacle, 12–18 viewport-heights. Feed the result straight to get_pattern to retrieve the code. Returns metadata only — no pattern bodies. PREMIUM FLOOR: load-bearing acts (arrival, proof, action, close) compose only from visually graded S/A patterns. When no S/A exists for one of those slots the result carries premium.shippable=false, the exact gaps, and a redress prescription naming the patterns that would unblock them — do not build or present a composition flagged not-shippable as premium. No argument disables this.
| Parameter | Type | Description |
|---|---|---|
| acts | number | Number of acts (default 6, range 5–7) |
| seed | ["string","number"] | Reproducible creative seed. |
| intent * | string | What the page is for, e.g. "luxury real estate landing page" or "SaaS startup launch with pricing" |
| history | array | Recently used pattern slugs or numbers to cool down. |
| exclusions | array | Pattern slugs or numbers that must not be used. |
| direction_id | string | One direction_id returned by propose_directions for this same intent/seed. |
{
"name": "build_page",
"description": "Design a complete page from intent. Returns an act map — 5–7 acts in page order, each with a purpose, recommended patterns (by slug), and a density rating (loud/quiet). Follows the one-page protocol: density wave pacing, one GL spectacle, 12–18 viewport-heights. Feed the result straight to get_pattern to retrieve the code. Returns metadata only — no pattern bodies. PREMIUM FLOOR: load-bearing acts (arrival, proof, action, close) compose only from visually graded S/A patterns. When no S/A exists for one of those slots the result carries premium.shippable=false, the exact gaps, and a redress prescription naming the patterns that would unblock them — do not build or present a composition flagged not-shippable as premium. No argument disables this.",
"inputSchema": {
"type": "object",
"required": [
"intent"
],
"properties": {
"acts": {
"type": "number",
"description": "Number of acts (default 6, range 5–7)"
},
"seed": {
"type": [
"string",
"number"
],
"description": "Reproducible creative seed."
},
"intent": {
"type": "string",
"description": "What the page is for, e.g. \"luxury real estate landing page\" or \"SaaS startup launch with pricing\""
},
"history": {
"type": "array",
"items": {
"type": "string"
},
"description": "Recently used pattern slugs or numbers to cool down."
},
"exclusions": {
"type": "array",
"items": {
"type": "string"
},
"description": "Pattern slugs or numbers that must not be used."
},
"direction_id": {
"type": "string",
"description": "One direction_id returned by propose_directions for this same intent/seed."
}
}
}
}Check whether a set of patterns work well together. Pass the slugs (or numbers) of patterns you plan to combine on a page and get a compatibility report: overall score, per-pair analysis, style/industry coherence, intensity balance, page-flow coverage, and warnings (duplicate roles, missing positions, too many heavy patterns). Call BEFORE building to catch mismatches early.
| Parameter | Type | Description |
|---|---|---|
| components * | array | Pattern slugs or numbers to validate together |
{
"name": "validate_combination",
"description": "Check whether a set of patterns work well together. Pass the slugs (or numbers) of patterns you plan to combine on a page and get a compatibility report: overall score, per-pair analysis, style/industry coherence, intensity balance, page-flow coverage, and warnings (duplicate roles, missing positions, too many heavy patterns). Call BEFORE building to catch mismatches early.",
"inputSchema": {
"type": "object",
"required": [
"components"
],
"properties": {
"components": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"minItems": 2,
"description": "Pattern slugs or numbers to validate together"
}
}
}
}Audit an EXISTING page (yours or a client's — any AI builder, any stack) for the default-AI "section grammar" tell: numbered steps, a centered hero with two buttons, 3-up icon cards, a testimonial/FAQ/CTA-band skeleton repeating unchanged. Deterministic, no LLM — every finding cites the exact matched HTML. Returns an ai_shaped_score (0-100), per-section tells with evidence, page-level tells (skeleton order, uniform scaffolding, default type/motion), and prescriptions: real Motion Menu patterns to replace each flagged section, drawn from the same graph recommend_patterns/validate_combination use, plus the exact next tool calls to fetch and validate them. FREE, no key required.
| Parameter | Type | Description |
|---|---|---|
| url | string | alternative to html — fetched server-side (https only, public addresses only, 3 MB cap, 10 s timeout, no redirect to a private range, no credentials forwarded) |
| html | string | the page's full HTML — one page per call; a multi-page site is the caller's own loop |
{
"name": "audit_page",
"description": "Audit an EXISTING page (yours or a client's — any AI builder, any stack) for the default-AI \"section grammar\" tell: numbered steps, a centered hero with two buttons, 3-up icon cards, a testimonial/FAQ/CTA-band skeleton repeating unchanged. Deterministic, no LLM — every finding cites the exact matched HTML. Returns an ai_shaped_score (0-100), per-section tells with evidence, page-level tells (skeleton order, uniform scaffolding, default type/motion), and prescriptions: real Motion Menu patterns to replace each flagged section, drawn from the same graph recommend_patterns/validate_combination use, plus the exact next tool calls to fetch and validate them. FREE, no key required.",
"inputSchema": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "alternative to html — fetched server-side (https only, public addresses only, 3 MB cap, 10 s timeout, no redirect to a private range, no credentials forwarded)"
},
"html": {
"type": "string",
"description": "the page's full HTML — one page per call; a multi-page site is the caller's own loop"
}
}
}
}Adapt a pattern to a brand system. Pass a pattern slug/number and a brand (colors, typography, spacing, radius) and get back the pattern's HTML/CSS/JS with every visual token replaced by the brand's values. The pattern's behavior, motion, and structure are preserved — only its visual expression changes. This is how a client gets THEIR pattern, not a generic one. FREE, no key required.
| Parameter | Type | Description |
|---|---|---|
| slug * | string | pattern slug or number to adapt |
| brand * | object | the brand system to adapt to |
{
"name": "adapt_pattern",
"description": "Adapt a pattern to a brand system. Pass a pattern slug/number and a brand (colors, typography, spacing, radius) and get back the pattern's HTML/CSS/JS with every visual token replaced by the brand's values. The pattern's behavior, motion, and structure are preserved — only its visual expression changes. This is how a client gets THEIR pattern, not a generic one. FREE, no key required.",
"inputSchema": {
"type": "object",
"required": [
"slug",
"brand"
],
"properties": {
"slug": {
"type": "string",
"description": "pattern slug or number to adapt"
},
"brand": {
"type": "object",
"required": [
"name",
"colors",
"typography",
"spacing",
"radius"
],
"properties": {
"name": {
"type": "string"
},
"colors": {
"type": "object",
"required": [
"primary",
"secondary",
"accent",
"background",
"text"
],
"properties": {
"text": {
"type": "string"
},
"accent": {
"type": "string"
},
"primary": {
"type": "string"
},
"secondary": {
"type": "string"
},
"background": {
"type": "string"
}
}
},
"radius": {
"enum": [
"sharp",
"rounded",
"pill"
],
"type": "string"
},
"spacing": {
"enum": [
"compact",
"comfortable",
"spacious"
],
"type": "string"
},
"typography": {
"type": "object",
"required": [
"heading",
"body"
],
"properties": {
"body": {
"type": "string"
},
"heading": {
"type": "string"
}
}
}
},
"description": "the brand system to adapt to"
}
}
}
}Critique a composed page for mechanical design flaws before shipping. Checks for AI-gradient tells, default typography, dead frames, contrast failures, repeated section grammar, motion-safety gaps, placeholder copy, and slop grammar. Returns a score (0-100) and each finding with its evidence and a fix. This is deterministic markup analysis, not visual review — it cannot judge composition or alignment. FREE, no key required.
| Parameter | Type | Description |
|---|---|---|
| html * | string | the page's full HTML |
{
"name": "critique_page",
"description": "Critique a composed page for mechanical design flaws before shipping. Checks for AI-gradient tells, default typography, dead frames, contrast failures, repeated section grammar, motion-safety gaps, placeholder copy, and slop grammar. Returns a score (0-100) and each finding with its evidence and a fix. This is deterministic markup analysis, not visual review — it cannot judge composition or alignment. FREE, no key required.",
"inputSchema": {
"type": "object",
"required": [
"html"
],
"properties": {
"html": {
"type": "string",
"description": "the page's full HTML"
}
}
}
}Find patterns by meaning, not by keyword. Uses TF-IDF + cosine similarity over the full catalogue metadata (title, tags, style, industry_fit, role, tech). Returns the top-N most semantically related patterns with a relevance score. Use this when recommend_patterns misses because the brief uses different vocabulary than the tags. FREE, no key required.
| Parameter | Type | Description |
|---|---|---|
| count | number | max results (default 10, max 20) |
| query * | string | what you are looking for, in natural language |
{
"name": "search_patterns",
"description": "Find patterns by meaning, not by keyword. Uses TF-IDF + cosine similarity over the full catalogue metadata (title, tags, style, industry_fit, role, tech). Returns the top-N most semantically related patterns with a relevance score. Use this when recommend_patterns misses because the brief uses different vocabulary than the tags. FREE, no key required.",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"count": {
"type": "number",
"description": "max results (default 10, max 20)"
},
"query": {
"type": "string",
"description": "what you are looking for, in natural language"
}
}
}
}Discharge the release contract before shipping. Checks 11 requirements against your finished markup — reduced-motion strategy, viewport, visible focus, 44px touch targets, alt text, form labels, no debug spew, no placeholder copy, the recorded manifest version, that every pattern you claim resolves, and that no heavy runtime downloads on the reduced-motion path — and returns each failure with the exact fix. Then returns the 7 browser-only passes (desktop/mobile render, alignment, visual critique, fast-scroll lifecycle, accessibility audit, cold route) as OUTSTANDING with the command that discharges each. Those are never marked pass: this tool does not run a browser and does not pretend to. FREE, no key required.
| Parameter | Type | Description |
|---|---|---|
| html * | string | the finished page's full HTML |
| slugs | array | optional — every pattern slug/number the page uses. Defaults to any data-mm-pattern attributes found in the markup; each is checked against the live catalogue so a typo or a renamed slug is caught here rather than as a 404 in the customer's build. |
{
"name": "verify_complete",
"description": "Discharge the release contract before shipping. Checks 11 requirements against your finished markup — reduced-motion strategy, viewport, visible focus, 44px touch targets, alt text, form labels, no debug spew, no placeholder copy, the recorded manifest version, that every pattern you claim resolves, and that no heavy runtime downloads on the reduced-motion path — and returns each failure with the exact fix. Then returns the 7 browser-only passes (desktop/mobile render, alignment, visual critique, fast-scroll lifecycle, accessibility audit, cold route) as OUTSTANDING with the command that discharges each. Those are never marked pass: this tool does not run a browser and does not pretend to. FREE, no key required.",
"inputSchema": {
"type": "object",
"required": [
"html"
],
"properties": {
"html": {
"type": "string",
"description": "the finished page's full HTML"
},
"slugs": {
"type": "array",
"items": {
"type": "string"
},
"description": "optional — every pattern slug/number the page uses. Defaults to any data-mm-pattern attributes found in the markup; each is checked against the live catalogue so a typo or a renamed slug is caught here rather than as a 404 in the customer's build."
}
}
}
}Re-audit a page you just rewrote from audit_page's prescriptions and get a pass/fail verdict: fresh ai_shaped_score, the delta from the prior audit (pass baseline_score or the whole prior audit_page result as `baseline`), and any tells STILL present, each with a concrete fix instruction. FREE, no key required.
| Parameter | Type | Description |
|---|---|---|
| html * | string | the rewritten page's full HTML |
| baseline | object | optional — the whole prior audit_page result, for a per-section tell-count delta in addition to the overall score delta; baseline_score is derived from it if omitted |
| baseline_score | number | optional — the ai_shaped_score from the prior audit_page call, for a pass/fail delta |
{
"name": "verify_repair",
"description": "Re-audit a page you just rewrote from audit_page's prescriptions and get a pass/fail verdict: fresh ai_shaped_score, the delta from the prior audit (pass baseline_score or the whole prior audit_page result as `baseline`), and any tells STILL present, each with a concrete fix instruction. FREE, no key required.",
"inputSchema": {
"type": "object",
"required": [
"html"
],
"properties": {
"html": {
"type": "string",
"description": "the rewritten page's full HTML"
},
"baseline": {
"type": "object",
"description": "optional — the whole prior audit_page result, for a per-section tell-count delta in addition to the overall score delta; baseline_score is derived from it if omitted"
},
"baseline_score": {
"type": "number",
"description": "optional — the ai_shaped_score from the prior audit_page call, for a pass/fail delta"
}
}
}
}Motion Menu — a motion and design director for coding agents. It plans and constrains the page, picks from a numbered library of real HTML/CSS/JS patterns, and refuses the generic layout before you build it. WORKFLOW, in order — each step grounds the next: 1. get_design_digest read the quality contract FIRST — the rules a generic page breaks. 2. recommend_patterns describe intent, get scored candidates. Free, metadata only. 3. validate_combination check picks for clashes/caps BEFORE building. Free. 4. get_pattern pull one pattern's full code, or a react/vue/svelte/vanilla wrapper. get_kit is the one-call shortcut — design laws plus the full index in a single response. Read it first if you want the whole picture before making individual calls. ALREADY HAVE A SITE? Don't start over — audit_page {html or url} diagnoses the default-AI section grammar (numbered steps, centered hero + two buttons, 3-up cards, the same skeleton every AI builder ships) and prescribes real patterns per flagged section, by number. Rewrite with get_pattern, then verify_repair {html} confirms the tells are gone. Both free, keyless, no LLM server-side — deterministic evidence, not a vibe check. FREE: the entire library — all 571 patterns, list_patterns, get_kit, recommend_patterns, validate_combination and build_page all cost nothing, no key, no card. Motion Menu is free; we fund it building with it (Plinth: fixed-scope sites from these same patterns). AUTH: none required — every tool answers with no key. Optional keys exist only for usage metering on your own account. EXAMPLE: tools/call { "name": "recommend_patterns", "arguments": { "intent": "dark minimal SaaS landing page", "role": "hero" } }
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.