AI Integration

Nullstone integrates with AI coding agents (Claude Code, Claude Desktop, Cursor, and any other MCP-compatible client) across three surfaces:

Surface	Purpose	Install
MCP Server	Lets agents take action — list stacks, deploy apps, spin up envs, tail logs, discover modules.	Install MCP
Skills Catalog	Teaches agents the shape and style of Nullstone YAML — when to trigger, which top-level key, the canonical idioms.	Install skills
Editor Integration	JSON-schema-driven autocomplete and validation in VS Code, JetBrains, Neovim, and more.	Published to schemastore.org

Which do I need?

Pick based on what you want the agent to do:

"Run plans, deploys, and env operations against my org." → MCP Server. One install gives every CLI command as a tool.
"Edit .nullstone/*.yml correctly when I ask." → Skills Catalog + MCP Server. The skill codifies the style; the MCP gives the agent modules_find/modules_describe to resolve unknown modules.
"Get autocomplete when I edit the YAML." → Editor Integration — no AI involved.

Most teams install all three. The MCP and the skills catalog are complementary: the MCP acts, the skills codify conventions.

Install and configure the Nullstone CLI — follow Install/Configure the CLI. The MCP server shells out to nullstone, so this is a prerequisite.
Register the MCP server with your client. The server ships with the CLI as nullstone mcp-server — no separate install. See Install MCP for Claude Code, Claude Desktop, and Cursor configurations.
Install the skills catalog. In Claude Code, add the marketplace and install the plugin:
```
/plugin marketplace add nullstone-io/agent-skills
/plugin install nullstone-skills@nullstone
```
On other Agent Skills tools (Codex, Cursor, …), use the cross-tool installer instead: npx skills add nullstone-io/agent-skills. See Install skills for the manual/pinned option and upgrades.