AgentPass

AgentPass

Auth0 for AI Agents

AgentPass introduces a revolutionary approach to identity and authentication for autonomous AI agents, addressing the critical need for agents to establish their identity in digital landscapes where traditional authentication methods like email or phone credentials fall short. This unique solution provides each agent with a cryptographically signed digital passport, utilizing Ed25519 identities for seamless authentication across internet services.

Key Features

• Cryptographic Identity: Utilizes Ed25519 key pairs, ensuring that private keys remain securely on the agent without exposure.
• Credential Vault: Implements AES-256-GCM encryption for local storage of critical authentication data.
• Native Experience: Offers instant challenge-response authentication by integrating the AgentPass SDK with various services.
• Fallback Authentication: Employs Playwright browser automation as a backup option for agents not using the native mode.
• Agent Email: Assigns dedicated email addresses for verification processes.
• SMS Verification: Supports phone number functionalities for one-time passcode (OTP) verifications.
• Trust Scoring: Integrates a reputation system ranging from 0 to 100 to evaluate agent trustworthiness.
• MCP Integration: Provides access to 17 tools designed for Claude Code and other Model Completion Protocol (MCP) clients.
• Service SDK: Includes an npm package for conducting third-party verification.
• Control Mechanisms: Offers functionalities for managing permissions, approval workflows, and instant revocations.

Quick Start Guide

Get started quickly by obtaining an Agent Passport in under 60 seconds:

# Clone and run the quickstart script
git clone https://github.com/kai-agent-free/AgentPass.git
cd AgentPass
bash examples/quickstart.sh

Alternatively, use the following curl commands to obtain a passport manually:

API="https://api.agentpass.space"

# 1. Register
curl -s -X POST "$API/auth/register" \
  -H "Content-Type: application/json" \
  -d '{"email":"demo@example.com","password":"SecurePass1!","name":"demo-agent"}'

# 2. Create passport (use the token from step 1)
curl -s -X POST "$API/passports" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"public_key":"...","name":"my-agent","description":"My first agent"}'

# Done — your agent has an identity 🎉

Architecture

AgentPass is designed as an 8-package TypeScript monorepo to ensure efficient modularity and performance. Key packages include:

• @agentpass/core: Manages cryptographic functions, passport types, vault implementations, and logging features.
• @agentpass/api-server: Hosts the HTTP API responsible for passport registration, verification, and trust scoring.
• @agentpass/mcp-server: Provides MCP server capabilities with 17 tools dedicated to AI agents.
• @agentpass/sdk: Contains a service SDK for enabling third-party identity verification processes.
• @agentpass/email-service: Facilitates email routing and OTP extraction through Cloudflare Workers.
• @agentpass/browser-service: Handles session management via Playwright for fallback authentication methods.
• @agentpass/dashboard: Encompasses an owner dashboard built with React and Tailwind CSS for a modern user experience.
• @agentpass/landing: Presents the public-facing landing page of the service.

Development Setup

To contribute to AgentPass:

pnpm install        # Install dependencies
pnpm build          # Build all packages
pnpm test           # Run all tests (320 tests passing)
pnpm lint           # Lint the codebase

API Documentation

To explore the complete API references and key endpoint functionalities, refer to the API documentation.

Key endpoints include:

Conclusion

AgentPass empowers AI agents with the digital identity they need to interact autonomously across various platforms. With robust security measures and flexible authentication options, it serves as a foundational tool for future AI advancements.