raven-mcp 1.3.5 → 1.4.0

package/NOTICE

@@ -0,0 +1,101 @@
+Raven MCP
+Copyright (c) 2026 Andrew Cunliffe
+
+Licensed under the MIT License — see LICENSE for full text.
+
+This is a personal open-source project. It is not endorsed by, affiliated with,
+or supported by Intuit Inc. or any other company referenced in the source data.
+
+================================================================================
+Third-party sources referenced in src/data/
+================================================================================
+
+Raven's knowledge base paraphrases, summarizes, and references the work of many
+authors and organizations. Source URLs are embedded in each entry's `sources`
+field. Several upstream sources carry their own licenses — listed below in
+descending order of permissiveness.
+
+Permissive / public-domain sources
+----------------------------------
+- Gestalt principles — early-20th-century academic work, public domain.
+  Descriptions in Raven are original prose.
+
+- W3C Web Content Accessibility Guidelines (WCAG 2.1 / 2.2)
+  https://www.w3.org/WAI/standards-guidelines/wcag/
+  Licensed under the W3C Document License. Permits redistribution and
+  derivative works with attribution.
+
+- GOV.UK Style Guide and GOV.UK Service Standard
+  https://www.gov.uk/guidance/style-guide
+  https://www.gov.uk/service-manual/service-standard
+  Contains public sector information licensed under the Open Government
+  Licence v3.0: https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/
+
+- Shopify Polaris (component library)
+  https://polaris.shopify.com — Polaris code is MIT-licensed. Content
+  documentation is paraphrased as reference; consult Shopify for the
+  authoritative version.
+
+Attribution-with-conditions sources
+-----------------------------------
+- Nielsen's 10 Usability Heuristics, Nielsen Norman Group
+  https://www.nngroup.com/articles/ten-usability-heuristics/
+  Heuristic names are short factual labels; Raven's descriptions are original
+  paraphrase under fair-use commentary. NN/g is the canonical source for
+  production use.
+
+- Laws of UX, Jon Yablonski
+  https://lawsofux.com — licensed under CC BY-NC-ND 4.0.
+  Raven references the named laws (Fitts's Law, Miller's Law, Hick's Law,
+  etc. — which are public academic concepts) and provides original
+  descriptions. No prose from lawsofux.com is reproduced. The named "21
+  Laws of UX" framing and any Yablonski-authored summaries are the
+  property of the original author; consult lawsofux.com for the canonical
+  versions.
+
+- Mailchimp Content Style Guide
+  https://styleguide.mailchimp.com — licensed under CC BY-NC 4.0.
+  Raven's mailchimp.json is a paraphrased reference to the publicly
+  documented voice attributes, tone shifts, and content patterns.
+  Consult the original for authoritative or commercial use.
+
+- Atlassian Design System
+  https://atlassian.design — content paraphrased as reference; no
+  Atlassian copy is reproduced verbatim.
+
+- This Is Service Design Doing (Stickdorn, Hormess, Lawrence, Schneider),
+  O'Reilly 2018 — five service-design principles are referenced as
+  concepts; descriptions are original.
+
+- Lynn Shostack, "How to Design a Service" / "Designing Services That
+  Deliver" (Harvard Business Review, 1984) — service-blueprinting concept
+  is referenced; descriptions are original.
+
+Frameworks (concept-only, no copyrighted prose)
+-----------------------------------------------
+- HEART framework (Kerry Rodden, Hilary Hutchinson, Xin Fu — Google, 2010)
+- AARRR / Pirate Metrics (Dave McClure, 500 Startups, 2007)
+- North Star Metric (Sean Ellis / Amplitude)
+- RICE prioritization (Intercom)
+- OKRs (Andy Grove / John Doerr)
+- Carlzon's Moments of Truth (Jan Carlzon, 1987)
+
+These are methodological frameworks; concepts are not copyrightable.
+Descriptions in Raven are original.
+
+Design tokens
+-------------
+Token values (color hex codes, type scales, spacing units, motion timings)
+for the design systems referenced in src/data/tokens/ are functional values
+extracted from publicly accessible design-system documentation. Functional
+design values are not protectable expression. Brand names are used
+nominatively to label which system a token set is styled like, not to
+suggest endorsement.
+
+================================================================================
+Removing a source
+================================================================================
+
+If you are a rights-holder and would like a source removed, amended, or
+attributed differently, file an issue at:
+https://github.com/rhinocap/raven-mcp/issues

package/README.md

@@ -4,13 +4,15 @@
 
 A design knowledge MCP server that Claude can query when generating UI. Eight layers: principles, patterns, content design systems, research methods, service design, brand/visual, business strategy, and design tokens.
 
