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:

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

Related MCP server: knitbrain

Learn more

Full setup and usage guide: Syncing cloud code to local files with the brainCloud MCP helper

Develop

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

See RELEASING.md for the release process.