Skip to main content

MCP server

Argent is an MCP server for mobile, TV and desktop apps. The Model Context Protocol (MCP) is the standard that coding agents use to call external tools. The Argent MCP server gives the agent tools to:

  • boot simulators, emulators and devices,
  • tap the screen and type text,
  • read the UI tree,
  • capture screenshots,
  • inspect network traffic,
  • profile the app.

The Argent MCP server works with Claude Code, Cursor, VS Code, Windsurf, Zed, Gemini CLI, Codex CLI, opencode and other MCP clients. See Supported editors for the full list.

Register the MCP server​

Run the installation wizard from the root of your project:

npx @swmansion/argent@latest init

The wizard detects your editor and writes the MCP server entry to the editor config. See Installation for the prerequisites and the team setup.

Add the MCP server by hand​

Install the package and add the server to the MCP config of your editor:

npm install -g @swmansion/argent
{
  "mcpServers": {
    "argent": {
      "command": "argent",
      "args": ["mcp"]
    }
  }
}

The key of the top-level object depends on the editor. Claude Code, Cursor and Windsurf use mcpServers. VS Code uses servers. See Supported editors for the config file of each editor.

How the MCP server works​

The editor starts argent mcp as a child process and talks to it over standard input and output. The MCP server does not control the devices itself. The MCP server forwards each tool call to the Argent tool-server. The tool-server owns the simulators, emulators and device sessions.

By default, the MCP server starts a local tool-server on the first tool call. All agents on the machine share this local tool-server. When argent link or ARGENT_TOOLS_URL names a remote tool-server, the MCP server sends the tool calls there instead.

Run argent server status to see the state of the local tool-server. Run argent server logs to read its output.

Configure the MCP server​

Environment variables in the MCP server entry configure the MCP server. ARGENT_TOOLS_URL selects the tool-server that receives the tool calls. ARGENT_MCP_LOG selects the file where the MCP server writes its log of tool calls. See Configuration for the list of variables.

Tools​

The MCP server exposes every Argent capability as a tool. Run argent tools to list them from the terminal. See the Tools reference for the name and the description of each tool.

We are Software Mansion.

Hire us