Auth Your Agent MCP Server

An open-source MCP server that lets an AI agent act for a person on websites, with the person's approval on their phone.

Local serverstdio

What is the Auth Your Agent MCP Server?

authyouragent is an MCP project maintained in the kjames2001/authyouragent repository. The maintainer describes its purpose as “An open-source MCP server that lets an AI agent act for a person on websites, with the person's approval on their phone”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using authyouragent-mcp. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares AYA_AGENT_ID, AYA_KEY_FILE, AYA_VAULT_URL, AYA_VAULT_TOKEN_FILE. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
check_login_wallIs the page blocked by a password, CAPTCHA, one-time code or sign-in approval? Reads the page's fields and text, so the model needs no vision.
request_takeoverAsk the owner to take over the browser from their phone. Returns done, cancelled, expired, incomplete, or waiting.
wait_for_takeoverKeep waiting after waiting.
request_approvalAsk the owner to approve an action. approved, denied or expired.
notify_ownerA one-way note to the owner's phone: done, stuck, or what failed. Nothing to approve.
end_sessionSign out of every site used, then destroy the browser profile. Reports per site whether sign-out was confirmed. The vault then sends the owner its own…
check_agent_statusactive or revoked.
report_siteReport a site where take over did not work.

How to install the Auth Your Agent MCP Server

{
  "mcpServers": {
    "authyouragent": {
      "command": "authyouragent-mcp",
      "env": {
        "AYA_AGENT_ID": "ag_...",
        "AYA_KEY_FILE": "YOUR_AYA_KEY_FILE",
        "AYA_VAULT_URL": "http://127.0.0.1:7801",
        "AYA_VAULT_TOKEN_FILE": "YOUR_AYA_VAULT_TOKEN_FILE"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
AYA_AGENT_IDDeclared in the maintainer’s client configuration.Check documentation
AYA_KEY_FILEDeclared in the maintainer’s client configuration.Check documentation
AYA_VAULT_URLDeclared in the maintainer’s client configuration.Check documentation
AYA_VAULT_TOKEN_FILEDeclared in the maintainer’s client configuration.Check documentation