# webforJ MCP Server (remote · mcp.webforj.com)

WebforJ's MCP server, provides tools, resources, prompts for scaffolding and developing webforJ apps

- Trust score: 64/100 (medium)
- Change this week: +5
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `mcp.webforj.com`: 69/100, [markdown](https://verifymcp.io/servers/com-webforj-mcp/mcp.md), [page](https://verifymcp.io/servers/com-webforj-mcp/mcp)
- remote · `mcp.webforj.com`: 64/100 (this document), [markdown](https://verifymcp.io/servers/com-webforj-mcp/mcp-2.md), [page](https://verifymcp.io/servers/com-webforj-mcp/mcp-2)

## Channel facts

- Endpoint: `https://mcp.webforj.com/sse`
- Transports: `sse`
- Auth: `none`
- Version: `1.0.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 74/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one.
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 40/100
  - Verified sse transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 56/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 3712 tokens (~412/item across 9 items; 9 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http com-webforj-mcp https://mcp.webforj.com/sse
```

### Codex

```toml
[mcp_servers.com-webforj-mcp]
url = "https://mcp.webforj.com/sse"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "com-webforj-mcp": {
      "type": "remote",
      "url": "https://mcp.webforj.com/sse",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add com-webforj-mcp --url https://mcp.webforj.com/sse --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  com-webforj-mcp:
    url: "https://mcp.webforj.com/sse"
```

### Other

```json
{
  "mcpServers": {
    "com-webforj-mcp": {
      "type": "http",
      "url": "https://mcp.webforj.com/sse"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 64, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-01 (score 63, +1)

No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-31 (score 62, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 61, +1)

No change was recorded against any check on this day. Stability & Change Management went from 10 to 13. That category is still filling its 30-day observation window: 3 days of observed history at the previous scan, 4 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-28 (score 60, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-27 (score 59, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 58)

First indexed and scored.

## MCP tools (9)

### `get_versions` (~206 tokens)

webforJ Version Catalog

Report the webforJ versions this server knows about. Returns the latest stable release, the current in-development SNAPSHOT (from the main-branch pom.xml), and an array of every major with its highest observed tag plus a `status` flag: "development" (the active SNAPSHOT line — actively changing), "stable" (the latest released major — may still receive minor/patch bugfixes), or "frozen" (older released majors — no new releases will be cut). Each major also carries `dataAvailable` indicating whether the DWC styling tools can answer questions about it. Call this FIRST when you do not know what version the user is on or which version to target — never guess.

Input parameters:

- `reasoning` (string, required): 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 st…

### `create_project` (~289 tokens)

webforJ Project Generator

Returns the Maven archetype command that scaffolds a new webforJ project, plus the follow-up commands to change into the generated directory and start the dev server. Relay the Maven command to the user via the host shell tool without modifying its arguments. Set showOptions=true to list available archetypes and the startforJ web generator instead of producing a command.

Input parameters:

- `appName` (string, required): webforJ application name
- `archetype` (string): Archetype template (default: hello-world)
- `archetypeVersion` (string): webforJ archetype version (default: LATEST)
- `artifactId` (string): Maven artifact ID (default: kebab-case of appName)
- `flavor` (string): Project flavor (default: webforj-spring)
- `groupId` (string): Maven group ID (default: com.<artifactId-without-hyphens>)
- `reasoning` (string, required): 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 st…
- `showOptions` (boolean): If true, list archetypes and startforJ info instead of generating. Default: false.
- `version` (string): Project version (default: 1.0-SNAPSHOT)

### `get_document` (~154 tokens)

webforJ Full Document Fetcher

Return the full content of an indexed webforJ documentation or sample file. Use this as a follow-up to search_knowledge_base when a search result excerpt is not enough and you need the complete page — migration guides, tutorials, long API docs. Pass the documentId from a search result.

Input parameters:

- `id` (string, required): Document id. Take this from the `documentId` field of a search_knowledge_base result. Stable, unique per document.
- `reasoning` (string, required): 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 st…

### `search_knowledge_base` (~480 tokens)

webforJ Knowledge Base Search

Search webforJ documentation, JavaDoc, and code samples for any class, method, annotation, or component, and for CSS styling concepts and rules (palette semantics, seed vs h/s, :not([theme]) pattern, dark mode, ::part limits, table styling). Returns matching snippets with titles, categories, and relevance scores. Call this before claiming any webforJ API exists. For exact --dwc-* custom property or ::part() names on a specific component, use styles_get_component instead; to verify tokens in generated CSS, use styles_validate_tokens. Pass category to narrow the search; if the category is unknown the tool errors with a ranked list of similar names plus the full set of valid categories, so you can retry. In a webforJ project the deliverable is Java (or the Kotlin DSL) using webforJ classes; search for the dedicated webforJ component before falling back to React, JSX, or hand-built HTML.

Input parameters:

- `categories` (array): 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"…
- `limit` (integer): Maximum number of search results to return (default: 25).
- `query` (string, required): Natural language query. Examples: "how to create buttons", "form validation", "data binding", "routing with @Route annotation".
- `reasoning` (string, required): 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 st…
- `type` (string): 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. Def…

### `styles_get_component` (~359 tokens)

webforJ Component Styling Lookup

Return the real CSS styling surface of a DWC web component: CSS custom properties, shadow parts, reflected attributes, and slots. Accepts a DWC tag ("dwc-button") or a webforJ Java class name ("Button", "TextField"). Use mode="list" for every valid tag, mode="map" for Java -> tag mappings. Call this before writing CSS for a component so you never guess a var or part name. Prefer a typed Java setter on the component over CSS when both can produce the same result.

Input parameters:

- `mode` (string): "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` (string): 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` (string, required): 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 st…
- `webforjVersion` (string, required): 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 unrel…

### `styles_list_tokens` (~470 tokens)

webforJ Global DWC Token Catalog

Return the authoritative list of global --dwc-* tokens (palette seeds, color shades, surfaces, spacing, typography, borders, etc.). Use this for any "which tokens are available for X" question — DO NOT ask the knowledge base to list tokens; it returns prose and the answer will be hallucinated. Filter with "prefix" (e.g. "--dwc-color-primary-") or "contains" (e.g. "seed") to narrow the result. For component-scoped CSS vars like --dwc-button-* use styles_get_component instead. The returned list is verbatim and complete for the filter you passed — do not add, rename, complete, or explain "implied" tokens, and do not reference tokens from other webforJ versions. If a token you expect is missing from the response, it does not exist for that version. Tokens that share a description are returned in a single entry where "names" is the list of every token that has that description; treat each name as a real, independently usable token. When writing CSS, use a token instead of hardcoding colors, spacing, or font sizes.

Input parameters:

- `contains` (string): Return only tokens that contain this substring anywhere. Useful for cross-palette queries like "seed" (all palette seeds) or "text" (all text-contrast shades).
- `prefix` (string): 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.
- `reasoning` (string, required): 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 st…
- `webforjVersion` (string, required): 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 unrel…

### `styles_validate_tokens` (~258 tokens)

webforJ DWC Token Validator

Validate every --dwc-* reference in CSS, Java, MDX, or Markdown text against the real DWC global tokens and component CSS variables. Returns the list of invalid tokens with line numbers and ranked similar-name suggestions. Run this on any generated or edited stylesheet before writing it to disk.

Input parameters:

- `content` (string, required): 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` (string, required): 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 st…
- `webforjVersion` (string, required): 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 unrel…

### `fqcn_validate` (~353 tokens)

webforJ FQCN Validator

Validate fully qualified class names against the catalog of types declared in webforJ source for the target version. Accepts either an explicit list of FQCNs or a Java snippet (the handler extracts its import statements). Returns unknown FQCNs with ranked similar-name suggestions. FQCNs outside the webforJ package family are not validated. Run this on any generated or edited Java before writing it to disk.

Input parameters:

- `content` (string): 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…
- `imports` (array): 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 `…
- `reasoning` (string, required): 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 st…
- `webforjVersion` (string, required): 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 unrel…

### `create_theme` (~425 tokens)

webforJ Theme Generator

Generate a webforJ theme from a primary HSL color. Returns two content blocks: a JSON summary with theme metadata, @AppTheme / @StyleSheet snippets, and recommended file paths, plus a second text block prefixed "CSS_CONTENT:" containing the full stylesheet.

Input parameters:

- `contrastSensitiveLightness` (boolean): Use contrast-sensitive lightness calculations (pre-25.12 only, default: false).
- `detectPrimaryColorCategory` (boolean): Auto-detect color category for optimization (pre-25.12 only, default: true).
- `infoDegree` (number): Degree offset for info/secondary color (pre-25.12 only, default: 180).
- `primaryColor` (array, required): Primary color in HSL format: [hue, saturation, lightness]. Example: [220, 70, 50] for blue.
- `reasoning` (string, required): 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 st…
- `step` (number): Step size for contrast calculations (pre-25.12 only, default: 5).
- `themeName` (string): Optional theme name for multi-theme applications. Omit for global CSS overrides.
- `tintBaseSaturation` (number): Base saturation for neutral grey tints (pre-25.12 only, default: 10).
- `tintScaleFactor` (number): Scale factor for tint generation (pre-25.12 only, default: 0).
- `webforjVersion` (string, required): 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 unrel…

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/com-webforj-mcp/mcp-2#diagnostics

## Score history

- 2026-08-03: 64
- 2026-08-02: 63
- 2026-08-01: 63
- 2026-07-31: 62
- 2026-07-30: 61
- 2026-07-29: 60
- 2026-07-28: 60
- 2026-07-27: 59
- 2026-07-26: 58

## Links

- Remote endpoint: https://mcp.webforj.com/sse
- Changelog RSS feed: https://verifymcp.io/servers/com-webforj-mcp/mcp-2/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/com-webforj-mcp/mcp-2/changelog.json
- HTML version of this page: https://verifymcp.io/servers/com-webforj-mcp/mcp-2