Skip to main content

mobium mcp

Run as an MCP server on stdio

Serves the same tools the CLI uses, over the Model Context Protocol.

Register with an agent, for example: claude mcp add mobium -- mobium mcp

--read-only and --apps limit what the agent can do, and only the command line can lift them: a refused call is not_permitted. MOBIUM_READ_ONLY and MOBIUM_APPS in the environment do the same, and the two add up.

Usage​

mobium mcp [flags]

Flags​

FlagTypeDefaultWhat it does
--appsstringComma-separated app ids: the only apps a call may name or act on (an action on the screen needs one of them in front)
--mark-device-textboolAdd device_text to answers that carry the app's own words, naming those fields as data rather than instructions (also MOBIUM_MARK_DEVICE_TEXT=1)
--read-onlyboolAllow only calls that read: every call that acts is refused as not_permitted, and tools that only act are not listed

And the global flags.

Examples​

Register it with an agent​

claude mcp add mobium -- mobium mcp

What an agent left on screen after driving the Login Demo through mobium mcp — from the MCP guide

What an agent left on screen after driving the Login Demo through mobium mcp — from the MCP guide

More, from mobium mcp --help​

mobium mcp
mobium mcp --device emulator-5554
mobium mcp --read-only
mobium mcp --apps dev.mobium.shop