cli

@auth/agent-cli

CLI and MCP server for the Agent Auth Protocol.

Installation

npm install -g @auth/agent-cli

Or run directly:

npx @auth/agent-cli --help

CLI Usage

# Discover a provider
auth-agent discover https://api.example.com

# List capabilities
auth-agent capabilities --provider https://api.example.com

# Describe a specific capability
auth-agent describe transfer_money --provider https://api.example.com

# Connect an agent
auth-agent connect --provider https://api.example.com \
  --capabilities read_data transfer_money \
  --name my-agent

# Connect with constraints
auth-agent connect --provider https://api.example.com \
  --capabilities read_data transfer_money \
  --constraints '{"transfer_money":{"amount":{"max":1000}}}' \
  --name constrained-agent

# Execute a capability
auth-agent execute <agent-id> transfer_money \
  --args '{"amount": 50, "to": "alice"}'

# Check agent status
auth-agent status <agent-id>

# Request additional capabilities
auth-agent request <agent-id> \
  --capabilities admin_panel \
  --constraints '{"admin_panel":{"scope":{"in":["read","write"]}}}'

# Disconnect
auth-agent disconnect <agent-id>

MCP Server

Run as an MCP (Model Context Protocol) server for AI agent integration:

auth-agent mcp --url https://api.example.com

Cursor / Claude Desktop Configuration

{
  "mcpServers": {
    "auth-agent": {
      "command": "npx",
      "args": ["@auth/agent-cli", "mcp", "--url", "https://api.example.com"]
    }
  }
}

Commands

Command	Description
discover <url>	Discover a provider
search <intent>	Search directory for providers
providers	List known providers
capabilities	List capabilities for a provider
describe <name>	Get full capability definition
connect	Connect an agent to a provider
status <agent-id>	Check agent status
execute <agent-id> <capability>	Execute a capability
request <agent-id>	Request additional capabilities
sign <agent-id>	Sign an agent JWT
disconnect <agent-id>	Disconnect an agent
reactivate <agent-id>	Reactivate expired agent
connections <issuer>	List agent connections
connection <agent-id>	Get a stored connection
rotate-agent-key <agent-id>	Rotate agent keypair
rotate-host-key <issuer>	Rotate host keypair
enroll-host	Enroll host with token
mcp	Start MCP server

Environment Variables

Variable	Description
AGENT_AUTH_STORAGE_DIR	Storage directory for keys and connections
AGENT_AUTH_DIRECTORY_URL	Directory URL for provider search
AGENT_AUTH_HOST_NAME	Host name for identification

License

MIT