@viyv/claw-mcp

MCP stdio adapter for viyv-claw Gateway.

Connects Claude Code (or any MCP client) to a running viyv-claw Gateway via HTTP. No Redis, no agent process, no local YAML required — just point it at a Gateway URL.

Install

npm install -g @viyv/claw-mcp
# or use on-demand:
npx @viyv/claw-mcp --url http://localhost:8080

Usage

Claude Code .mcp.json

{
	"mcpServers": {
		"claw": {
			"command": "npx",
			"args": ["-y", "@viyv/claw-mcp", "--url", "http://localhost:8080"]
		}
	}
}

CLI flags

| Flag | Default | Description | |------|---------|-------------| | --url | http://localhost:8080 | Gateway base URL | | --auth-header | none | Authorization header (e.g. Bearer token123) |

Environment variables

| Variable | Description | |----------|-------------| | CLAW_GATEWAY_URL | Gateway base URL (overrides --url) | | CLAW_AUTH_HEADER | Authorization header value |

Requirements

• Node.js 20+
• A running viyv-claw Gateway (see main repo)

Tools exposed

• claw/submit_task, claw/task_status, claw/task_result, claw/list_tasks, claw/cancel_task
• claw/submit_workflow, claw/workflow_status, claw/list_workflows, claw/pause_workflow, claw/resume_workflow, claw/delete_workflow, claw/retry_workflow
• claw/list_agents, claw/health, claw/clearance_levels, claw/status, claw/info
• claw/approve, claw/answer, claw/list_pending
• Dev tools: claw/init_project, claw/create_team, claw/create_agent, claw/create_workflow, claw/validate, claw/start_gateway, claw/start_team, claw/list_processes, etc.

License

MIT