@webspire/mcp 0.10.0 → 0.11.0

package/README.md

@@ -1,17 +1,6 @@
 # @webspire/mcp
 
-MCP server for [Webspire](https://webspire.de) — AI-native discovery of CSS snippets, UI patterns, canvas effects, page templates, and font recommendations. All Tailwind v4, token-based, dark mode, accessible.
-
-## Stability Model
-
-Webspire is intentionally iterative.
-
-- Not every pattern or snippet is optimal yet.
-- Registry contents, taxonomy, scoring, and composition output may change over time.
-- The only guaranteed answer is the snapshot you receive when you make the request.
-- This is by design: the registry is supposed to keep improving instead of acting like a fixed framework API.
-
-The important invariant is different: MCP should provide context, discovery, and composition help, while the resulting code remains something you can own directly in your project. The goal is not to introduce a runtime dependency.
+MCP server for [Webspire](https://webspire.de) — AI-native discovery of CSS snippets, UI patterns, canvas effects, page templates, motion recipes, and font recommendations. All Tailwind v4, token-based, dark mode, accessible.
 
 ## Quick Start
 
@@ -63,6 +52,14 @@ The important invariant is different: MCP should provide context, discovery, and
 | `search_canvas_effects` | Search canvas effects by keyword, category, or interactivity |
 | `get_canvas_effect` | Get full JS source, mountCanvas runtime, and embed HTML |
 
+### Motion Recipes (Animation Patterns)
+
+| Tool | Description |
+|------|-------------|
+| `list_motion_recipes` | List all motion recipes grouped by family |
+| `search_motion_recipes` | Search recipes by keyword, family, technology, or trigger |
+| `get_motion_recipe` | Get full self-contained HTML for a motion recipe |
+
 ### Fonts (Semantic Recommendations)
 
 | Tool | Description |
@@ -78,13 +75,13 @@ The important invariant is different: MCP should provide context, discovery, and
 
 ## Content
 
-### CSS Snippets (146)
+### CSS Snippets (144)
 
 Effects that Tailwind v4 can't do natively across 12 categories: glass, animations, easing, scroll, decorative, interactions, text, lighting, depth, masks, surfaces, atmosphere.
 
-### UI Patterns (~497)
+### UI Patterns (519+)
 
-Page sections and content elements across 170+ families — hero, navbar, pricing, features, dashboard, e-commerce, AI, and more. All using `--ws-*` component tokens.
+Page sections and content elements across 170+ families — hero, navbar, pricing, features, dashboard, e-commerce, AI, developer tools, and more. All using `--ws-*` component tokens.
 
 ### Canvas Effects (3)
 
@@ -94,10 +91,25 @@ Dynamic JavaScript visuals using the `mountCanvas` runtime: particle fields, pro
 
 Complete standalone pages: SaaS, agency, portfolio, shop, company — with Tailwind CDN.
 
+### Motion Recipes (3)
+
+Framework-agnostic animation patterns using GSAP and Motion One. Self-contained HTML files with live scroll demos. Families: reveal, scroll, transition, micro, layout.
+
 ### Font Recommendations (25 fonts, 15 pairings)
 
 Semantic font stack recommendations based on domain (legal, saas, agency...) and tone (serious, modern, friendly...). All fonts available as npm packages via @fontsource.
 
+## Offline Support
+
+The MCP works without a permanent internet connection. Registry data is loaded using a layered fallback:
+
+1. **In-memory cache** (5-min TTL) — no re-fetch within the same session
+2. **Remote fetch** from webspire.de — always current, writes to disk when newer
+3. **Disk cache** (`~/.cache/webspire/`) — last successfully fetched version, survives restarts
+4. **Installed copy** — frozen at publish time, last resort
+
+In practice: go online once, the disk cache is written. All subsequent offline starts use that cached version, not the potentially older installed copy.
+
 ## 3-Layer Token Architecture
 
 ```
@@ -151,4 +163,14 @@ const results = searchSnippets(registry, {
 });
 ```
 
+## Stability Model
+
+Webspire is intentionally iterative.
+
+- Registry contents, taxonomy, scoring, and composition output may change over time.
+- The only guaranteed answer is the snapshot you receive when you make the request.
+- This is by design: the registry keeps improving instead of acting like a fixed framework API.
+
+The important invariant: MCP provides context, discovery, and composition help, while the resulting code remains something you own directly in your project. No runtime dependency is introduced.
+
 Docs: https://webspire.de