§ 01 — Install

Add robot-md to Gemini CLI.

Gemini CLI reads MCP servers from ~/.gemini/settings.json.

Step 1 — Install the CLI

$ pip install robot-md

Step 2 — Add MCP server to Gemini settings

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

This writes an entry to ~/.gemini/settings.json under mcpServers. You can also add it manually (see example below).

§ 02 — Example

Manual settings snippet.

// ~/.gemini/settings.json
{
  "mcpServers": {
    "robot-md": {
      "command": "npx",
      "args": ["-y", "robot-md-mcp", "/absolute/path/to/ROBOT.md"]
    }
  }
}

Launch gemini from your robot project directory. Ask "what can this robot do?" — Gemini reads capabilities, safety block, and prose body from the MCP server.

§ 03 — Capabilities

What works via Gemini CLI.

Feature Gemini CLI (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 commands → CLI only Run robot-md emit-fria from shell; not yet an MCP tool
using-robot-md skill — Not applicable Claude Code skill only; Gemini uses native MCP resources directly