# Auth Your Agent

> Auth Your Agent is a free MCP server for security. Approve agent actions from your phone; sandboxed browser vault with saved logins. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, Android, CLI, self-hosted
- **Website:** https://authyouragent.com
- **Repository:** https://github.com/kjames2001/authyouragent
- **MCP Registry name:** com.authyouragent/mcp
- **Categories:** security, browser automation
- **Listing updated:** 2026-11-15

## About

The core idea is that an agent never holds your password. It asks Auth Your Agent for access to a site, your phone prompts you with the agent, the site and the permissions, and you approve with a passkey. The agent then gets a pass valid for 10 minutes for that one site, usable only together with the agent's own private key, and renewed until you revoke it or the period you chose (1 hour to 30 days) ends.

For sites that have not adopted it, a browser vault running in Docker on your machine lets you take over the agent's browser from your phone to sign in or solve a CAPTCHA or 2FA step, then hands it back and signs out when the task is done. It can also fill logins from a Bitwarden or Vaultwarden folder without the agent seeing the value. Scheduled tasks use a plan you approve once, and risky actions such as payments always ask again.

The MCP server is a Python package run over stdio and needs an agent ID, a key file and a vault. The service is free during early access.

## Features

- **Phone approvals:** Approve each agent, site and permission with a passkey and revoke in one tap.
- **Short-lived passes:** Passes last 10 minutes, are tied to one site and need the agent's private key.
- **Sandboxed browser vault:** A Docker vault lets you take over the browser to sign in and wipes the profile afterwards.
- **Saved login fill:** Fills passwords and codes from a Bitwarden or Vaultwarden folder without exposing values to the agent.
- **Scheduled plans:** Approve a multi-step plan once and matching steps run while you are away.
- **Payment confirmation:** Purchases wait for the owner's tap through a standard OpenID Connect request.

## Good for

- Let an agent use a website that needs a login without sharing your password
- Take over an agent's browser when it hits a CAPTCHA or 2FA prompt
- Approve a nightly posting plan once
- Confirm an agent's purchase from your phone
- Revoke an agent's access to a single site

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp --env AYA_AGENT_ID='<AYA_AGENT_ID>' --env AYA_KEY_FILE='<AYA_KEY_FILE>' -- uvx authyouragent
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "uvx",
      "args": [
        "authyouragent"
      ],
      "env": {
        "AYA_AGENT_ID": "<AYA_AGENT_ID>",
        "AYA_KEY_FILE": "<AYA_KEY_FILE>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "uvx",
      "args": [
        "authyouragent"
      ],
      "env": {
        "AYA_AGENT_ID": "<AYA_AGENT_ID>",
        "AYA_KEY_FILE": "<AYA_KEY_FILE>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "authyouragent"
      ],
      "env": {
        "AYA_AGENT_ID": "<AYA_AGENT_ID>",
        "AYA_KEY_FILE": "<AYA_KEY_FILE>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "uvx",
      "args": [
        "authyouragent"
      ],
      "env": {
        "AYA_AGENT_ID": "<AYA_AGENT_ID>",
        "AYA_KEY_FILE": "<AYA_KEY_FILE>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "command": "uvx",
      "args": [
        "authyouragent"
      ],
      "env": {
        "AYA_AGENT_ID": "<AYA_AGENT_ID>",
        "AYA_KEY_FILE": "<AYA_KEY_FILE>"
      }
    }
  }
}
```

## FAQ

### Does the agent see my passwords?

No. Its own key stays on its machine, and saved logins are filled by the vault without the agent seeing the value.

### What does it need to run?

The PyPI package authyouragent, an agent ID, a private key file and a browser vault that needs Docker.

### Is it paid?

The site says it is free while in early access.

### Do websites have to support it?

No. Sites can add sign-in with it, but otherwise the agent asks you to take over its browser.

### Is Auth Your Agent free?

Yes. Auth Your Agent is free to use.

### How do I add Auth Your Agent to Claude Code?

Run this command in your terminal: claude mcp add mcp --env AYA_AGENT_ID='<AYA_AGENT_ID>' --env AYA_KEY_FILE='<AYA_KEY_FILE>' -- uvx authyouragent

### What are the best alternatives to Auth Your Agent?

The closest alternatives to Auth Your Agent are REA, Browser Use, Scrapling MCP Server, Oya Browser and Agent Roast.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Browser Use](https://ai-powered.com/mcp/browser-use): Browser Use is a freemium MCP server for browser automation.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Mantis](https://ai-powered.com/mcp/mantis-2): Mantis is an open-source MCP server for browser automation.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.

---
Source: https://ai-powered.com/mcp/auth-your-agent
