# io.github.GoatInAHat/toolfactory (oci · ghcr.io/goatinahat/toolfactory:0.3.1)

Build an agent tool once; ship it as Agent Skills, MCP servers, Agent Plugins / Claude / Codex

- Trust score: 38/100 (low)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-21

## Components

- npm · `toolfactory`: 49/100, [markdown](https://verifymcp.io/servers/goatinahat-toolfactory/toolfactory.md), [page](https://verifymcp.io/servers/goatinahat-toolfactory/toolfactory)
- oci · `ghcr.io/goatinahat/toolfactory:0.3.1`: 38/100 (this document), [markdown](https://verifymcp.io/servers/goatinahat-toolfactory/ghcr-io-goatinahat-toolfactory-0-3-1.md), [page](https://verifymcp.io/servers/goatinahat-toolfactory/ghcr-io-goatinahat-toolfactory-0-3-1)

## Channel facts

- Registry: `oci`
- Package: `ghcr.io/goatinahat/toolfactory:0.3.1`
- 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-09-21.

- **Supply Chain Security**: 0/100
  - Malware scan not yet available for this package.
  - Known CVEs could not be checked: this artifact ships no SBOM, so there is no dependency list to read. Publishing one would let us assess it.
  - Install-script risk not yet assessed.
  - Dependency health could not be checked: this artifact ships no SBOM, so there is no dependency list to read. Publishing one would let us assess it.
- **Provenance & Transparency**: 32/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - License check failed: no license is declared.
  - Actively maintained (last published 4 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 78/100
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 1485 tokens (~87/item across 17 items; 17 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 99/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 98% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 17 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 17 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 2 categories.** Categories scored 0 because we could not verify them: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### How do I install the io.github.GoatInAHat/toolfactory MCP server?

io.github.GoatInAHat/toolfactory runs locally as a container image, launched with docker run --rm -i ghcr.io/goatinahat/toolfactory:0.3.1. Ready-made configuration for Claude, Cursor, VS Code, Codex and 3 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add goatinahat-toolfactory -- docker run --rm -i ghcr.io/goatinahat/toolfactory:0.3.1
```

### Cursor

```json
{
  "mcpServers": {
    "goatinahat-toolfactory": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/goatinahat/toolfactory:0.3.1"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "goatinahat-toolfactory": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/goatinahat/toolfactory:0.3.1"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add goatinahat-toolfactory -- docker run --rm -i ghcr.io/goatinahat/toolfactory:0.3.1
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "goatinahat-toolfactory": {
      "type": "local",
      "command": [
        "docker",
        "run",
        "--rm",
        "-i",
        "ghcr.io/goatinahat/toolfactory:0.3.1"
      ],
      "enabled": true
    }
  }
}
```

### Hermes

```yaml
mcp_servers:
  goatinahat-toolfactory:
    command: "docker"
    args: ["run", "--rm", "-i", "ghcr.io/goatinahat/toolfactory:0.3.1"]
```

### Netclaw

```json
{
  "McpServers": {
    "goatinahat-toolfactory": {
      "Transport": "stdio",
      "Command": "docker",
      "Arguments": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/goatinahat/toolfactory:0.3.1"
      ]
    }
  }
}
```

### Other

```json
{
  "mcpServers": {
    "goatinahat-toolfactory": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/goatinahat/toolfactory:0.3.1"
      ]
    }
  }
}
```

## 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-09-17 (score 38)

First indexed and scored.

## MCP tools (17)

### `init` (~363 tokens)

Create a new tool: dev.toolfactory/tool.json, the authored identity file, the kernel scaffold for the chosen language, and the first build of every selected surface.

Input parameters:

- `author` (string): Author name
- `binding` (string, required): Language of the core logic: typescript or python
- `description` (string): One-line description
- `dryRun` (boolean): Print the gh invocations instead of running them
- `git` (boolean): git init when the directory is not a repository yet, and make the first commit
- `keywords` (array): Activation triggers for hosts that key off them (Kiro Powers, Agent Plugins); defaults to [name]
- `license` (string): SPDX license identifier
- `name` (string, required): Tool name: lowercase letters, digits, hyphens, dots (Agent Plugins rule)
- `public` (boolean): Create that repository public, not private
- `repo` (string): owner/name of a GitHub repository to create with gh and push to
- `repository` (string): Source repository URL (GitHub URL enables the MCP Registry name)
- `reviewers` (array): GitHub logins that must approve a live run, when the repository gets a live tier
- `root` (string): Project root (directory containing dev.toolfactory/)
- `runtime` (string): `none` creates an instruction-only skill/Codex plugin with no executable payload
- `setup` (boolean): Run .agents/setup: render the harness adapters, install the git hooks, install dependencies
- `surfaces` (array): Surfaces to generate. Default: the skills-first minimum — skill, agent-plugins, mcp, cli and the binding's package registry; every host-specific plugin is opt-in.

Output parameters:

- `agentConfig` (object)
- `nextSteps` (array)
- `repository` (object)
- `written` (array)

### `introspect` (~46 tokens)

Spawn the kernel MCP server, list its tools, and snapshot them to dev.toolfactory/ops.json.

Input parameters:

- `root` (string): Project root (directory containing dev.toolfactory/)

Output parameters:

- `changed` (boolean)
- `operations` (number)
- `path` (string)

### `build` (~43 tokens)

Generate every selected surface in-tree from the identity file and the operation snapshot, and refresh the lock.

Input parameters:

- `root` (string): Project root (directory containing dev.toolfactory/)

Output parameters:

- `deleted` (array)
- `manual` (array)
- `nudge` (string): One line when a surface that published somewhere was deselected since the last tag, pointing at `unpublish`.
- `stripped` (array): Region files whose generated regions were emptied because their surface is no longer selected; the authored remainder stays.
- `unchanged` (array)
- `written` (array)

### `check` (~43 tokens)

Fail if the operation snapshot or any generated file drifted from the code (the CI drift gate).

Input parameters:

- `root` (string): Project root (directory containing dev.toolfactory/)

Output parameters:

- `ok` (boolean)

### `validate` (~66 tokens)

Run each selected surface's own upstream validator (agentskills, claude plugin validate, MCP Inspector, openclaw, hermes, npm pack, uv build).

Input parameters:

- `root` (string): Project root (directory containing dev.toolfactory/)
- `surface` (string): Only this surface

Output parameters:

- `outcomes` (array)

### `coverage` (~43 tokens)

The operation × surface verdict matrix: native, bridged, degraded, or excluded, with reasons.

Input parameters:

- `root` (string): Project root (directory containing dev.toolfactory/)

Output parameters:

- `rows` (array)
- `surfaces` (array)

### `review-prompt` (~99 tokens)

Evaluate a prompt draft against the codex-prompt-standard rubric: anatomy sections, convention checks, and concrete directives. Draft, run this, fix what it flags, and re-run until it passes.

Input parameters:

- `prompt` (string, required): The prompt draft to evaluate
- `reference` (string): The closest reference prompt's full text, fetched per the standard (an OpenAI Codex core prompt); sections it has that the draft lacks become the bar

Output parameters:

- `checks` (array)
- `directives` (array)
- `reference` (object)
- `sections` (object)
- `verdict` (string)

### `adopt` (~56 tokens)

Stop regenerating one file; it becomes the author's (recorded as manual in the lock).

Input parameters:

- `path` (string, required): Repo-relative path of a generated file
- `root` (string): Project root (directory containing dev.toolfactory/)

Output parameters:

- `adopted` (string)

### `unadopt` (~50 tokens)

Return an adopted file to toolfactory and regenerate it.

Input parameters:

- `path` (string, required): Repo-relative path of an adopted file
- `root` (string): Project root (directory containing dev.toolfactory/)

Output parameters:

- `regenerated` (string)

### `eject` (~45 tokens)

Adopt every file a surface owns, so the author takes it over entirely.

Input parameters:

- `root` (string): Project root (directory containing dev.toolfactory/)
- `surface` (string, required)

Output parameters:

- `adopted` (array)

### `bootstrap-repo` (~125 tokens)

Prepare the GitHub repository from the local .env: the `live-tests` environment with its required reviewers and the sensitive config keys inside it, the release registries' tokens at repository scope, GitHub Pages with source = Actions, and npm's trusted publisher. Values go to `gh` on stdin and are never returned.

Input parameters:

- `dryRun` (boolean): Print the gh invocations instead of running them
- `reviewers` (array): GitHub logins that must approve a live run
- `root` (string): Project root (directory containing dev.toolfactory/)

Output parameters:

- `commands` (array)
- `dryRun` (boolean)
- `environment` (string)
- `manual` (array): The one-time human steps no API can do
- `missing` (array): Declared names the local .env has no value for
- `repository` (string)
- `reviewers` (array)
- `secrets` (array): Names written, never values

### `secrets-usage` (~109 tokens)

Every credential this project's surfaces need — the tool's own sensitive config keys and the release registries' tokens — with where each one is set, whether it is present locally and on GitHub, and (check) whether the registry accepts it. Never a value.

Input parameters:

- `action` (string): status: the inventory. check: run each registry's own credential probe.
- `key` (string): Only this secret
- `root` (string): Project root (directory containing dev.toolfactory/)

Output parameters:

- `manual` (array)
- `secrets` (array)

### `unpublish` (~155 tokens)

Retract what a deselected surface used to publish. Git is the ledger: the previous tag's dev.toolfactory/tool.json says what was selected then, and every registry row that lost its surface is checked for the version that tag published and then retracted with the registry's own CLI — or reported with the exact page, where there is no API.

Input parameters:

- `dryRun` (boolean): List the retractions instead of running them
- `hard` (boolean): Use the destructive retraction where one exists (npm unpublish --force)
- `ref` (string): Diff against the tag before this ref (the release passes the tag being cut)
- `root` (string): Project root (directory containing dev.toolfactory/)

Output parameters:

- `dropped` (array)
- `from` (string)
- `ran` (array)
- `steps` (array)

### `gate` (~80 tokens)

Run the gate here, in order: build, the drift check, every selected surface's upstream validator, the author's checks and tests, and the credential-free host end-to-end. The same step list the generated ci.yml renders, so a project with no CI has the identical gate.

Input parameters:

- `root` (string): Project root (directory containing dev.toolfactory/)

Output parameters:

- `steps` (array)

### `package` (~74 tokens)

Build every release asset into dist/release/ — npm tarball, Python distributions, OpenClaw plugin tarball, plugin bundle zip, web build, coverage — by the same steps the release workflow's package job runs. Publishing stays a CI concern.

Input parameters:

- `root` (string): Project root (directory containing dev.toolfactory/)

Output parameters:

- `steps` (array)

### `doctor` (~50 tokens)

Report which upstream CLIs this machine can delegate to (git, gh, npm, uv, claude, openclaw, clawhub, hermes, uvx, agentskills, MCP Inspector, docker).

Output parameters:

- `node` (string)
- `toolfactory` (string)
- `tools` (object)

### `web` (~38 tokens)

Open this tool's web app: serves the operations page and the MCP endpoint on a free local port, opens a browser there, and returns the URL.

Output parameters:

- `url` (string)

## Diagnostics

Captured diagnostic sections: Provenance. The full working is on the page: https://verifymcp.io/servers/goatinahat-toolfactory/ghcr-io-goatinahat-toolfactory-0-3-1#diagnostics

## Score history

- 2026-09-21: 38
- 2026-09-20: 38
- 2026-09-19: 38
- 2026-09-18: 38
- 2026-09-17: 38

## Common questions

### What is the io.github.GoatInAHat/toolfactory MCP server?

io.github.GoatInAHat/toolfactory is an MCP server listed in the public MCP registry as io.github.GoatInAHat/toolfactory. Build an agent tool once; ship it as Agent Skills, MCP servers, Agent Plugins / Claude / Codex. This page covers its container image (ghcr.io/goatinahat/toolfactory:0.3.1).

### Is the io.github.GoatInAHat/toolfactory MCP server safe to use?

io.github.GoatInAHat/toolfactory scores 38 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the io.github.GoatInAHat/toolfactory MCP server expose?

io.github.GoatInAHat/toolfactory exposes 17 tools: init, introspect, build, check, validate, and 12 more. Their descriptions and schemas cost roughly 1,485 tokens of context every time the server is loaded.

### Is the io.github.GoatInAHat/toolfactory MCP server still maintained?

io.github.GoatInAHat/toolfactory is still listed as active in the MCP registry. We last reached this channel on 21 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Repository: https://github.com/GoatInAHat/toolfactory
- Changelog RSS feed: https://verifymcp.io/servers/goatinahat-toolfactory/ghcr-io-goatinahat-toolfactory-0-3-1.xml
- Changelog JSON feed: https://verifymcp.io/servers/goatinahat-toolfactory/ghcr-io-goatinahat-toolfactory-0-3-1.json
- HTML version of this page: https://verifymcp.io/servers/goatinahat-toolfactory/ghcr-io-goatinahat-toolfactory-0-3-1