Molecule for AI agents

Set any coding agent up with molecule: the conventions command, the MCP server, and the package docs an agent reads.

Two ways to connect

A coding agent (Claude Code, Codex, Cursor, Gemini CLI, or the prompt-to-app builders Lovable and Bolt) can work with molecule two ways, and they compose: conventions and skills tell it how molecule code is written, and the MCP server gives it tools to search packages, scaffold, and operate projects. One command sets up both for every agent on your machine:

npx mlcl setup

It asks whether to set up every project on this machine or just this one, and which agents (the ones it finds are preselected), then writes each agent's own files: the MCP server registration, the Molecule skills (capability-first, build-with-molecule, extend-with-packages) and the conventions. Re-running it changes nothing; a file you edited is kept unless you pass --force, and --dry-run lists what it would write. The two commands below each do one part of it.

Write the conventions into your repo

agent init writes the molecule conventions and quickstart into the files your agent already reads in this project. One command, idempotent:

mlcl agent init
  • AGENTS.md at the project root, the cross-harness standard every major agent reads.
  • CLAUDE.md or GEMINI.md as well when the agent reads that file instead (a CLAUDE.md that already imports AGENTS.md is left alone).

After this, an agent that opens the project knows how to work with bonds, ClassMap styling, handler patterns, and migrations without any prompting.

Give it tools: the MCP server

Register the molecule MCP server with one agent (Claude Code, Codex, Cursor, Gemini CLI, Copilot, OpenCode, Devin/Windsurf, Kiro, Amp, Zed, Crush, Trae, Cline, Junie; any other MCP client takes npx -y molecule-mcp):

mlcl mcp install --agent <name>

The agent then gets the full surface: search, scaffold, wire, deploy, sandbox, database, env, and the capability services (74 tools; the MCP page has the table). A hosted, no-install endpoint is also available at https://mcp.molecule.dev/mcp with the read-only discovery tools.

What the agent reads

  • Per-package docs: every installed package carries a README.md generated from source at node_modules/@molecule/<name>/README.md.
  • llms-full.txt: every package’s API, examples, and wiring in one document.
  • molecule://conventions: an MCP resource with the conventions (bonds, ClassMap, i18n, migrations) in one page.