MCP Configuration

Krometrail exposes all its capabilities as MCP tools. Once configured, agents discover debug_*, chrome_*, and session_* tools automatically — no prompting required.

Claude Code

Add to .mcp.json in your project root (shared with your team), or use the CLI:

claude mcp add --transport stdio --scope project krometrail -- npx krometrail mcp

bunx

{
	"mcpServers": {
		"krometrail": {
			"command": "bunx",
			"args": ["krometrail", "--mcp"]
		}
	}
}

npx

{
	"mcpServers": {
		"krometrail": {
			"command": "npx",
			"args": ["krometrail", "mcp"]
		}
	}
}

binary

{
	"mcpServers": {
		"krometrail": {
			"command": "/path/to/krometrail",
			"args": ["mcp"]
		}
	}
}

Claude discovers the debug_* tools automatically. No CLAUDE.md changes needed.

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json in your project root:

{
	"mcpServers": {
		"krometrail": {
			"command": "npx",
			"args": ["krometrail", "mcp"]
		}
	}
}

Restart Cursor after saving. The debug_* tools will appear in the AI's tool list.

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json or click the MCPs icon in Cascade and select "Configure":

{
	"mcpServers": {
		"krometrail": {
			"command": "npx",
			"args": ["krometrail", "mcp"],
			"env": {}
		}
	}
}

OpenAI Codex

Add to ~/.codex/config.toml (global) or .codex/config.toml in your project:

[mcp_servers.krometrail]
command = "npx"
args = ["krometrail", "mcp"]

Or add via the CLI:

codex mcp add krometrail -- npx krometrail mcp

Codex also supports the CLI path — install the krometrail skill:

npx skills add nklisch/krometrail --skill krometrail-debug krometrail-chrome

Tool Filtering with --mcp

Use the --mcp flag to expose only specific tool groups, reducing the agent's tool list:

{
	"mcpServers": {
		"krometrail-debug": {
			"command": "bunx",
			"args": ["krometrail", "--mcp", "--tools", "debug"]
		},
		"krometrail-browser": {
			"command": "bunx",
			"args": ["krometrail", "--mcp", "--tools", "browser"]
		}
	}
}

Available tool groups: debug, browser, session, all (default).

Verification

Ask your agent: "What debug tools do you have available?" It should list debug_launch, debug_continue, debug_evaluate, and other tools.

Run krometrail doctor in a terminal to confirm which language adapters are installed.