+> Raven MCP is a personal open-source project by [Andrew Cunliffe](https://ravenmcp.ai). It is **not endorsed by, affiliated with, or supported by Intuit Inc.** or any other company referenced in its source data. See [NOTICE](./NOTICE) for full attribution of upstream sources and their licenses.
+
 ## What it does
 
 Raven gives Claude access to a comprehensive design knowledge base:
 
 - **Principles** — Nielsen's 10 Heuristics, all 21 Laws of UX, Gestalt principles, WCAG accessibility, typography rules, color theory, mobile UX, D4D framework, UX writing, service design, and brand
 - **Patterns** — Proven UI patterns for signup flows, pricing pages, navigation, forms, landing pages, dashboards, modals, empty/error/loading states, CTAs, social proof, mobile conversion — plus content patterns (error messages, empty-state copy, notifications, form validation) and service patterns (service blueprinting, human handoff, signup-as-service, omnichannel continuity, moments of truth)
-- **Content systems** — Voice & tone guides from real brands: Mailchimp, GOV.UK, Shopify Polaris, Atlassian, and Intuit
+- **Content systems** — Voice & tone guides from publicly documented brand systems: Mailchimp, GOV.UK, Shopify Polaris, and Atlassian
 - **Research** — Qualitative, quantitative, and usability methods with do/don't protocols and checklists. Metrics frameworks: HEART, AARRR/Pirate, North Star Metric, conversion funnel, RICE, OKRs.
 - **Service design** — Service blueprinting (with HTML blueprint generation — current vs. ideal state), human-handoff patterns, signup-as-service, omnichannel continuity, moments of truth / recovery, and the GOV.UK Service Standard
 - **Brand & visual** — Logo usage (clear space, min sizes, variants, placement, restraint), gradient usage (hierarchy, palette, contrast, trend vs signature), imagery (consistency, representation, purpose), visual hierarchy, brand-as-system, and current (2026) visual-design trends
@@ -63,7 +65,7 @@ cd raven-mcp && npm install && npm run build
 | `audit_page` | Audit HTML/CSS against Raven's quality standards |
 | `audit_layout` | Evaluate visual rhythm, alignment, and optical balance |
 | `generate_design_system` | Generate a custom design system from a brand color |
-| `list_content_systems` | Browse brand voice & tone systems (Mailchimp, GOV.UK, Shopify Polaris, Atlassian, Intuit) |
+| `list_content_systems` | Browse brand voice & tone systems (Mailchimp, GOV.UK, Shopify Polaris, Atlassian) |
 | `get_content_system` | Get a brand's voice attributes, tone shifts, vocabulary, grammar, and content patterns |
 | `get_content_principles` | Get UX-writing principles — clarity, active voice, error anatomy, inclusive language |
 | `get_content_pattern` | Get copy recipes for error messages, empty-state copy, notifications, form validation |
@@ -105,6 +107,16 @@ npm run build  # Compile TypeScript
 npm start      # Run compiled output
 ```
 
+## License & attribution
+
+Raven MCP is released under the [MIT License](./LICENSE) — Copyright (c) 2026 Andrew Cunliffe.
+
+If you fork, embed, or redistribute Raven (in whole or in part), retain the MIT license notice and the `LICENSE` file. If you ship Raven inside another product, include attribution to "Raven MCP — https://ravenmcp.ai" in your acknowledgements.
+
+Raven's knowledge base paraphrases and references work from many third-party sources — Nielsen Norman Group, Laws of UX (CC BY-NC-ND 4.0), Gestalt principles, WCAG (W3C), Mailchimp (CC BY-NC 4.0), GOV.UK (Open Government Licence v3.0), Shopify Polaris, Atlassian Design, and others. Each entry carries a `sources` URL field. See [NOTICE](./NOTICE) for the full list of upstream sources and license terms; some carry their own conditions beyond MIT.
+
+This is a personal project. It is not endorsed by Intuit Inc. or any other company referenced in its source data.
+
 ## Data structure
 
 All knowledge lives in `src/data/` as static JSON files:
@@ -115,8 +127,8 @@ src/data/
   patterns/        # signup, pricing, nav, forms, landing, dashboard, modals, empty/error/loading, CTA, social proof, mobile
   business/        # monetization, retention, onboarding, growth, metrics
   tokens/          # registry.json + systems/ (stripe, linear, vercel, …)
-  content/         # voice & tone: Mailchimp, GOV.UK, Shopify Polaris, Atlassian, Intuit
-    systems/       # registry.json + brand-voice JSONs
+  content/         # voice & tone: Mailchimp, GOV.UK, Shopify Polaris, Atlassian
+    systems/       # registry.json + brand-voice JSONs (Mailchimp, GOV.UK, Polaris, Atlassian)
     principles/    # UX-writing principles (clarity, active voice, error anatomy, …)
     patterns/      # copy recipes for errors, empty states, notifications, form validation
   research/        # study protocols + metrics frameworks

package/dist/index.js

@@ -2421,7 +2421,7 @@ server.tool("audit_layout", "Evaluate visual rhythm from a rendered page's geome
 // principles and patterns are loaded into the regular principles/pattern
 // arrays and reachable through get_principles/get_pattern as well — these
 // tools are the discoverable shortcuts.
-server.tool("list_content_systems", "Browse available content design systems — brand voice and tone guides from real companies (Mailchimp, GOV.UK, Shopify Polaris, Atlassian, Intuit). Filter by category or search by name.", {
+server.tool("list_content_systems", "Browse available content design systems — brand voice and tone guides from real companies (Mailchimp, GOV.UK, Shopify Polaris, Atlassian). Filter by category or search by name.", {
     category: z.string().optional().describe("Filter by category: marketing-saas, government, commerce-saas, productivity-saas, fintech"),
     search: z.string().optional().describe("Search by name, description, or tag")
 }, async ({ category, search }) => {
@@ -2449,7 +2449,7 @@ server.tool("list_content_systems", "Browse available content design systems —
     };
 });
 server.tool("get_content_system", "Get a brand's content design system — voice attributes, tone shifts by context, vocabulary (use/avoid/never), grammar rules, content patterns for errors/empty-states/buttons/etc., and inclusive language guidance.", {
-    id: z.string().describe("Content system ID (e.g. 'mailchimp', 'gov-uk', 'shopify-polaris', 'atlassian', 'intuit')"),
+    id: z.string().describe("Content system ID (e.g. 'mailchimp', 'gov-uk', 'shopify-polaris', 'atlassian')"),
     section: z.enum(["all", "voice", "tone_shifts", "vocabulary", "grammar", "content-patterns", "inclusive-language"]).optional().describe("Return just one section. Default: all.")
 }, async ({ id, section }) => {
     var sys = loadContentSystem(id);