Skip to content

lusor-ai/lusor

v1.0.0MIT

Put AI agents to work on your own iPhone or Android phone. Run a task in plain language and get the result, answer the agent's questions, read the screen, tap, type and swipe, install free apps from the App Store or Google Play, and connect a new phone. Sign in with your Lusor account.

Lusor

Put AI agents to work on real phones. This plugin connects your agent to Lusor and your own iPhone or Android phone.

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

ToolWhat it does
list_phones, get_phoneSee your phones, whether each is online, and whether it is busy
connect_phoneShow the steps to connect your own iPhone or Android, and report when it is connected
run_task, get_task, list_tasksStart an AI agent on a phone with a prompt, follow it, and read the result
reply_to_task, stop_taskAnswer the agent's question, or stop a task
get_screenshot, get_screen_stateSee the screen and its elements
phone_actionTap, type, swipe, press a button or open an app
install_appInstall free apps from the App Store or Google Play on your phone

That is the whole set when you sign in. With an API key instead, the agent also gets tools for Lusor Phones in the cloud (add_phone, remove_phone, wipe_phone, and catalog installs with install_app and list_app_installs), and two advanced tools, search and execute, that reach any Lusor API operation.

Install

AppHow
CursorInstall Lusor from the Cursor Marketplace, or follow Cursor setup.
Grok BuildRun /plugin, search for Lusor and install.
Factory Droiddroid plugin marketplace add lusor-ai/plugins, then droid plugin install lusor@plugins.
Hermes Agenthermes plugins install lusor, then sign in (below).
PerplexityPlugins → 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 on https://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_task and install_app use credits. Installs are free apps only, and the agent stops and asks if a store wants a password, payment or verification. Hermes is set to ask before every tool that changes something.

Links

License

MIT