# mothermachine skill

Search [mothermachine.ai](https://mothermachine.ai), a directory of software an agent can adapt or operate, from a coding agent or an MCP client. This repository is generated from the private source repository on every change to the skill; do not edit it here. Issues and candidate listings go to the site: https://mothermachine.ai/agents.html

## Run it

With Node 18 or later, nothing to install:

```sh
npx mothermachine "invoicing for a freelancer"
```

## Install the skill

With the skills CLI, into every agent it knows about:

```sh
npx skills add Ramp-Jet/mothermachine-skill
```

Or straight from the site, with no CLI, into Claude Code's skills folder:

```sh
for f in SKILL.md scripts/search.mjs scripts/mcp.mjs; do curl -fsSL --create-dirs -o ~/.claude/skills/mothermachine/$f https://mothermachine.ai/skills/mothermachine/$f; done
```

Then `/mothermachine <what you need>` searches the directory from the chat.

## MCP server

`scripts/mcp.mjs` is the same search as an MCP server over stdio, with three read-only tools: search, listing, vocab. No dependencies; Node 18 or later.

```sh
claude mcp add mothermachine -- npx -y mothermachine mcp
```

The [official MCP Registry](https://registry.modelcontextprotocol.io/) lists it as `io.github.Ramp-Jet/mothermachine`.

If you installed the skill, the server is already on disk:

```sh
claude mcp add mothermachine -- node ~/.claude/skills/mothermachine/scripts/mcp.mjs
```

## What it fetches

The skill and the MCP server read the search index and other public JSON files from https://mothermachine.ai. The search runs on your machine, so your search words are not sent. Those requests reach the site's host like any page visit, which the [privacy page](https://mothermachine.ai/privacy.html) covers. Neither one writes files or sends telemetry. They run only the scripts in this repository, with Node 18 or later.

## What is here

- `SKILL.md`: the skill, read by the agent.
- `scripts/search.mjs`: the search over the site's `index/search.json`, also a command line.
- `scripts/mcp.mjs`: the MCP server over the same search.
- `scripts/cli.mjs` and `package.json`: the `mothermachine` command on npm, which runs the two scripts above.
- `scripts/*.test.mjs`: tests, run with `node --test`.
- `.claude-plugin/plugin.json` and `.mcp.json`: the Claude plugin, which is this whole folder.
- `server.json`: the listing on the MCP Registry.
- `.github/workflows/`: `release.yml` publishes a new version to npm, and `mcp-registry.yml` lists it on the MCP Registry.
- `LICENSE`: MIT, the same as the source repository.

Everything reads the live site, so an installed copy never goes stale on data; reinstall to pick up changes to the scripts.