Optics
Let an AI agent drive Android, iOS, TV and web apps, and save the steps as test suites
- Pricing
- Open source
- Platforms
- Android, iOS, Web
- Runs
- Locally
- Version
- 1.11.0
- Listing updated
- 2 days ago
About Optics
Optics is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
Optics is an open-source test automation framework, and its MCP server gives an agent eyes and hands on a device. The agent starts a session, looks at the screen, taps and types, and every action returns what changed. When it finishes, the steps it ran can be read back as a ready CSV or YAML suite.
That suite is plain text that lives in your repository and runs later with optics execute, so a recording becomes an ordinary code-review change. The site gives an example where a moved sign-in button produces a one-locator diff with a text fallback beside it. When an element id stops matching, Optics falls back to finding the element by its text.
The server runs locally over stdio and is installed through uv and a Claude Code or Cursor plugin. Android and iOS need an Appium server with the matching driver, and web uses Playwright Chromium. The project is Apache 2.0 and needs Python 3.12 or newer.
Install
Run in a terminal
claude mcp add optics -- npx -y https://github.com/mozarkai/optics-agent-plugins/releases/download/mcpb-v1.11.0/optics-framework-1.11.0.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"optics": {
"command": "npx",
"args": [
"-y",
"https://github.com/mozarkai/optics-agent-plugins/releases/download/mcpb-v1.11.0/optics-framework-1.11.0.mcpb"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"optics": {
"command": "npx",
"args": [
"-y",
"https://github.com/mozarkai/optics-agent-plugins/releases/download/mcpb-v1.11.0/optics-framework-1.11.0.mcpb"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"optics": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/mozarkai/optics-agent-plugins/releases/download/mcpb-v1.11.0/optics-framework-1.11.0.mcpb"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"optics": {
"command": "npx",
"args": [
"-y",
"https://github.com/mozarkai/optics-agent-plugins/releases/download/mcpb-v1.11.0/optics-framework-1.11.0.mcpb"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"optics": {
"command": "npx",
"args": [
"-y",
"https://github.com/mozarkai/optics-agent-plugins/releases/download/mcpb-v1.11.0/optics-framework-1.11.0.mcpb"
]
}
}
}Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- start_session
- Opens a session on a device or browser, for example with the appium driver.
- tap
- Taps a target on screen and can assert that expected text is present afterwards.
What it does
- Agent-driven sessions
- The agent opens a session on a phone, TV or browser through ten tools.
- Suites as plain text
- Recorded steps are written as CSV or YAML you can review in a pull request.
- Text fallback locators
- When an id no longer matches, an element can be found by its visible text.
- Several platforms
- Targets Android, iOS, Android TV, Samsung Tizen, LG webOS and web.
- Live recording
- The optics live command records working steps and saves them as modules.
- Plugin install
- A Claude Code and Cursor plugin adds the server and a skill for the suite format.
Good for
- Have an agent explore a page and write a regression test
- Turn a manual checkout flow into a repeatable suite
- Run the same suite on every build in CI
- Review a locator change as a normal diff
- Test a smart TV app from an agent session
Pricing
Open source
Apache 2.0
Prices change. Check optics-framework.org before you buy.
Optics FAQ
What do I need installed?
uv on your PATH, Python 3.12 or newer, Appium with UiAutomator2 or XCUITest for mobile, and a Playwright Chromium build for web.
Why does the server show as failed on first start?
The first launch downloads the package and can take a minute or two, longer than Claude Code's 30 second limit; warm the cache once or raise MCP_TIMEOUT.
Which AI models can write tests?
The optics live AI mode works with Gemini, Claude, OpenAI or a local model.
What is the licence?
Apache 2.0.
Is Optics free?
Yes. Optics is open source, so you can use and self-host it for free.
How do I add Optics to Claude Code?
Run this command in your terminal: claude mcp add optics -- npx -y https://github.com/mozarkai/optics-agent-plugins/releases/download/mcpb-v1.11.0/optics-framework-1.11.0.mcpb
What are the best alternatives to Optics?
The closest alternatives to Optics are REA, Browser Use, Scrapling MCP Server, Codebase Memory and GitHub.
Alternatives to Optics

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Browser Use
MCP serverBrowser agents and cloud browsers for AI, with an MCP server for web tasks
- 7 tools
- Remote
- Freemium
- 121K GitHub stars
- Browser automation

Scrapling MCP Server
MCP serverMCP server for AI clients to scrape sites with HTTP and stealth browser sessions
Runs locally- 17 tools
- Open source
- 104K GitHub stars
- Web search and scraping

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools