{"schema_version":"verify.report.v1","generated_at":"2026-08-17T20:00:10.832332+00:00","snapshot_id":"trustsnap_b0996ac3bd9d04b5","server":{"namespace":"ai.ravenmcp","name":"raven-mcp","title":"Raven","description":"Design intelligence for AI-generated UI — principles, patterns, content, brand, design tokens.","homepage_url":"https://ravenmcp.ai","docs_url":null,"icon_url":null,"support_url":null,"remote_url":"https://mcp.ravenmcp.ai/api/mcp","server_card_url":null,"latest_version":"1.3.3","current_status":"healthy","current_score":71.88,"transport_type":"streamable-http","has_oauth":true,"has_dcr":true,"has_prompts":true,"tool_count":45,"current_validation_schema_version":"8058defc70ca932c","last_validated_at":"2026-08-17T19:01:28.897610+00:00","registry_source":"official_registry","registry_identifier":"ai.ravenmcp/raven-mcp","canonical_identifier":null,"current_score_components":{"auth_operability_score":4.0,"error_contract_score":2.0,"rate_limit_semantics_score":2.0,"schema_completeness_score":3.0,"backward_compatibility_score":4.0,"slo_health_score":4.0,"security_hygiene_score":4.0,"task_success_score":4.0,"trust_confidence_score":4.0,"abuse_noise_ratio_score":4.0,"prompt_contract_score":3.0,"resource_contract_score":0.0,"discovery_metadata_score":2.0,"registry_consistency_score":2.0,"installability_score":4.0,"session_semantics_score":4.0,"tool_surface_design_score":3.0,"result_shape_stability_score":3.0,"oauth_interop_score":4.0,"recovery_semantics_score":0.0,"maintenance_signal_score":4.0,"adoption_signal_score":3.0,"freshness_confidence_score":4.0,"transport_fidelity_score":4.0,"spec_recency_score":2.0,"session_resume_score":3.0,"step_up_auth_score":3.0,"transport_compliance_score":2.0,"utility_coverage_score":0.0,"advanced_capability_coverage_score":0.0,"connector_publishability_score":2.0,"tool_snapshot_churn_score":4.0,"connector_replay_score":4.0,"request_association_score":0.0,"interactive_flow_safety_score":4.0,"action_safety_score":3.0,"official_registry_presence_score":4.0,"safety_transparency_score":2.0,"tool_capability_clarity_score":4.0,"destructive_operation_safety_score":3.0,"egress_ssrf_resilience_score":2.0,"execution_sandbox_safety_score":4.0,"data_exfiltration_resilience_score":3.0,"least_privilege_scope_score":3.0,"secret_handling_hygiene_score":3.0,"dependency_supply_chain_signal_score":1.0,"input_sanitization_safety_score":3.0,"tool_namespace_clarity_score":4.0},"capability_taxonomy":[],"machine_summary":{},"taxonomy_tags":[],"score_decomposition":[],"validation_diff":null,"tool_snapshot_diff":null,"connector_replay":{},"request_association":{},"production_readiness":{"code":"safe_for_evaluation","label":"Safe for evaluation","reason":"The server is suitable for evaluation, but remaining gaps should be resolved before broad production use.","badge":"score-medium","critical_alerts":0,"high_or_critical_alerts":0,"degraded_by_active_alerts":false},"recommended_for":[],"history_summary":{},"validation_timeline":[],"evidence_confidence":{"score":100.0,"label":"high","reason":"Based on 20 recent validations, 21 captured checks, and validation age of 1.0 hours.","live_check_count":21,"validation_age_hours":0.98,"basis":{"evidence_bearing_validations":20,"affirmative_live_check_count":21,"validation_age_hours":0.98,"freshness_threshold_hours":24}},"incident_feed":[],"disputes":[],"remediations":[],"client_remediation_modes":[],"client_profiles":[],"client_readiness_verdicts":[],"publishability_policy_profiles":[],"compatibility_fixtures":[],"install_snippets":{},"aliases":[],"raw_evidence":{"checks":{"probe_noise_resilience":{"status":"ok","latency_ms":195.02,"details":{"url":"https://mcp.ravenmcp.ai/robots.txt","http_status":200,"headers":{"content-type":"text/plain; charset=utf-8","strict-transport-security":"max-age=63072000"},"validation_disallowed":false,"consent_error":null}},"server_card":{"status":"error","latency_ms":37.74,"details":{"url":"https://mcp.ravenmcp.ai/.well-known/mcp/server-card.json","error":"Client error '404 Not Found' for url 'https://mcp.ravenmcp.ai/.well-known/mcp/server-card.json'\nFor more information check: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404"}},"oauth_protected_resource":{"status":"ok","latency_ms":151.4,"details":{"url":"https://mcp.ravenmcp.ai/.well-known/oauth-protected-resource","payload":{"resource":"https://mcp.ravenmcp.ai/api/mcp-user","authorization_servers":["https://artistic-gold-76-staging.authkit.app"],"bearer_methods_supported":["header"],"scopes_supported":["openid","profile","email","offline_access"],"resource_name":"Raven MCP (authenticated)","resource_documentation":"https://ravenmcp.ai/docs.html"},"http_status":200,"headers":{"content-type":"application/json; charset=utf-8","strict-transport-security":"max-age=63072000"}}},"oauth_authorization_server":{"status":"ok","latency_ms":599.29,"details":{"url":"https://artistic-gold-76-staging.authkit.app/.well-known/oauth-authorization-server","payload":{"authorization_endpoint":"https://artistic-gold-76-staging.authkit.app/oauth2/authorize","client_id_metadata_document_supported":true,"code_challenge_methods_supported":["S256"],"device_authorization_endpoint":"https://artistic-gold-76-staging.authkit.app/oauth2/device_authorization","grant_types_supported":["authorization_code","refresh_token","urn:ietf:params:oauth:grant-type:device_code"],"introspection_endpoint":"https://artistic-gold-76-staging.authkit.app/oauth2/introspection","issuer":"https://artistic-gold-76-staging.authkit.app","jwks_uri":"https://artistic-gold-76-staging.authkit.app/oauth2/jwks","registration_endpoint":"https://artistic-gold-76-staging.authkit.app/oauth2/register","scopes_supported":["email","offline_access","openid","profile"],"response_modes_supported":["query"],"response_types_supported":["code"],"token_endpoint":"https://artistic-gold-76-staging.authkit.app/oauth2/token","token_endpoint_auth_methods_supported":["none","client_secret_post","client_secret_basic"]},"http_status":200,"headers":{"content-type":"application/json; charset=utf-8","set-cookie":"__cf_bm=1ybMeZINnTKUIto6TIv3pK6hkI8Amt5a.3rO4u3NM50-1786993287.2623134-1.0.1.1-SOqdCMgHh7zG2wrerp_0gKfzkmwSwBgvqslTpsIe25epivLV41Cwa15aqliIZVcpxiyE7UkzkKrS9ybtzADaHhr3mnrE97x5i5_wnGhrDkOb2naegradONRUfwBsVlrd; HttpOnly; SameSite=None; Secure; Path=/; Domain=authkit.app; Expires=Mon, 17 Aug 2026 19:31:27 GMT","strict-transport-security":"max-age=31536000; includeSubDomains; preload"}}},"openid_configuration":{"status":"ok","latency_ms":191.57,"details":{"url":"https://artistic-gold-76-staging.authkit.app/.well-known/openid-configuration","payload":{"issuer":"https://artistic-gold-76-staging.authkit.app","authorization_endpoint":"https://artistic-gold-76-staging.authkit.app/oauth2/authorize","device_authorization_endpoint":"https://artistic-gold-76-staging.authkit.app/oauth2/device_authorization","grant_types_supported":["authorization_code","client_credentials","refresh_token","urn:ietf:params:oauth:grant-type:device_code"],"id_token_signing_alg_values_supported":["RS256"],"introspection_endpoint":"https://artistic-gold-76-staging.authkit.app/oauth2/introspection","jwks_uri":"https://artistic-gold-76-staging.authkit.app/oauth2/jwks","response_types_supported":["code"],"scopes_supported":["email","offline_access","openid","profile"],"subject_types_supported":["public"],"token_endpoint":"https://artistic-gold-76-staging.authkit.app/oauth2/token","token_endpoint_auth_methods_supported":["none","client_secret_basic","client_secret_post"],"userinfo_endpoint":"https://artistic-gold-76-staging.authkit.app/oauth2/userinfo"},"http_status":200,"headers":{"content-type":"application/json; charset=utf-8","strict-transport-security":"max-age=31536000; includeSubDomains; preload"}}},"initialize":{"status":"ok","latency_ms":45.2,"details":{"url":"https://mcp.ravenmcp.ai/api/mcp","payload":{"result":{"protocolVersion":"2025-03-26","capabilities":{"tools":{"listChanged":true},"prompts":{"listChanged":true}},"serverInfo":{"name":"raven-mcp","version":"2.4.1"},"instructions":"Raven is a design-intelligence server: audits (page/layout/screen/contrast/tap-targets/typography/consistency), design systems and tokens, brand/content/service-design knowledge, creative scoring, and a Taste Engine that makes a person's design judgment portable and growable.\n\nPROJECT KICKOFF — calibrate taste BEFORE the first design work. Taste is per-surface: the same person wants different rules on a monochrome portfolio than on a product site, and a different voice on each. At the START of a new project (or the first design/copy/UI work in any project), if a taste profile exists (list_taste_profiles), call get_taste_interview with the profile and a project name (mode defaults to 'kickoff', depth defaults to 'first_run'). If it returns existing_binding: null, ask the user just its 5 core `questions` conversationally — identity, genesis (kickoff is when a project comes into existence: what already exists — a brand, a design system, brand assets — and what should be generated), aesthetic (how it should read here — multiple-choice options given), voice (three register examples so the user can pick by ear), and matchers (which URL hosts identify the project) — then persist with bind_taste_surface and proceed; when genesis says the user has no design system, the generation route is generate_mood_board (an approval stop — pass their own images via image_paths), then generate_design_system with save:true, then init_design_md, and an existing system is consumed via configure_design_system_source or base_system instead; offer the returned `more_questions` (typography/spacing/color/layout/motion/imagery/entrance/loading/navigation/libraries, references, per-rule overrides, the open-ended special question) as OPTIONAL deeper calibration rather than asking them all upfront, or re-run with depth:'full' if the user wants the complete interview at once. Dimension answers go in design_notes and are echoed in every audit. A cold-start project with no profile at all can start from create_taste_profile({ name, template: 'portfolio'|'saas-marketing'|'app' }) for a small sensible starter ruleset before the first interview even runs. The interview is a blocking gate: collect the user's answers before committing any design direction, palette, type choice, or name — never answer its questions yourself or start design work while it is pending. Every question carries skippable + priority (core|extended); skipping is fine but leaves that item uncalibrated. A 'references' question takes example links/screenshots and interviews what specifically the person likes about each. The interview ends with an open-ended 'special' question (textures, signature details, motifs — stored as design_notes.special) that suggests the person's choices from their other bound surfaces once it has them. From then on pass project:'' on every audit_taste — bindings also auto-match by URL hostname in url mode. When the surface is a website to be built, suggest building it as a Next.js app by default; if the user prefers another stack, record it in design_notes.libraries. Do NOT wait for an audit to return a calibration_hint; that is the reactive backstop, not the intended flow.\n\nWhen a user dislikes generated/designed output on an ALREADY-calibrated project, that dissatisfaction is a calibration signal, not a dead end — re-run get_taste_interview with mode:'refine' (it re-interviews against the stored binding: what fell short, then each stored design_notes value to keep/tighten/replace, then voice, then an optional reject precedent) and re-bind with bind_taste_surface.\n\nLEARNING LOOP — whenever the user makes, approves, or corrects a taste, direction, or design decision during work (not just at interview time), record it with record_taste_decision: the project, a short dimension name, what was chosen, what was rejected, why, and whether it was user-directed, user-approved, or user-corrected (a user overriding a generated choice is the highest-signal record). Recorded decisions evolve future kickoff interviews — recurring choices return as suggested defaults on their dimension's question, and decision categories no standard question covers become NEW interview questions. Record liberally; every committed decision is calibration data.\n\nJudging work: prefer audit_taste (with the profile + project) for matters of the owner's taste, and the mechanical audits (audit_page, audit_contrast, audit_tap_targets, audit_layout) for objective quality. design_notes are ACCEPTANCE CRITERIA for any build, not mood words: audit_taste verifies each note against the rendered page (note_assessments: present/partial/missing/unverifiable, each with trait-number evidence), compares the target against the binding's captured references, and flags sparse-and-empty pages whose restraint is deletion rather than craft — a build is not done until every note is visibly present or the user is told exactly which notes were dropped and why. When a note names an expensive technique (three.js/WebGL, GSAP scroll choreography, anime.js staggered motion, glassmorphism, a branded loader, lottie, kinetic display type…), bind_taste_surface and audit_taste return build_hints — a concrete recipe + canonical public example sources (threejs.org, gsap.com, animejs.com, Codrops…). The public corpus for these is vast, so an expensive note is NEVER license to drop it: consult the attached build_hints and their sources, and if a technique is genuinely infeasible, tell the user before shipping without it. Prefer url mode for verification: live traits (WebGL, animations, scroll effects) cannot be measured from static html. When a human accepts or rejects a finding, record it with label_finding — accept-verdicts suppress that exact pattern in future audits, which is how the profile learns.\n\nGRAB — click-to-change is ON BY DEFAULT for local servers. Any time you start, restart, or serve a local web page/dev server for the user (a demo, a preview, a dev build, a static file server), automatically start a grab session first (start_grab_session with the project's DESIGN.md if one exists) and make the overlay present WITHOUT the user asking or pasting anything: for a server you are starting anyway, pass proxy_target and give the user the BRIDGE url instead of the raw server url — the overlay is injected into every HTML response; for HTML files you are writing yourself, include the returned script_tag directly. Never hand the user a script tag or console snippet to paste. Mention in one line that the grab overlay is active (Alt+G or the on-page pill). The user clicks elements, swaps DESIGN.md tokens with live preview, edits computed styles inline, and sends instructions; drain them with get_grabbed_elements — while a grab session is active, drain whenever control returns to you (and before ending any turn). Sends arrive and are held. On a plain drain, acknowledge each change in one line and wait; do not implement or offer to implement until a batchCommit marker arrives. When batchCommit arrives, implement batch.pending from that same drain payload in one sweep. Apply approved token changes with update_design_md. Stop the session (stop_grab_session) when the server comes down. Skip only when the user explicitly asks for a clean page or the server is production."},"jsonrpc":"2.0","id":1},"http_status":200,"headers":{"content-type":"application/json","strict-transport-security":"max-age=63072000"}}},"protocol_version_probe":{"status":"warning","latency_ms":null,"details":{"claimed_version":"2025-03-26","validator_protocol_version":"2025-03-26","latest_known_version":"2025-11-25","releases_behind":2,"lag_days":244}},"tools_list":{"status":"ok","latency_ms":53.15,"details":{"url":"https://mcp.ravenmcp.ai/api/mcp","payload":{"result":{"tools":[{"name":"get_principles","description":"Get design principles relevant to a UI context. Returns usability heuristics, laws of UX, Gestalt principles, accessibility requirements, typography rules, and color theory — matched to what you're designing.","inputSchema":{"type":"object","properties":{"context":{"type":"string","description":"What you're designing (e.g. 'signup form', 'pricing page', 'mobile nav', 'dark dashboard')"},"category":{"type":"string","description":"Filter to category: nielsen-heuristics, laws-of-ux, gestalt, accessibility, typography, color-theory, mobile-ux, d4d, color-systems, spacing-systems"},"platform":{"type":"string","enum":["web","ios","react-native"],"description":"Platform context. 'ios' returns Apple HIG principles (Dynamic Type, 44pt targets, SF Symbols, safe areas, dark-mode, haptics, App Review privacy); 'react-native' returns RN principles (44/48pt+hitSlop, accessibilityLabel/Role, font scaling, SafeAreaView, dark mode, iOS+Android parity, secrets). Both replace the web/CSS-oriented set. Default: web."},"format":{"type":"string","enum":["full","checklist","brief"],"description":"Output format: full (all details), checklist (implications + violations), brief (just summary). Default: full"}},"required":["context"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Get Principles","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"get_pattern","description":"Get proven UI/UX patterns for a specific design type. Returns do's, don'ts, evidence, and checklists for signup flows, pricing pages, navigation, forms, landing pages, dashboards, modals, empty states, error states, loading states, CTAs, social proof, and mobile conversion.","inputSchema":{"type":"object","properties":{"type":{"type":"string","description":"Pattern type (e.g. 'signup-flow', 'pricing-page', 'navigation', 'forms', 'landing-page', 'dashboard', 'modals-dialogs', 'empty-states', 'error-states', 'loading-states', 'cta', 'social-proof', 'mobile-conversion')"},"platform":{"type":"string","enum":["desktop","mobile","responsive"],"description":"Filter patterns by platform context"},"goal":{"type":"string","enum":["conversion","usability","accessibility","delight"],"description":"Filter by primary goal"}},"required":["type"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Get Pattern","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"get_business_strategy","description":"Get business and monetization strategies for digital products. Covers monetization models, retention strategies, onboarding optimization, growth mechanics, and product metrics frameworks.","inputSchema":{"type":"object","properties":{"type":{"type":"string","description":"Strategy type: monetization, retention, onboarding, growth, metrics"},"stage":{"type":"string","enum":["startup","growth","mature"],"description":"Company stage for contextual filtering"}},"required":["type"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Get Business Strategy","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"evaluate_design","description":"Evaluate a design description against UX principles. Returns relevant principles, potential violations, and improvement suggestions.","inputSchema":{"type":"object","properties":{"description":{"type":"string","description":"Description of the design to evaluate"},"before_screenshot":{"type":"string","description":"Base64 PNG of the BEFORE state"},"after_screenshot":{"type":"string","description":"Base64 PNG of the AFTER state. When both before+after are provided, returns a structured pixel diff with fix_confirmed."},"goals":{"type":"array","items":{"type":"string"},"description":"What to evaluate for (e.g. ['conversion', 'accessibility', 'mobile-usability'])"},"context":{"type":"string","description":"What the design is (e.g. 'pricing page for SaaS product')"},"compact":{"type":"boolean","description":"Return only ids+names for matched principles/patterns (drop their full bodies) plus counts and any before/after diff. Default false. Use when the full principle library payload would blow the tool-result budget."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Evaluate Design","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"search_knowledge","description":"Search across all design principles, UI patterns, and business strategies. Use when you need to find specific guidance or don't know which category to look in.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Search term (e.g. 'touch targets', 'pricing psychology', 'color contrast')"},"layer":{"type":"string","enum":["principles","patterns","business","all"],"description":"Which layer to search: principles, patterns, business, or all (default)"}},"required":["query"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Search Knowledge","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"get_checklist","description":"Get a pre-publish checklist for a specific UI type. Returns actionable yes/no items to verify before shipping.","inputSchema":{"type":"object","properties":{"type":{"type":"string","description":"What you're shipping (e.g. 'signup form', 'pricing page', 'dashboard', 'landing page', 'modal')"},"platform":{"type":"string","enum":["desktop","mobile","responsive","ios","react-native"],"description":"Platform context for platform-specific checks. 'ios' = native SwiftUI/iOS (Apple HIG); 'react-native' = RN/Expo (iOS HIG + Android Material: 44/48pt+hitSlop, accessibilityLabel/Role, font scaling, SafeAreaView, dark mode, platform parity, secrets). Both replace the web/mobile-web checks."}},"required":["type"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Get Checklist","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"get_d4d_framework","description":"Get the Design for Delight (D4D) framework templates. Returns customer problem statement, ideal state, hypothesis, LOFA, and experiment templates for structured product thinking.","inputSchema":{"type":"object","properties":{"stage":{"type":"string","enum":["frame","empathy","broad","narrow","experiment","recommendation","full"],"description":"Which stage of the D4D loop to return. Default: full (all stages)"}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Get D4D Framework","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"list_design_systems","description":"Browse available design systems for tokens. Filter by category (fintech, productivity, developer, component-library, design-system) or search by name.","inputSchema":{"type":"object","properties":{"category":{"type":"string","description":"Filter by category: fintech, productivity, developer, component-library, design-system"},"search":{"type":"string","description":"Search by name or description"}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"List Design Systems","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"get_design_system","description":"Get design tokens for a specific design system. Returns colors, typography, spacing, radii, elevation, and motion tokens in W3C DTCG, CSS custom properties, or flat format.","inputSchema":{"type":"object","properties":{"id":{"type":"string","description":"Design system ID (e.g. 'stripe', 'linear')"},"group":{"type":"string","description":"Filter to a token group: color, color-dark, color-light, typography, spacing, radius, elevation, motion"},"format":{"type":"string","enum":["dtcg","css","flat"],"description":"Output format: dtcg (W3C standard), css (custom properties), flat (key-value). Default: dtcg"}},"required":["id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Get Design System","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"compose_system","description":"Mix tokens from different design systems to create a custom composite. Example: Linear's colors + Stripe's typography.","inputSchema":{"type":"object","properties":{"compositions":{"type":"array","items":{"type":"object","properties":{"system":{"type":"string","description":"Source design system ID"},"group":{"type":"string","description":"Token group to take (color, typography, spacing, radius, elevation, motion)"}},"required":["system","group"],"additionalProperties":false},"description":"Array of system-group pairs to compose"},"format":{"type":"string","enum":["dtcg","css"],"description":"Output format. Default: dtcg"}},"required":["compositions"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Compose System","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"audit_page","description":"Audit HTML/CSS against Raven's design quality standards. Checks typography (min 13px, weight 400+, modular-scale heading ratios, line-height consistency), accessibility (WCAG touch targets, alt text, contrast), responsive patterns (flexbox over grid, clamp sizing, max-width containers), style guide compliance (CSS custom properties, no bare hex), and visual rhythm (4/8px spacing grid, tight spacing scale, palette size). Pass containerMaxWidth (your design system's canonical container token, in px) to make the max-width check token-aware — it then flags containers that diverge from your system (too narrow OR too wide) instead of a generic 1200px heuristic. Returns pass/fail per check with specific fix instructions.","inputSchema":{"type":"object","properties":{"html":{"type":"string","description":"The full HTML content of the page to audit"},"url":{"type":"string","description":"If set, Raven launches headless chromium, renders the page, and audits the RENDERED DOM."},"scroll_settle":{"type":"boolean","description":"Before capturing, step through the page with short pauses so IntersectionObserver/whileInView reveals fire, then return to the top and settle. Also plays preload=none videos. Prevents blank-section false positives."},"interactions":{"type":"array","items":{"type":"object","properties":{"selector":{"type":"string"},"event":{"type":"string","enum":["hover","click","focus"]},"delay_ms":{"type":"number"}},"required":["selector","event","delay_ms"],"additionalProperties":false},"description":"Before capturing, fire each interaction in order (hover/click/focus the selector, then wait delay_ms). Captures the resulting dynamic state — e.g. an on-hover theme-toggle wash invisible to a static screenshot."},"viewport":{"type":"object","properties":{"w":{"type":"number"},"h":{"type":"number"}},"required":["w","h"],"additionalProperties":false},"strict":{"type":"boolean","description":"Strict mode — also flags warnings as failures. Default: false"},"containerMaxWidth":{"type":"number","description":"Your design system's canonical content-container width in px (e.g. 1152). When set, the responsive/max-width check flags divergence from this token instead of using the generic 1200px heuristic."},"adversarial_verify":{"type":"boolean","description":"After generating findings, independently re-check each against the live DOM/network and tag it confirmed / likely-artifact / inconclusive. Surfaces a debunked_count."},"compact":{"type":"boolean","description":"Return only the decision-grade signal — score, grade, summary, errors, warnings, fix_priority — and drop the embedded base64 screenshot and the passes list (replaced by passes_count). Default false. Use when the full payload would blow the tool-result budget."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Audit Page","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"execution":{"taskSupport":"forbidden"}},{"name":"score_page","description":"Score an HTML/CSS page across 7 design categories (Structure, Typography, Color & palette, Spacing & rhythm, Accessibility, Responsive layout, Design tokens), each rated 0–10. Scores are derived deterministically from the same checks as audit_page — no browser required. Pass html directly, or pass url to have Raven launch headless chromium, render the page, and score the RENDERED DOM. Also returns the same overall 0–100 score and A–D grade audit_page produces, the weakest category, and the three categories Raven does not mechanically assess (brand, conversion, motion) with guidance on which tools to use for those.","inputSchema":{"type":"object","properties":{"html":{"type":"string","description":"The full HTML content of the page to score."},"url":{"type":"string","description":"If set, Raven launches headless chromium, renders the page, and scores the RENDERED DOM."},"strict":{"type":"boolean","description":"Strict mode — count warnings as failures in the overall score. Default: false."},"containerMaxWidth":{"type":"number","description":"Your design system's canonical content-container width in px (e.g. 1152). Forwarded to the responsive/max-width check."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Score Page","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"execution":{"taskSupport":"forbidden"}},{"name":"audit_parity","description":"Compare iOS vs Android element snapshots against a checklist of named spatial relationships (vertical centering, baseline/left alignment, equal gap/size, presence, truncation) and flag per-relation match/mismatch/uncertain — catches cross-platform layout drift like status text centered on one platform but top-aligned on the other. Provide ios+android {elements,viewport} snapshots and a checklist[].","inputSchema":{"type":"object","properties":{"ios":{"type":"object","properties":{"elements":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"id":{"type":"string"},"role":{"type":"string"},"rect":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"}},"required":["x","y","w","h"],"additionalProperties":false}},"required":["rect"],"additionalProperties":false}},"viewport":{"type":"object","properties":{"w":{"type":"number"},"h":{"type":"number"}},"required":["w","h"],"additionalProperties":false}},"required":["elements","viewport"],"additionalProperties":false},"android":{"type":"object","properties":{"elements":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"id":{"type":"string"},"role":{"type":"string"},"rect":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"}},"required":["x","y","w","h"],"additionalProperties":false}},"required":["rect"],"additionalProperties":false}},"viewport":{"type":"object","properties":{"w":{"type":"number"},"h":{"type":"number"}},"required":["w","h"],"additionalProperties":false}},"required":["elements","viewport"],"additionalProperties":false},"checklist":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"a":{"type":"string"},"b":{"type":"string"},"relation":{"type":"string","enum":["present","vertically-centered","baseline-aligned","left-aligned","equal-gap","equal-size","same-truncation"]},"tolerance":{"type":"number"}},"required":["name","a","relation"],"additionalProperties":false}}},"required":["ios","android","checklist"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Audit Parity","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"audit_ios_a11y","description":"Score an accessibility-enriched iOS element snapshot — missing accessibilityLabel/value/traits, sub-44pt tap targets, per-text WCAG contrast, Dynamic Type clipping, and VoiceOver reading order. Provide {elements:[{label,value,hint,traits,role,rect,fontPt,fgColor,bgColor,dynamicTypeClipped}],viewport}. Capture via the AccessibilitySnapshot XCUITest / ios-capture harness.","inputSchema":{"type":"object","properties":{"elements":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"string"},"hint":{"type":"string"},"traits":{"type":"array","items":{"type":"string"}},"role":{"type":"string"},"rect":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"}},"required":["x","y","w","h"],"additionalProperties":false},"fontPt":{"type":"number"},"fgColor":{"type":"string"},"bgColor":{"type":"string"},"dynamicTypeClipped":{"type":"boolean"}},"required":["rect"],"additionalProperties":false}},"viewport":{"type":"object","properties":{"w":{"type":"number"},"h":{"type":"number"}},"required":["w","h"],"additionalProperties":false},"options":{"type":"object","properties":{"minTarget":{"type":"number"}},"additionalProperties":false}},"required":["elements","viewport"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Audit iOS Accessibility","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"audit_responsive_visibility","description":"Render a URL at multiple breakpoints and flag content elements that are visible on desktop but hidden on mobile (display:none / opacity:0 / visibility:hidden / zero-size). Categorises each flag as 'likely-oversight' (content that vanishes on mobile — the hidden-on-mobile content bug) vs 'intentional' (decorative). Returns a table of selector / hiding-class / mobile-visible / desktop-visible / category. Requires headless chromium.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"URL to render (http/https or file://)"},"breakpoints":{"type":"array","items":{"type":"number"},"description":"Viewport widths in px. Default [390, 768, 1440, 2160]"},"viewportHeight":{"type":"number","description":"Render height in px. Default 900"}},"required":["url"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Audit Responsive Visibility","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"execution":{"taskSupport":"forbidden"}},{"name":"audit_contrast","description":"Compute WCAG contrast ratios for every text element on a rendered page (pass url) or from a supplied dom_snapshot. Reports AA (4.5:1 normal, 3:1 large) and AAA pass/fail per element and surfaces failing pairs with selector, ratio, and delta-to-pass — replacing manual eyedropper + ratio math.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"URL to render and measure (http/https or file://)"},"dom_snapshot":{"type":"array","items":{"type":"object","properties":{"selector":{"type":"string"},"color":{"type":"string"},"bgColor":{"type":"string"},"fontPx":{"type":"number"},"bold":{"type":"boolean"},"text":{"type":"string"}},"required":["selector","color","bgColor"],"additionalProperties":false},"description":"Pre-collected text elements to score without rendering"},"screenshot":{"type":"string","description":"Optional base64 PNG for caller reference; ratios are computed from the DOM, not pixels"}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Audit Contrast","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"execution":{"taskSupport":"forbidden"}},{"name":"suggest_contrast_fix","description":"Given failing WCAG color pairs, return the MINIMAL color change that clears the target ratio. For each {fg,bg} pair, computes the smallest foreground adjustment (and an alternative background adjustment) that reaches AA/AAA — with the achieved ratio and direction. Feeds directly from audit_contrast's failing pairs: pass them here to get concrete passing values instead of brute-forcing colors by hand. Pure offline math.","inputSchema":{"type":"object","properties":{"pairs":{"type":"array","items":{"type":"object","properties":{"selector":{"type":"string"},"fg":{"type":"string"},"bg":{"type":"string"},"fontPx":{"type":"number"},"bold":{"type":"boolean"},"targetRatio":{"type":"number"},"status":{"type":"string","enum":["pass","fail","indeterminate"]},"ratio":{"type":["number","null"]}},"required":["fg","bg"],"additionalProperties":false},"description":"Color pairs to remediate. Each: { selector?, fg, bg, fontPx?, bold?, targetRatio? }. fontPx/bold pick the large-text threshold; targetRatio overrides the level."},"level":{"type":"string","enum":["AA","AAA"],"description":"WCAG level when targetRatio is not given per-pair. Default AA."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Suggest Contrast Fix","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"audit_url","description":"Layer 0 render-and-capture audit: renders a LIVE URL at each viewport×theme, scroll-settles (fires whileInView/IntersectionObserver reveals; plays preload=none videos), fires hover/click/focus interactions, and captures real pixels + the rendered DOM. Then runs the existing audit_page rule engine, per-element WCAG contrast, responsive-visibility (desktop-shown/mobile-hidden), blank-media detection, sliced-image edge symmetry, and hover-state white-wash detection over the captures. Every finding is tagged confirmed | likely-artifact | inconclusive with its evidence, ranked by severity. This is the tool that catches real-world visual nits invisible to HTML-string/geometry audits: cropped images, blank videos, hover white-wash, sliced exports, and hidden-on-mobile content. Requires headless chromium.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"URL to render and audit (http/https or file://)"},"viewports":{"type":"array","items":{"type":"object","properties":{"w":{"type":"number"},"h":{"type":"number"},"label":{"type":"string"}},"required":["w","h"],"additionalProperties":false},"description":"Viewports to render. Default: iphone 393×852, desktop 1440×900, wide 2160×1200"},"themes":{"type":"array","items":{"type":"string","enum":["light","dark"]},"description":"Themes to toggle (prefers-color-scheme + data-theme/class). Default: ['light','dark']"},"scroll_settle":{"type":"boolean","description":"Step through the page with short pauses to fire reveal-on-scroll/IntersectionObserver content, play videos, then return to the top before capture. Default: true"},"interactions":{"type":"array","items":{"type":"object","properties":{"selector":{"type":"string"},"event":{"type":"string","enum":["hover","click","focus"]},"delay_ms":{"type":"number"}},"required":["selector","event","delay_ms"],"additionalProperties":false},"description":"Fire each interaction before capture; the resulting state is diffed against baseline to catch hover/click white-wash and obscured content."},"containerMaxWidth":{"type":"number","description":"Your design system's canonical container width in px — makes the max-width check token-aware."},"includeScreenshots":{"type":"boolean","description":"Include the base64 full-page PNG per capture in the result. Default: false (screenshots are large)."},"timeoutMs":{"type":"number","description":"Per-navigation timeout in ms. Default: 30000"},"compact":{"type":"boolean","description":"Drop per-capture base64 screenshots; keep findings, counts, and summary. Default false. Use when screenshots would blow the tool-result budget."}},"required":["url"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Audit URL","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"execution":{"taskSupport":"forbidden"}},{"name":"audit_content","description":"Evaluate an array of content items (headings, prose, CTAs, labels, captions, metrics, outcomes) against UX-writing principles and deterministic heuristics. Returns a per-item verdict (pass/warn/fail) with matched principle ids, concrete issues grounded in principle text, a before→after rewrite suggestion, and an aggregate summary. Heuristics: metric items must carry a number+unit; cta/label must be action-led and ≤4 words; prose flags passive voice, jargon, and hedging; headings flag filler openers and buzzwords; captions flag duplication of any heading in the batch. Pure offline — no network or browser. Use this instead of evaluate_design when you need per-item content verdicts rather than the principle library.","inputSchema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Optional stable id; auto-generated (item_N) if omitted."},"type":{"type":"string","enum":["prose","caption","heading","outcome","metric","cta","label"],"description":"Content type — selects which heuristics apply."},"text":{"type":"string","description":"The raw content string to evaluate."}},"required":["type","text"],"additionalProperties":false},"description":"Array of content items to audit."},"system":{"type":"string","description":"Optional content-system id (e.g. 'ux-writing'); recorded for traceability."},"goals":{"type":"array","items":{"type":"string"},"description":"Optional content goals (e.g. ['clarity','conversion']); recorded for traceability."}},"required":["items"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Audit Content","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"audit_typography","description":"Audit the typographic SCALE of a rendered page (pass url) or a pre-collected snapshot of text nodes. Emits a focused report: (a) MODULAR SCALE — detects the dominant ratio (~1.2/1.25/1.333/1.5) across distinct font sizes and flags off-scale outliers; (b) LINE-HEIGHT CONSISTENCY — unitless lh/fs ratio per node, identifies the body rhythm and flags outliers; (c) WEIGHT LADDER — distinct weights, flags >4 weights or non-standard CSS values. Returns scale, line_height, weight_ladder, nodes_analyzed, and findings[{rule,severity,selector,message,fix}]. Goes beyond audit_page's pass/fail typography checks. url mode requires headless chromium.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"URL to render and measure (http/https or file://). Requires headless chromium."},"nodes":{"type":"array","items":{"type":"object","properties":{"selector":{"type":"string"},"fontPx":{"type":"number"},"lineHeightPx":{"type":"number"},"fontWeight":{"type":"number"},"tag":{"type":"string"},"text":{"type":"string"}},"required":["selector","fontPx"],"additionalProperties":false},"description":"Pre-collected text nodes to analyze without rendering."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Audit Typography","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"execution":{"taskSupport":"forbidden"}},{"name":"audit_tap_targets","description":"WCAG 2.5.5 / Apple 44pt tap-target audit for the web. Collects every interactive element (a, button, [role=button], input[type=submit/button/checkbox/radio], select, summary, label[for], [onclick], [tabindex>=0]) and emits a PER-ELEMENT fix table for any whose rendered width or height is below the minimum (default 44px): selector, role, visible text, measured w/h, pixel deficit per axis, and a concrete CSS fix. Sorted worst-first. Two modes: pass url (renders in headless chromium, measures real getBoundingClientRect) or pass elements[] snapshot (pure, no browser).","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"URL to render and measure. Requires headless chromium."},"elements":{"type":"array","items":{"type":"object","properties":{"selector":{"type":"string"},"w":{"type":"number"},"h":{"type":"number"},"x":{"type":"number"},"y":{"type":"number"},"role":{"type":"string"},"text":{"type":"string"}},"required":["selector","w","h"],"additionalProperties":false},"description":"Pre-collected interactive elements to score without rendering."},"minSize":{"type":"number","description":"Minimum tap-target size in px on each axis. Default 44."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Audit Tap Targets","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"execution":{"taskSupport":"forbidden"}},{"name":"get_brand_system","description":"Get a complete design system for building an app with branding like a specific company. Say 'Make me an app with branding like Spotify' and get the full token set, style guide, and implementation instructions. Matches against 12 known design systems and provides closest match with ready-to-use CSS.","inputSchema":{"type":"object","properties":{"company":{"type":"string","description":"The company whose branding to use (e.g. 'Spotify', 'Stripe', 'Apple', 'Linear', 'Airbnb')"},"format":{"type":"string","enum":["css","dtcg","guide"],"description":"Output format: 'css' for CSS variables, 'dtcg' for W3C tokens, 'guide' for full implementation guide. Default: guide"},"mode":{"type":"string","enum":["light","dark"],"description":"Color mode preference. Default: based on the system's primary mode"}},"required":["company"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Get Brand System","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"generate_design_system","description":"Generate a complete, custom design system with full token set. Provide a brand color to auto-generate a harmonious palette, pick a style preset, and export as visual HTML documentation, CSS variables, W3C DTCG JSON, Figma Variables, or SVG palette card. The HTML export is a beautiful, self-contained page suitable for sharing with stakeholders.","inputSchema":{"type":"object","properties":{"name":{"type":"string","description":"Name for the design system (e.g. 'Acme Corp', 'NightOwl')"},"base_system":{"type":"string","description":"Start from an existing system as foundation (e.g. 'stripe', 'linear'). Colors will be replaced by brand_color if provided."},"brand_color":{"type":"string","description":"Primary brand hex color (e.g. '#FF6B35'). Auto-generates a full harmonious palette using color theory."},"style":{"type":"string","enum":["minimal","bold","warm","corporate","playful","dark"],"description":"Aesthetic direction — influences spacing, radii, shadows, motion, and typography. Default: minimal"},"dark_mode":{"type":"boolean","description":"Generate dark mode tokens alongside light. Default: true"},"format":{"type":"string","enum":["html","css","dtcg","figma","svg","all"],"description":"Export format: html (visual doc page), css (custom properties), dtcg (W3C JSON), figma (Figma Variables JSON), svg (color palette card), all. Default: html"}},"required":["name"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Generate Design System","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"audit_layout","description":"Evaluate visual rhythm from a rendered page's geometry. Call with no arguments to get a DevTools snippet to paste into your page — it prints {elements, viewport} JSON. Call again with that JSON to get alignment, gap-rhythm, and optical-balance scores. This is the complement to audit_page for things only visible once rendered.","inputSchema":{"type":"object","properties":{"elements":{"type":"array","items":{"type":"object","properties":{"selector":{"type":"string"},"rect":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"}},"required":["x","y","w","h"],"additionalProperties":false},"computed":{"type":"object","properties":{"padding":{"type":"string"},"margin":{"type":"string"},"gap":{"type":"string"},"fontSize":{"type":"string"},"color":{"type":"string"},"background":{"type":"string"}},"additionalProperties":false}},"required":["selector","rect"],"additionalProperties":false},"description":"Array of element rects captured from the rendered page via the DevTools snippet"},"viewport":{"type":"object","properties":{"w":{"type":"number"},"h":{"type":"number"}},"required":["w","h"],"additionalProperties":false,"description":"Viewport dimensions {w,h} at capture time"}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Audit Layout","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"audit_swiftui","description":"Audit SwiftUI source against Apple's Human Interface Guidelines. Flags hardcoded .font(.system(size:)) below ~13pt and tiny semantic fonts (.caption/.caption2), hardcoded Color(red:green:blue:)/hex instead of asset-catalog or semantic system colors, an empty/undefined AccentColor, interactive frames below 44×44pt, and ad-hoc spacing off the 4/8-pt grid. Rewards semantic Dynamic Type fonts, semantic system colors, SF Symbols, and flexible frames. iOS-native checks only — no web/CSS rules. Returns pass/fail per check with fix instructions.","inputSchema":{"type":"object","properties":{"source":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"SwiftUI source — a single file/view as a string, or an array of file contents. Concatenated before analysis."},"accent_color_contents":{"type":"string","description":"Optional raw Contents.json of AccentColor.colorset. When provided, the tool verifies AccentColor actually defines color components (flags an empty/undefined accent color as an error)."},"strict":{"type":"boolean","description":"Strict mode — also count warnings as failures for grading. Default: false"},"project":{"type":"string","description":"Project identifier — resolves a saved taste surface binding (see bind_taste_surface). When the binding carries design_notes, each note is verified against the source (animation/material/haptic/font APIs) and returned in note_assessments; missing notes count toward the grade."},"profile":{"type":"string","description":"Taste profile owning the binding. Omit to search all stored profiles for one bound to the project."}},"required":["source"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Audit Swiftui","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"audit_screen","description":"Audit a rendered mobile screen (iOS or Android) from a view-hierarchy/accessibility snapshot. Call with no arguments for the expected snapshot shape and how to capture it. Pass platform:\"android\" to score against the 48dp Material touch minimum and Material muted roles (onSurfaceVariant/outline = warn not fail); default platform:\"ios\" scores 44pt and treats secondaryLabel/tertiaryLabel as platform-standard. Both score touch targets, contrast, and visual rhythm (alignment, gap consistency, optical balance). Same return shape as audit_page.","inputSchema":{"type":"object","properties":{"platform":{"type":"string","enum":["ios","android"],"description":"Target platform — 'ios' (default, 44pt minimum, iOS semantic colors) or 'android' (48dp minimum, Material semantic roles)"},"scroll_settle":{"type":"boolean"},"project":{"type":"string","description":"Project identifier — resolves a saved taste surface binding (see bind_taste_surface). When the binding carries design_notes and a screenshot is passed, the screenshot's pixels verify the color-scheme notes; results gain note_assessments."},"profile":{"type":"string","description":"Taste profile owning the binding. Omit to search all stored profiles for one bound to the project."},"elements":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"rect":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"}},"required":["x","y","w","h"],"additionalProperties":false},"role":{"type":"string","description":"Accessibility role/trait, e.g. button, link, cell, staticText, image, tab, textField"},"fontPt":{"type":"number","description":"Effective font point/dp size, if text"},"fgColor":{"type":"string","description":"Foreground color — hex (#1c1c1e), rgb(), or a platform semantic name ('secondaryLabel' iOS / 'onSurfaceVariant' Android)"},"bgColor":{"type":"string","description":"Background color behind this element — hex, rgb(), or semantic name"}},"required":["rect"],"additionalProperties":false},"description":"Elements captured from the rendered screen via an accessibility/view-hierarchy snapshot"},"viewport":{"type":"object","properties":{"w":{"type":"number"},"h":{"type":"number"}},"required":["w","h"],"additionalProperties":false,"description":"Screen size in pt (iOS) or dp (Android) at capture time, e.g. {w:393,h:852} iPhone 15, {w:412,h:915} Pixel"},"screenshot":{"type":"string","description":"Optional base64 PNG of the screen, for the caller's reference. Geometry is scored from the snapshot, not decoded pixels."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Audit Screen","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"audit_ios_screen","description":"Audit a rendered iOS screen from a view-hierarchy/accessibility snapshot (and optional screenshot). Alias of audit_screen with platform:\"ios\". Call with no arguments for the expected snapshot shape. Call with {elements:[{label,rect:{x,y,w,h},role,fontPt,fgColor,bgColor}],viewport:{w,h}} to score 44×44pt touch targets, contrast (with iOS secondaryLabel/tertiaryLabel treated as platform-standard — warn not fail), and visual rhythm (alignment, gap consistency, optical balance) in points. Same return shape as audit_page.","inputSchema":{"type":"object","properties":{"project":{"type":"string","description":"Project identifier — resolves a saved taste surface binding (see bind_taste_surface). When the binding carries design_notes and a screenshot is passed, the screenshot's pixels verify the color-scheme notes; results gain note_assessments."},"profile":{"type":"string","description":"Taste profile owning the binding. Omit to search all stored profiles for one bound to the project."},"elements":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"rect":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"}},"required":["x","y","w","h"],"additionalProperties":false},"role":{"type":"string","description":"Accessibility role/trait, e.g. button, link, cell, staticText, image, tab, textField"},"fontPt":{"type":"number","description":"Effective font point/dp size, if text"},"fgColor":{"type":"string","description":"Foreground color — hex (#1c1c1e), rgb(), or a platform semantic name ('secondaryLabel' iOS / 'onSurfaceVariant' Android)"},"bgColor":{"type":"string","description":"Background color behind this element — hex, rgb(), or semantic name"}},"required":["rect"],"additionalProperties":false},"description":"Elements captured from the rendered screen via an accessibility/view-hierarchy snapshot"},"viewport":{"type":"object","properties":{"w":{"type":"number"},"h":{"type":"number"}},"required":["w","h"],"additionalProperties":false,"description":"Screen size in pt (iOS) or dp (Android) at capture time, e.g. {w:393,h:852} iPhone 15, {w:412,h:915} Pixel"},"screenshot":{"type":"string","description":"Optional base64 PNG of the screen, for the caller's reference. Geometry is scored from the snapshot, not decoded pixels."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Audit iOS Screen","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"audit_ios_privacy","description":"Audit an iOS or React Native/Expo app's privacy posture for App Review and user trust. Reads a native Info.plist XML OR an Expo app.json (managed Expo apps have no Info.plist) — plus optional PRIVACY.md, entitlements, and source. Flags: NS*UsageDescription strings that are vague/missing or contradict the code (e.g. a HealthKit write claim the code never fulfills), entitlements/permissions and Android permissions the app doesn't use, ATS cleartext exceptions and non-HTTPS endpoints, secrets/keys shipped in the bundle or app.json, and default data-egress paths not disclosed at the point of choice (a pre-selected 'Recommended' option that silently sends personal data to a server). Same return shape as audit_page.","inputSchema":{"type":"object","properties":{"info_plist":{"type":"string","description":"Raw Info.plist XML (native iOS / bare RN). Provide this OR app_json."},"app_json":{"type":"string","description":"Expo app.json / app.config JSON (managed RN). Its expo.ios.infoPlist, expo.android.permissions, plugins, and extra are audited."},"privacy_md":{"type":"string","description":"Optional PRIVACY.md / privacy policy text to cross-reference against declared permissions and default behavior"},"entitlements":{"type":"string","description":"Optional .entitlements XML"},"source":{"type":"string","description":"Optional concatenated source (Swift or JS/TS) — enables code-vs-declaration contradiction checks and default-egress detection"}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Audit iOS Privacy","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"audit_rn","description":"Audit React Native / Expo source (JSX/TSX + StyleSheet) against the iOS HIG + Android Material conventions RN must satisfy. Flags touchables missing accessibilityLabel/accessibilityRole, touchables below 44pt without hitSlop, allowFontScaling={false}, fontSize below ~13, screens without SafeAreaView, and (for multi-mode apps) hardcoded colors with no useColorScheme/Appearance dark-mode handling. Rewards SafeAreaView, hitSlop, Platform-aware code, and a theme. RN-native checks only — no web/CSS or SwiftUI rules. Same return shape as audit_page. (RN renders to native widgets, so audit_ios_screen scores the rendered screen.)","inputSchema":{"type":"object","properties":{"source":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"React Native source — a single screen/component as a string, or an array of file contents. Concatenated before analysis."},"color_scheme":{"type":"string","enum":["light","dark","automatic"],"description":"The app's declared appearance (Expo app.json userInterfaceStyle). 'light' or 'dark' means single-mode by design — the dark-mode adaptation check is then suppressed. Default: automatic."},"strict":{"type":"boolean","description":"Strict mode — also count warnings as failures for grading. Default: false"},"project":{"type":"string","description":"Project identifier — resolves a saved taste surface binding (see bind_taste_surface). When the binding carries design_notes, each note is verified against the source (Animated/Reanimated, BlurView, haptics, fonts) and returned in note_assessments; missing notes count toward the grade."},"profile":{"type":"string","description":"Taste profile owning the binding. Omit to search all stored profiles for one bound to the project."}},"required":["source"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Audit React Native","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"list_content_systems","description":"Browse available content design systems — brand voice and tone guides (Conversational Product Voice, GOV.UK, Shopify Polaris, Atlassian). Filter by category or search by name.","inputSchema":{"type":"object","properties":{"category":{"type":"string","description":"Filter by category: marketing-saas, government, commerce-saas, productivity-saas, fintech"},"search":{"type":"string","description":"Search by name, description, or tag"}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"List Content Systems","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"get_content_system","description":"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.","inputSchema":{"type":"object","properties":{"id":{"type":"string","description":"Content system ID (e.g. 'conversational-product-voice', 'gov-uk', 'shopify-polaris', 'atlassian')"},"section":{"type":"string","enum":["all","voice","tone_shifts","vocabulary","grammar","content-patterns","inclusive-language"],"description":"Return just one section. Default: all."}},"required":["id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Get Content System","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"get_content_principles","description":"Get UX-writing principles — clarity over cleverness, active voice, error-message anatomy, inclusive language, voice vs tone, and more. Filter by the writing context (e.g. 'error messages', 'notifications', 'form labels').","inputSchema":{"type":"object","properties":{"context":{"type":"string","description":"What you're writing for (e.g. 'error messages', 'onboarding copy', 'empty state', 'notification'). Omit to get all UX-writing principles."},"format":{"type":"string","enum":["full","checklist","brief"],"description":"Output format: full (all details), checklist (implications + violations), brief (just summary). Default: full"}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Get Content Principles","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"get_content_pattern","description":"Get content design patterns — copy recipes for error messages, empty-state copy, notifications, and form validation. Returns do's, don'ts, good/bad examples, evidence, and a checklist.","inputSchema":{"type":"object","properties":{"type":{"type":"string","enum":["error-messages","empty-state-copy","notifications","form-validation"],"description":"Content pattern type"}},"required":["type"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Get Content Pattern","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"get_research_method","description":"Get research method details — qualitative (interviews, contextual inquiry, diary, field, intercept), quantitative (surveys, analytics, A/B tests, benchmarking, clickstream), or usability (moderated, unmoderated, 5-second, card sort, tree test, heuristic eval). Returns specific protocols, do/don't guidance, evidence, and a checklist. Use when the user is designing a study or asking how to measure something.","inputSchema":{"type":"object","properties":{"category":{"type":"string","enum":["qualitative","quantitative","usability","all"],"description":"Which family of methods. Default: all."},"search":{"type":"string","description":"Search within methods by name or description."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Get Research Method","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"get_metrics_framework","description":"Get a product-metrics framework — HEART (Google), AARRR/Pirate (Dave McClure), North Star Metric, Conversion Funnel, RICE Scoring, or OKRs. Returns structure, when-to-use, pitfalls, and examples. Use when the user asks 'how should we measure success?' or 'what metrics should we track?'","inputSchema":{"type":"object","properties":{"id":{"type":"string","description":"Framework id (heart, aarrr, north-star-metric, conversion-funnel, rice-scoring, okrs). Omit to list all."},"search":{"type":"string","description":"Search for a framework by name or summary."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Get Metrics Framework","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"get_service_pattern","description":"Get a service design pattern — service blueprinting, human handoff, signup-as-service, omnichannel continuity, or moments of truth / recovery. Returns patterns, do/don't guidance, evidence, and a checklist. Use when the user is designing a service flow, escalation, cross-channel experience, or moment of truth.","inputSchema":{"type":"object","properties":{"type":{"type":"string","enum":["service-blueprinting","human-handoff","signup-as-service","omnichannel-continuity","moments-of-truth"],"description":"Service design pattern type"}},"required":["type"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Get Service Pattern","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"get_service_standard","description":"Get the GOV.UK Service Standard — 14 points the UK government uses to assess whether a public service is ready to launch. Widely applicable as a rigorous service-quality checklist beyond government. Use when the user asks how to evaluate a whole service.","inputSchema":{"type":"object","properties":{}},"annotations":{"title":"Get Service Standard","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"generate_service_blueprint","description":"Render a service blueprint as a self-contained HTML page. Supports two modes: (1) classic Shostack single-actor blueprint — user action, frontstage, backstage, support, evidence, pain/delight; (2) two-actor HI-loop blueprint — when `actors` is supplied, renders two swim lanes with a line of interaction between them (e.g. customer ↔ lawyer, patient ↔ doctor, buyer ↔ agent). Each actor gets their own actions, frontstage (what they see), and evidence. Optionally accepts an ideal-state to render side-by-side with the current state.","inputSchema":{"type":"object","properties":{"service_name":{"type":"string","description":"Name of the service (e.g. 'Free trial signup', 'Client intake', 'Restaurant reservation')"},"subtitle":{"type":"string","description":"Short description or context line under the title"},"actors":{"type":"object","properties":{"a":{"type":"object","properties":{"label":{"type":"string"}},"required":["label"],"additionalProperties":false,"description":"Actor A label (default: 'User'). Use when you want to name the first side (e.g. 'Customer', 'Patient')."},"b":{"type":"object","properties":{"label":{"type":"string"}},"required":["label"],"additionalProperties":false,"description":"Actor B label (e.g. 'Lawyer', 'Doctor', 'Agent'). Presence of this field switches to two-actor layout."}},"required":["b"],"additionalProperties":false,"description":"Omit for classic single-actor Shostack blueprint. Provide to render a two-swim-lane HI-loop blueprint with a line of interaction between the two sides."},"current":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","description":"Step label (e.g. 'Discover', 'Sign up', 'First use')"},"user_action":{"type":"string","description":"In single-actor: what the user does. In two-actor: what actor A does."},"frontstage":{"type":"string","description":"In single-actor: what the user SEES (UI, agent greeting). In two-actor: what actor A sees."},"backstage":{"type":"string","description":"What neither actor sees directly — shared systems, internal processes, back-office work"},"support":{"type":"string","description":"Supporting processes, systems, third-party dependencies"},"evidence":{"type":"string","description":"In single-actor: artifact user receives. In two-actor: artifact actor A has."},"pain_point":{"type":"string","description":"Known pain point at this step (shown as red callout)"},"delight":{"type":"string","description":"Designed moment of delight at this step (shown as green callout)"},"actor_b":{"type":"object","properties":{"action":{"type":"string","description":"What actor B does in this step"},"frontstage":{"type":"string","description":"What actor B sees — their own UI, tools, views"},"evidence":{"type":"string","description":"Artifact actor B has — case file, notes, record"}},"additionalProperties":false,"description":"Only used when `actors.b` is provided. Captures the other side of the interaction."}},"required":["label"],"additionalProperties":false},"description":"The current-state blueprint as an array of steps"},"ideal":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"user_action":{"type":"string"},"frontstage":{"type":"string"},"backstage":{"type":"string"},"support":{"type":"string"},"evidence":{"type":"string"},"pain_point":{"type":"string"},"delight":{"type":"string"},"actor_b":{"type":"object","properties":{"action":{"type":"string"},"frontstage":{"type":"string"},"evidence":{"type":"string"}},"additionalProperties":false}},"required":["label"],"additionalProperties":false},"description":"Optional ideal-state blueprint — if provided, output shows current AND ideal side-by-side"}},"required":["service_name","current"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Generate Service Blueprint","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"get_brand_principles","description":"Get brand and visual-design principles — logo usage (clear space, min sizes, variants, placement, restraint), gradient usage (hierarchy, palette, contrast, trend vs signature), imagery (consistency, representation, purpose), visual hierarchy, and brand-as-system thinking. Use when the user asks about branding, logos, gradients, imagery, visual consistency, or how to treat a brand across surfaces.","inputSchema":{"type":"object","properties":{"topic":{"type":"string","description":"Filter by topic: 'logo', 'gradient', 'imagery', 'hierarchy', 'system', or a freeform search term. Omit to return all brand principles."},"format":{"type":"string","enum":["full","checklist","brief"],"description":"Output format. Default: full."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Get Brand Principles","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"get_brand_trends","description":"Get current brand and visual-design trends — what's working in 2026 and where each trend fits or fails. Includes bento grids, monospace type, neon-on-dark-glass, generative patterns, brutalism rebound, AI-generated imagery, lowercase/mixed case. Each trend is time-stamped — treat as a calibration signal, not a prescription.","inputSchema":{"type":"object","properties":{}},"annotations":{"title":"Get Brand Trends","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"list_creative_models","description":"Browse Raven's provider-agnostic creative model catalog. These are capability slots for image, video, 3D, audio, character consistency, and creative analysis. Use a configured RAVEN_CREATIVE_RUNNER to route jobs to any local CLI or API wrapper.","inputSchema":{"type":"object","properties":{"media_type":{"type":"string","enum":["image","video","audio","3d","campaign","analysis"],"description":"Filter by media type."},"capability":{"type":"string","description":"Filter by capability, e.g. product-photoshoot, text-to-video, brand-kit, ugc-ad."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"List Creative Models","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"list_creative_presets","description":"Browse Raven creative presets for product photoshoots, marketplace cards, UGC ads, TV spots, cinematic reveals, social launch packs, storyboards, and infographics.","inputSchema":{"type":"object","properties":{"media_type":{"type":"string","enum":["image","video","campaign"],"description":"Filter presets by media type."},"search":{"type":"string","description":"Search preset name or description."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"List Creative Presets","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"score_creative","description":"Score a creative prompt, script, or ad concept for hook strength, benefit clarity, product signal, call-to-action, channel fit, audience fit, and brand fit. This is a transparent heuristic, not a proprietary prediction model.","inputSchema":{"type":"object","properties":{"creative_text":{"type":"string","description":"Prompt, script, ad copy, or creative concept to score."},"channel":{"type":"string","description":"Target channel."},"brand_profile_id":{"type":"string","description":"Local Raven brand profile ID."},"audience":{"type":"string","description":"Target audience if not in a brand profile."}},"required":["creative_text"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"title":"Score Creative","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"execution":{"taskSupport":"forbidden"}},{"name":"audit_consistency","description":"Audit multiple pages for cross-page consistency of content-container width and hero heading tier. Pass ≥2 pages ({name, html}) collected from different routes on the same site. Infers the canonical (modal) value from the corpus when no token is supplied, so you need not know the project's design token in advance. Flags the issue #9 single-blob blind spot: pages that each pass audit_page but silently disagree with each other on container width or hero size class. Returns per-page extraction (container_px, container_classes, hero_classes, signatures), consistency dimensions with reference values, outlier page names, issues[], score (100/50/0 → A/C/D), and a plain-text summary. Pure offline — no browser, no network.","inputSchema":{"type":"object","properties":{"pages":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"Page route or label (e.g. \"/\", \"/changelog\", \"get-started\")."},"html":{"type":"string","minLength":1,"description":"Full HTML source for the page, including any