> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobilerun.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes Agent

> Connect Hermes Agent to Mobilerun phones using the Mobilerun MCP server.

Hermes Agent is a personal agent runtime with an MCP client. Connect Mobilerun to give it phone inspection and task tools.

## Setup

1. [Set up a phone](https://docs.mobilerun.ai/devices.md) and install Hermes.

2. Register the remote MCP server and complete OAuth sign-in:

   ```bash theme={null}
   hermes mcp add mobilerun --url https://cloud.mobilerun.ai/api/mcp --auth oauth
   ```

   Alternatively, create a Mobilerun [API key](https://docs.mobilerun.ai/api-keys.md) and merge this entry into `~/.hermes/config.yaml`:

   ```yaml ~/.hermes/config.yaml theme={null}
   mcp_servers:
     mobilerun:
       url: "https://cloud.mobilerun.ai/api/mcp"
       headers:
         Authorization: "Bearer ${MOBILERUN_API_KEY}"
   ```

3. If using the API key configuration, set `MOBILERUN_API_KEY` in Hermes's private `~/.hermes/.env` or process environment. Restart Hermes or run `/reload-mcp`, then use `hermes mcp test mobilerun` to check the connection.

## First task

> List my Mobilerun devices and take a screenshot of the ready device.

Review tool permissions before approving actions. See [MCP Server](https://docs.mobilerun.ai/mcp-server.md) for available tools.

See the [Hermes Agent MCP documentation](https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.