Skip to content
MCP server

Auth Your Agent

Approve agent actions from your phone; sandboxed browser vault with saved logins

Runs locallyStatus and history
Pricing
Free
Platforms
Web, Android, CLI
Runs
Locally
Version
0.3.42
Listing updated
2 days ago

About Auth Your Agent

Auth Your Agent is a free MCP server for security. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • AYA_AGENT_IDYour agent's id (ag_...), from Agents in the Auth Your Agent appRequired
  • AYA_KEY_FILEPath to the agent's private key (PEM), created with: authyouragent keygenRequired
  • AYA_VAULT_URLBrowser vault address
  • AYA_VAULT_TOKEN_FILEPath to the vault's token file

What it does

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

Pricing

Free

Free while in early access

Prices change. Check authyouragent.com before you buy.

Auth Your Agent 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 to Auth Your Agent

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Browser Use

    MCP server

    Browser agents and cloud browsers for AI, with an MCP server for web tasks

    • 7 tools
    • Remote
    • Freemium
    • 121K GitHub stars
    • Browser automation
  3. MCP 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
  4. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  5. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools
  6. Mantis

    MCP server

    Browser MCP server that gives agents numbered text pages instead of screenshots

    Runs locally
    • 1 tool
    • Open source
    • 5 Hacker News points
    • Browser automation