Lusor
Put AI agents to work on real phones. This plugin connects your agent to Lusor: your own iPhone or Android phone, or a Lusor Phone in the cloud.
Ask in plain language, for example "List my Lusor phones" or "On my phone, open Settings and turn on dark mode, then tell me what changed."
What your agent can do
| Tool | What it does |
|---|---|
list_phones, get_phone | See your phones, whether each is online, and whether it is busy |
run_task, get_task, list_tasks | Start an AI agent on a phone with a prompt, follow it, and read the result |
reply_to_task, stop_task | Answer the agent's question, or stop a task |
get_screenshot, get_screen_state | See the screen and its elements |
phone_action | Tap, type, swipe, press a button or open an app |
install_app, list_app_installs | Install apps from the Lusor app catalog on a Lusor Phone |
remove_phone, wipe_phone | Remove or wipe a Lusor Phone |
With an API key instead of sign-in, the agent also gets add_phone, which buys Lusor Phones after you confirm a price quote, and two advanced tools, search and execute, that reach any Lusor API operation.
Install
| App | How |
|---|---|
| Cursor | Install Lusor from the Cursor Marketplace, or follow Cursor setup. |
| Grok Build | Run /plugin, search for Lusor and install. |
| Factory Droid | droid plugin marketplace add lusor-ai/plugins, then droid plugin install lusor@plugins. |
| Hermes Agent | hermes plugins install lusor, then sign in (below). |
| Perplexity | Plugins → Add custom → Upload plugin or skill, and import https://github.com/lusor-ai/plugins/tree/main/plugins/lusor. |
Every other app that supports remote MCP servers can add https://mcp.lusor.ai/mcp directly. See Connect an AI app.
Sign in
The first time the app connects, it opens the Lusor sign-in in your browser. Sign in and choose your organization. The app never sees a password or key.
In Hermes, start the sign-in once with:
hermes mcp add lusor --url https://mcp.lusor.ai/mcp --auth oauth
That adds a config.yaml entry, which replaces the plugin's entry. Add trust: untrusted to it to keep Hermes asking before each tool that changes something.
No account yet? Sign up at app.lusor.ai.
API key instead
Apps that let you set request headers can send Authorization: Bearer lusor_... with a key from your workspace's API keys page in the Lusor app. See Authentication.
Network and data
- The plugin contains configuration only: no code, scripts or hooks.
- It connects to one endpoint,
https://mcp.lusor.ai/mcp(Streamable HTTP, OAuth 2.1 with dynamic client registration and PKCE). Sign-in runs onhttps://mcp.lusor.ai. - Every tool call runs as the signed-in user, in their workspace. Tool results, including screenshots and screen text, enter your session and so reach your model provider.
- Costs and changes.
run_taskuses credits, and phone minutes on a Lusor Phone. With an API key,add_phonebuys Lusor Phones on the workspace's plan: it returns a price quote first and buys only on a second, confirmed call.wipe_phoneerases a Lusor Phone and asks you to confirm by typing its name.remove_phoneremoves one. Hermes is set to ask before every tool that changes something.
Links
License
README from the reviewed commit 7cdc00c; it updates when the author re-pins.

Lusor