MCP

PhysiClaw wraps the hardware into peek, tap, swipe, and other tools over MCP, so your own agent can call them directly.

Start the MCP server

bash

physiclaw mcp

Or hot-start with physiclaw mcp -H.

Connect your agent

Claude Code

bash

claude mcp add --transport http physiclaw http://127.0.0.1:8048/mcp

Codex

bash

codex mcp add physiclaw --url http://127.0.0.1:8048/mcp

Gemini CLI

bash

gemini mcp add --transport http physiclaw http://127.0.0.1:8048/mcp

OpenClaw

bash

openclaw mcp add physiclaw --url http://127.0.0.1:8048/mcp --transport streamable-http

Hermes

bash

hermes mcp add physiclaw --url http://127.0.0.1:8048/mcp

Use it

Once connected, hand your agent a task:

Open WhatsApp for me.

Mind the token cost

Every action returns a camera image of the phone screen, so tokens add up fast and long tasks can hit the context window sooner.