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.

Guardrails for agents

An agent that can edit .nullstone/ files and run the CLI can also push those edits straight to an environment with nullstone iac sync, skipping code review. Turn on Disable manual IaC sync for production (Environment > Settings > Governance) so IaC changes only arrive through the repository's webhooks or your CI pipeline, and read the MCP safety model for API-key scoping and client-side confirmation.

Quick start

1. Install and configure the Nullstone CLI — follow Install/Configure the CLI. The MCP server shells out to nullstone, so this is a prerequisite.

2. 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.

3. 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.

What's next

• MCP Server overview — architecture, tool naming, safety model.
• Skills catalog overview — what a skill is, how it differs from an MCP tool.
• nullstone-config-files — the first skill in the catalog.