# brainCloud MCP Helper [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/getbraincloud/braincloud-mcp-helper  
**GitHub Stars:** 1  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/braincloud-mcp-helper

## Description
Helper for brainCloud MCP that gives it local file access, enabling easy git sync of cloud code.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "braincloud-mcp-helper": {
    "command": "npx",
    "args": ["-y","@braincloud/mcp-helper@latest"]
  }
}
```

## Documentation & README

# braincloud-mcp-helper

A local, trustless MCP server that lets AI coding assistants (Claude Code, Cursor, Codex, …) sync
brainCloud cloud-code scripts to and from your filesystem and git repo.

It never authenticates to brainCloud on its own and stores no credentials. Every Builder API call
is driven by a short-lived, app-scoped **ticket** that the AI obtains from the hosted
`braincloud-mcp`'s `getSyncTicket` tool and passes in — script content flows helper → Builder API
directly, never through the AI's context.

## Packages

This is an npm workspace with two packages:

| Package | What it is |
|---|---|
| [`@braincloud/mcp-helper`](packages/mcp-helper) | The MCP server itself — `status` / `pull` / `push` / `sync` tools, installable via `npx -y @braincloud/mcp-helper@latest`. |
| [`@braincloud/cloudsync-core`](packages/cloudsync-core) | Host-agnostic sync/format logic (the `.ccjs` / `.bcsync` / `.bcsync.local` on-disk contract) shared with the VS Code extension. |

See each package's README for tool details, configuration, and the on-disk format.

## Learn more

Full setup and usage guide: [Syncing cloud code to local files with the brainCloud MCP helper](https://help.getbraincloud.com/en/articles/15695153-syncing-cloud-code-to-local-files-with-the-braincloud-mcp-helper)

## Develop

```bash
npm install
npm run build   # builds all workspaces
npm test        # tests all workspaces
```

See [RELEASING.md](RELEASING.md) for the release process.