# ForgeCraft (npm · forgecraft-mcp)

Production engineering standards for AI coding assistants. Setup once, remove when done.

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

## Components

- npm · `forgecraft-mcp`: 59/100 (this document), [markdown](https://verifymcp.io/servers/jghiringhelli-forgecraft/forgecraft-mcp.md), [page](https://verifymcp.io/servers/jghiringhelli-forgecraft/forgecraft-mcp)

## Channel facts

- Registry: `npm`
- Package: `forgecraft-mcp`
- Version: `1.0.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, 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.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (97 of 101), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (97 of 101), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 52 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 23/100
  - AI-judged instruction clarity (fair).
  - Context-footprint check failed: tool/resource definitions use about 2583 tokens (~1291/item across 2 items; 2 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 jghiringhelli-forgecraft -- npx -y forgecraft-mcp
```

### Codex

```bash
codex mcp add jghiringhelli-forgecraft -- npx -y forgecraft-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "jghiringhelli-forgecraft": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "forgecraft-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add jghiringhelli-forgecraft --command npx --arg -y --arg forgecraft-mcp
```

### Hermes

```yaml
mcp_servers:
  jghiringhelli-forgecraft:
    command: "npx"
    args: ["-y", "forgecraft-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "jghiringhelli-forgecraft": {
      "command": "npx",
      "args": [
        "-y",
        "forgecraft-mcp"
      ]
    }
  }
}
```

## 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 59, +39)

- [security regression] Provenance: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [functional regression] Security disclosure: unverified → fail
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] License: unverified → pass
- [functional improvement] Schema quality: unverified → fair
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] Stability: unverified → 0.27
- [functional improvement] MCP protocol: unverified → pass
- [functional] Licence: MIT

### 2026-08-02 (score 20, +4)

- [security improvement] Malware scan: unverified → pass
- [functional regression] Security disclosure: fail → unverified
- [functional regression] Tool coverage: 100 → unverified

### 2026-07-31 (score 16, −24)

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

### 2026-07-30 (score 40, +16)

- [functional improvement] Tool coverage: unverified → 100

### 2026-07-28 (score 24, −16)

- [functional regression] Tool coverage: 100 → unverified
- [functional] First check of Schema quality: unverified

### 2026-07-27 (score 40)

First indexed and scored.

## MCP tools (2)

### `forgecraft` (~45 tokens)

Setup-time tool for engineering standards. Diagnoses project state. Remove this MCP server after setup is complete to save tokens.

Input parameters:

- `project_dir` (string, required): Absolute path to project root.

### `forgecraft_actions` (~2538 tokens)

Full ForgeCraft action suite. Use action='setup_project' to onboard, 'check_cascade' to verify GS steps, 'generate_session_prompt' for a bound prompt, 'audit' for compliance score. Remove after setup to save tokens.

Input parameters:

