Agents · Claude Code Primary surface

ROBOT.md + Claude Code

Your robot's AI cockpit. One MCP server wires the manifest into every Claude Code session — no config files, no axis conventions to learn.

§ 01 — Install

One command. No config files.

Wire the MCP server into Claude Code from your robot project root.

Step 1 — Install the CLI

$ pip install robot-md

Step 2 — Create your ROBOT.md

$ robot-md init my-robot --preset so-arm101

Step 3 — Wire the MCP server

$ claude mcp add robot-md -- npx -y robot-md-mcp ./ROBOT.md

Open Claude Code. Run /mcp to confirm robot-md is connected. Ask "what can this robot do?" — the using-robot-md skill reads capabilities from the MCP server and answers from your manifest, not training data.

§ 02 — Example

Pin the MCP server in .claude/settings.json.

Commit this file so every teammate who clones the repo gets the robot context automatically. 

// .claude/settings.json
{
  "mcpServers": {
    "robot-md": {
      "command": "npx",
      "args": ["-y", "robot-md-mcp", "./ROBOT.md"]
    }
  }
}

The MCP server walks up from the directory you launch Claude Code in, finds the first ROBOT.md, and serves it as four resources: frontmatter, capabilities, safety, body. No absolute paths, no environment variables.

§ 03 — CLI

robot-md CLI subcommands.

Command What it does
robot-md init Scaffold a ROBOT.md in the current directory. Accepts --preset so-arm101 and similar presets.
robot-md validate ROBOT.md Validate against JSON Schema + RCAN conformance rules. Exit codes 0-4.
robot-md register ROBOT.md Mint an RRN at Robot Registry Foundation. Requires --manufacturer and --contact-email.
robot-md install-skill Install the using-robot-md Claude Code skill into your project.
robot-md install-desktop Write the MCP server snippet to claude_desktop_config.json.
robot-md claude-md Generate a CLAUDE.md stub that instructs Claude to read the ROBOT.md first.
robot-md emit-fria Emit a FRIA attestation packet (RCAN §22). See Compliance →
§ 04 — Capabilities

What works natively vs. via bridge.

Feature Claude Code (MCP) Notes
Read capabilities / safety / frontmatter ✓ Native MCP resources served by robot-md-mcp
Validate ROBOT.md ✓ Native validate MCP tool
Render canonical YAML ✓ Native render MCP tool
Compliance filing (emit-fria etc.) ✓ Native Via robot-md CLI inside Claude Code session
RRN registration ✓ Native Via robot-md CLI
ChatGPT Custom GPT Actions → HTTP bridge Requires robot-md-http; see ChatGPT page →
§ 05 — Next steps

Where to go from here.

Read the MCP docs → ROBOT.md spec → Register your robot → Compliance filing →