webforJ MCP Server

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['appName', 'reasoning'], 'properties': {'flavor': {'enum': ['webforj', 'webforj-spring'], 'type': 'string', 'description': 'Project flavor (default: webforj-spring)'}, 'appName': {'type': 'string', 'minLength': 1, 'description': 'webforJ application name'}, 'groupId': {'type': 'string', 'description': 'Maven group ID (default: com.<artifactId-without-hyphens>)'}, 'version': {'type': 'string', 'description': 'Project version (default: 1.0-SNAPSHOT)'}, 'archetype': {'enum': ['blank', 'hello-world', 'tabs', 'sidemenu'], 'type': 'string', 'description': 'Archetype template (default: hello-world)'}, 'reasoning': {'type': 'string', 'minLength': 1, 'description': 'Your step-by-step reasoning for why you are calling this tool and what you expect it to return. Stating it explicitly before the call helps you pick the right arguments, avoid redundant calls, and stay on the documented routing path for this tool.'}, 'artifactId': {'type': 'string', 'description': 'Maven artifact ID (default: kebab-case of appName)'}, 'showOptions': {'type': 'boolean', 'description': 'If true, list archetypes and startforJ info instead of generating. Default: false.'}, 'archetypeVersion': {'type': 'string', 'description': 'webforJ archetype version (default: LATEST)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['primaryColor', 'webforjVersion', 'reasoning'], 'properties': {'step': {'type': 'number', 'maximum': 20, 'minimum': 1, 'description': 'Step size for contrast calculations (pre-25.12 only, default: 5).'}, 'reasoning': {'type': 'string', 'minLength': 1, 'description': 'Your step-by-step reasoning for why you are calling this tool and what you expect it to return. Stating it explicitly before the call helps you pick the right arguments, avoid redundant calls, and stay on the documented routing path for this tool.'}, 'themeName': {'type': 'string', 'description': 'Optional theme name for multi-theme applications. Omit for global CSS overrides.'}, 'infoDegree': {'type': 'number', 'maximum': 360, 'minimum': 0, 'description': 'Degree offset for info/secondary color (pre-25.12 only, default: 180).'}, 'primaryColor': {'type': 'array', 'items': [{'type': 'number', 'maximum': 360, 'minimum': 0, 'description': 'Hue (0-360)'}, {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Saturation (0-100)'}, {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Lightness (0-100)'}], 'maxItems': 3, 'minItems': 3, 'description': 'Primary color in HSL format: [hue, saturation, lightness]. Example: [220, 70, 50] for blue.'}, 'webforjVersion': {'type': 'string', 'pattern': '^\\d+\\.\\d+(-SNAPSHOT)?$', 'description': 'The webforJ version you are targeting, exactly as it appears in the project\'s pom.xml: a released major.minor like "25.12", or the current upcoming SNAPSHOT like "26.00-SNAPSHOT" (only the next unreleased version is published as SNAPSHOT; there is just one active SNAPSHOT at any time). Read it from pom.xml or ask the user.'}, 'tintScaleFactor': {'type': 'number', 'description': 'Scale factor for tint generation (pre-25.12 only, default: 0).'}, 'tintBaseSaturation': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Base saturation for neutral grey tints (pre-25.12 only, default: 10).'}, 'contrastSensitiveLightness': {'type': 'boolean', 'description': 'Use contrast-sensitive lightness calculations (pre-25.12 only, default: false).'}, 'detectPrimaryColorCategory': {'type': 'boolean', 'description': 'Auto-detect color category for optimization (pre-25.12 only, default: true).'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['webforjVersion', 'reasoning'], 'properties': {'content': {'type': 'string', 'minLength': 1, 'description': 'A Java source snippet or file. The handler extracts every `import X.Y.Z;` line it contains and validates each FQCN against the catalog. Static imports and wildcard imports are skipped. Provide either this field OR `imports`, never both in the same call.'}, 'imports': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'minItems': 1, 'description': 'A list of fully qualified class names to validate. Pass one or many; each entry is checked independently. Use this field when you already have the FQCN strings in hand. Provide either this field OR `content`, never both in the same call.'}, 'reasoning': {'type': 'string', 'minLength': 1, 'description': 'Your step-by-step reasoning for why you are calling this tool and what you expect it to return. Stating it explicitly before the call helps you pick the right arguments, avoid redundant calls, and stay on the documented routing path for this tool.'}, 'webforjVersion': {'type': 'string', 'pattern': '^\\d+\\.\\d+(-SNAPSHOT)?$', 'description': 'The webforJ version you are targeting, exactly as it appears in the project\'s pom.xml: a released major.minor like "25.12", or the current upcoming SNAPSHOT like "26.00-SNAPSHOT" (only the next unreleased version is published as SNAPSHOT; there is just one active SNAPSHOT at any time). Read it from pom.xml or ask the user.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'reasoning'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Document id. Take this from the `documentId` field of a search_knowledge_base result. Stable, unique per document.'}, 'reasoning': {'type': 'string', 'minLength': 1, 'description': 'Your step-by-step reasoning for why you are calling this tool and what you expect it to return. Stating it explicitly before the call helps you pick the right arguments, avoid redundant calls, and stay on the documented routing path for this tool.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['reasoning'], 'properties': {'reasoning': {'type': 'string', 'minLength': 1, 'description': 'Your step-by-step reasoning for why you are calling this tool and what you expect it to return. Stating it explicitly before the call helps you pick the right arguments, avoid redundant calls, and stay on the documented routing path for this tool.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query', 'reasoning'], 'properties': {'type': {'enum': ['documentation', 'java', 'sample', 'kotlin', 'all'], 'type': 'string', 'description': 'Restrict results to a single content type. "documentation" = markdown docs and guides, "java" = webforJ Java API signatures, "sample" = Java sample programs, "kotlin" = webforJ Kotlin DSL source. Default: "all".'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Maximum number of search results to return (default: 25).'}, 'query': {'type': 'string', 'minLength': 1, 'description': 'Natural language query. Examples: "how to create buttons", "form validation", "data binding", "routing with @Route annotation".'}, 'reasoning': {'type': 'string', 'minLength': 1, 'description': 'Your step-by-step reasoning for why you are calling this tool and what you expect it to return. Stating it explicitly before the call helps you pick the right arguments, avoid redundant calls, and stay on the documented routing path for this tool.'}, 'categories': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'description': 'Restrict results to one or more categories (any-of). Omit the field, pass an empty array, or include "all" to search every category. Prefer passing categories when the query is scoped (e.g. ["button"] for a button question, ["button","flexlayout"] for a button-inside-a-layout question). If any entry is not a known category the tool returns isError with ranked similar-name suggestions per bad entry and the full list of valid categories, so a corrected retry will succeed.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['webforjVersion', 'reasoning'], 'properties': {'mode': {'enum': ['lookup', 'list', 'map'], 'type': 'string', 'description': '"lookup" (default): return a single component\'s styling metadata. "list": return every valid DWC tag for the target webforJ version. "map": return the Java class -> DWC tag mapping.'}, 'name': {'type': 'string', 'description': 'The component to look up. Accepts a DWC tag ("dwc-button") or a webforJ Java class name ("Button", "TextField"). Omit when mode is "list" or "map".'}, 'reasoning': {'type': 'string', 'minLength': 1, 'description': 'Your step-by-step reasoning for why you are calling this tool and what you expect it to return. Stating it explicitly before the call helps you pick the right arguments, avoid redundant calls, and stay on the documented routing path for this tool.'}, 'webforjVersion': {'type': 'string', 'pattern': '^\\d+\\.\\d+(-SNAPSHOT)?$', 'description': 'The webforJ version you are targeting, exactly as it appears in the project\'s pom.xml: a released major.minor like "25.12", or the current upcoming SNAPSHOT like "26.00-SNAPSHOT" (only the next unreleased version is published as SNAPSHOT; there is just one active SNAPSHOT at any time). Read it from pom.xml or ask the user.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['webforjVersion', 'reasoning'], 'properties': {'prefix': {'type': 'string', 'description': 'Return only tokens that start with this string. Examples: "--dwc-color-primary-" for every primary-palette shade, "--dwc-space-" for spacing, "--dwc-color-" for all color tokens.'}, 'contains': {'type': 'string', 'description': 'Return only tokens that contain this substring anywhere. Useful for cross-palette queries like "seed" (all palette seeds) or "text" (all text-contrast shades).'}, 'reasoning': {'type': 'string', 'minLength': 1, 'description': 'Your step-by-step reasoning for why you are calling this tool and what you expect it to return. Stating it explicitly before the call helps you pick the right arguments, avoid redundant calls, and stay on the documented routing path for this tool.'}, 'webforjVersion': {'type': 'string', 'pattern': '^\\d+\\.\\d+(-SNAPSHOT)?$', 'description': 'The webforJ version you are targeting, exactly as it appears in the project\'s pom.xml: a released major.minor like "25.12", or the current upcoming SNAPSHOT like "26.00-SNAPSHOT" (only the next unreleased version is published as SNAPSHOT; there is just one active SNAPSHOT at any time). Read it from pom.xml or ask the user.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['content', 'webforjVersion', 'reasoning'], 'properties': {'content': {'type': 'string', 'minLength': 1, 'description': 'The CSS, Java, Markdown, or MDX text to scan. Every --dwc-* reference is checked against the real DWC global tokens and the component CSS variables for the target webforJ version.'}, 'reasoning': {'type': 'string', 'minLength': 1, 'description': 'Your step-by-step reasoning for why you are calling this tool and what you expect it to return. Stating it explicitly before the call helps you pick the right arguments, avoid redundant calls, and stay on the documented routing path for this tool.'}, 'webforjVersion': {'type': 'string', 'pattern': '^\\d+\\.\\d+(-SNAPSHOT)?$', 'description': 'The webforJ version you are targeting, exactly as it appears in the project\'s pom.xml: a released major.minor like "25.12", or the current upcoming SNAPSHOT like "26.00-SNAPSHOT" (only the next unreleased version is published as SNAPSHOT; there is just one active SNAPSHOT at any time). Read it from pom.xml or ask the user.'}}, 'additionalProperties': False}