- `acceptance_criteria` (array): Checkable acceptance criteria. Used by: generate_session_prompt. If omitted, defaults are generated.
- `action` (string, required): Operation to perform. Available actions:   setup_project       — onboard a new or existing project (two-phase: analyze then calibrate)   scaffold            — generate project structure files (.clau…
- `add_tags` (array): Tags to add during refresh.
- `adr_alternatives` (array): List of alternatives considered and why each was rejected. Used by: generate_adr.
- `adr_consequences` (string): Positive and negative consequences of the decision — what becomes easier, harder, or constrained. Used by: generate_adr.
- `adr_context` (string): The situation that forced this decision — constraints, requirements, forces at play. Used by: generate_adr.
- `adr_decision` (string): What was decided and why this option was chosen over alternatives. Used by: generate_adr.
- `adr_title` (string): Short imperative title of the architectural decision (e.g. 'Use PostgreSQL for primary storage'). Used by: generate_adr.
- `apply` (boolean): Apply changes (vs preview). Used by: refresh. Default: false.
- `auto_approve_tools` (boolean): Auto-approve MCP tool calls. Used by: configure_mcp. Default: true.
- `cascade_decided_by` (string): Who made this cascade decision. Used by: set_cascade_requirement. Defaults to 'assistant'.
- `cascade_rationale` (string): Why was this cascade decision made? Required for: set_cascade_requirement.
- `cascade_required` (boolean): Whether the cascade step must pass before implementation begins. Used by: set_cascade_requirement.
- `cascade_step` (string): Which cascade step to configure. Used by: set_cascade_requirement.
- `cnt_concern` (string): Concern name within a CNT domain. Lowercase kebab-case. E.g. 'routing', 'auth'. Used by: cnt_add_node.
- `cnt_content` (string): Markdown content for a CNT leaf node (≤30 lines). If omitted, a placeholder is generated. Used by: cnt_add_node.
- `cnt_domain` (string): Domain prefix for a CNT leaf node. Lowercase kebab-case. E.g. 'tools', 'shared'. Used by: cnt_add_node.
- `compact` (boolean): Strip explanatory tail clauses and deduplicate bullet lines (~20-40% smaller output). Used by: generate, scaffold, refresh.
- `coverage_dir` (string): Path to existing coverage report directory. Used by: metrics. Defaults to coverage/ relative to project_dir.
- `custom_servers` (object): Custom MCP servers. Used by: configure_mcp.
- `deployment_url` (string): Override deployment URL for smoke test. Used by: start_hardening. Default: read from forgecraft.yaml or 'http://localhost:3000'.
- `description` (string): Natural language description. Used by: classify.
- `dry_run` (boolean): Preview without writing files. Used by: scaffold.
- `force` (boolean): Overwrite existing files. Used by: scaffold.
- `has_consumers` (boolean): Phase 2 answer: true = existing users or downstream consumers (behavioral contracts required), false = no consumers yet. Used by: setup_project (phase 2).
- `include_anti_patterns` (boolean): Scan for anti-patterns. Used by: audit. Default: true.
- `include_mutation` (boolean): Run Stryker mutation testing (slow, opt-in). Used by: metrics. Default: false.
- `include_remote` (boolean): Query remote MCP registry. Used by: configure_mcp. Default: false.
- `item_description` (string): Roadmap item description for this session. Used by: generate_session_prompt. Should include actor, behavior, and postcondition.
- `language` (string): Programming language. Used by: scaffold, add_module. Default: typescript.
- `max_servers` (integer): Max MCP servers to configure. Used by: configure_mcp.
- `merge` (boolean): Merge with existing instruction files. Used by: generate. Default: true.
- `mvp` (boolean): Phase 2 answer: true = MVP stage (minimal ceremony, expect changes), false = production (full quality gates). Used by: setup_project (phase 2 — provide together with scope_complete and has_consumers).
- `name` (string): Item name. Used by: add_hook (hook name), add_module (module name).
- `notes` (string): Evidence or justification for a verification decision. Used by: record_verification.
- `output_targets` (array): AI assistant targets (claude, cursor, copilot, windsurf, cline, aider). Used by: scaffold, generate, refresh.
- `pass_threshold` (integer): Minimum §4.3 GS score (0–14, 7 properties × 2) required for overall pass. Used by: verify. Default: 11.
- `phase_id` (string): Verification phase ID containing the step (e.g., 'contract-definition'). Used by: record_verification.
- `project_dir` (string): Absolute path to the project root. Required for: setup_project, refresh, scaffold, generate, audit, add_hook, add_module, configure_mcp, convert, verify, metrics, record_verification, verification_st…
- `project_name` (string): Human-readable project name. Used by: scaffold, generate.
- `project_type_override` (string): Phase 2: override the inferred project type when ambiguities were reported in phase 1. Examples: "docs", "cli", "api", "library", "cli+library", "cli+api". Provide this when the AI detected conflicti…
- `recorded_by` (string): Who recorded this decision (e.g., 'claude-sonnet-4-5', 'human', CI name). Used by: record_verification. Defaults to 'unknown'.
- `release_phase` (string): Current release cycle phase. Controls which test gates are shown as required vs. advisory. Used by: setup, generate, refresh. Default: development.
- `remote_registry_url` (string): Remote MCP registry URL override. Used by: configure_mcp.
- `remove_tags` (array): Tags to remove during refresh.
- `resource` (string): Sub-resource for list (tags|hooks|skills) and get_reference (nfr|design_patterns|playbook|guidance). Use 'guidance' to retrieve GS session-loop, context-loading, incremental-cascade, bound-roadmap, a…
- `scan_depth` (string): Analysis depth. Used by: convert. Default: quick.
- `scope` (string): Review scope. Used by: review. Default: comprehensive.
- `scope_complete` (boolean): Phase 2 answer: true = scope is finalized (proceed with full cascade), false = scope still evolving (lighter cascade). Used by: setup_project (phase 2).
- `scope_note` (string): Explicit out-of-scope statement — what this session must NOT touch. Used by: generate_session_prompt.
- `sentinel` (boolean): Generate sentinel CLAUDE.md (~50 lines) + .claude/standards/ domain files instead of one large file. Default: true. Set to false for traditional monolithic CLAUDE.md. Used by: scaffold, refresh.
- `session_type` (string): Conventional commit type for session output. Used by: generate_session_prompt. Default: feature.
- `show_pending_only` (boolean): Show only pending/failed steps. Used by: verification_status. Default: false.
- `skip_load_test` (boolean): Skip load test phase (HARDEN-003). Used by: start_hardening. Default: true (skip when no load gates defined).
- `spec_path` (string): Path to an existing spec file (markdown, txt, OpenAPI). Used by: setup_project (phase 1).
- `spec_text` (string): Paste spec text directly (markdown prose, OpenAPI description, etc.). Used by: setup_project (phase 1).
- `step_id` (string): Verification step ID to record an acceptance decision for (e.g., 'write-hurl-spec'). Used by: record_verification.
- `step_status` (string): Acceptance decision for the verification step: pass | fail | skipped. Used by: record_verification.
- `strategy_tag` (string): Tag whose verification strategy the step belongs to (e.g., 'API', 'GAME'). Used by: record_verification.
- `tag` (string): Single tag filter. Used by: add_hook.
- `tags` (array): Project classification tags. Used by: scaffold, generate, audit, review, add_module, configure_mcp, get_reference (not needed for resource=guidance), convert, list (as filter).
- `test_command` (string): Test command override. Used by: verify. Default: npm test.
- `tier` (string): Content depth: core, recommended, optional. Used by: refresh.
- `timeout_ms` (integer): Test suite timeout in ms. Used by: verify. Default: 120000.
- `uncertainty_level` (string): Filter verification strategies by uncertainty level. Used by: get_verification_strategy.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/jghiringhelli-forgecraft/forgecraft-mcp#diagnostics

## Score history

- 2026-08-03: 59
- 2026-08-02: 20
- 2026-08-01: 16
- 2026-07-31: 16
- 2026-07-30: 40
- 2026-07-28: 24
- 2026-07-27: 40

## Links

- npm package: https://www.npmjs.com/package/forgecraft-mcp
- Socket report: https://socket.dev/npm/package/forgecraft-mcp
- Repository: https://github.com/jghiringhelli/forgecraft-mcp
- Changelog RSS feed: https://verifymcp.io/servers/jghiringhelli-forgecraft/forgecraft-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/jghiringhelli-forgecraft/forgecraft-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/jghiringhelli-forgecraft/forgecraft-mcp