# masscode-mcp

An MCP (Model Context Protocol) stdio server for [massCode](https://masscode.io),
the open-source snippet manager. It exposes your massCode library to any MCP client
(Claude Code, Claude Desktop, etc.) so an AI assistant can list, read, create and
update your snippets, folders and tags.

massCode runs a local HTTP API; this server talks to it on `localhost` and speaks
MCP over stdio.

## Requirements

- [massCode](https://masscode.io) running, with its local API/DB server enabled
- Node.js 18+

## Install

```bash
npm install
```

## Configure

Two environment variables (both optional):

| Variable | Default | Purpose |
|---|---|---|
| `MASSCODE_PORT` | `4321` | Port massCode's local API is listening on |
| `MASSCODE_API_KEY` | *(none)* | Bearer token, if your massCode build requires one |

## Use with an MCP client

Register it as a stdio server, e.g. in Claude Code:

```json
{
  "mcpServers": {
    "masscode": {
      "command": "node",
      "args": ["path/to/masscode-mcp/index.js"],
      "env": { "MASSCODE_PORT": "4321" }
    }
  }
}
```

## Tools

- `masscode_list_folders`, `masscode_list_tags`
- `masscode_list_snippets`, `masscode_get_snippet`
- `masscode_create_folder`, `masscode_create_tag`
- `masscode_create_snippet`, `masscode_update_snippet`

## License

MIT — see [LICENSE](LICENSE).