Agentpass

What is AgentPass?

AI agents are becoming autonomous — but they can't authenticate anywhere. No email, no phone, no credentials, no identity. Every auth flow breaks autonomy.

AgentPass gives each agent a cryptographically signed digital passport — an Ed25519 identity that enables authentication on any internet service.

• Native Mode → Services integrate AgentPass SDK → instant challenge-response auth
• Fallback Mode → No integration needed → agent registers using passport infrastructure (email, SMS, browser automation)

⚡ Quickstart — Get a Passport in 60 Seconds

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

Or do it manually with curl:

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 🎉

See examples/quickstart.sh for the full working script.

Features

Architecture

8-package TypeScript monorepo:

  AI Agent (Claude Code, AutoGPT, etc.)
       │  MCP Protocol
       ▼
  MCP Server (local)  ──►  API Server (remote)
       │                        │
       ├── Credential Vault     ├── Passport Registry
       ├── Ed25519 Identity     ├── Trust Scoring
       └── Browser Automation   └── Audit Logs

Security: Private keys and credential vaults live exclusively on the agent's machine. The API server stores only public keys.

Development

pnpm install        # Install dependencies
pnpm build          # Build all packages
pnpm test           # Run 320 tests
pnpm lint           # Lint

Tests

320 tests passing across all packages — crypto, vault, API, MCP tools, SDK, and integration tests.

pnpm test

API Documentation

Full API reference: docs/API.md

Key endpoints:

SDK Integration

import { AgentPassSDK } from '@agentpass/sdk';

const ap = new AgentPassSDK({ apiUrl: 'https://api.agentpass.space' });

const result = await ap.verify({
  passportId: 'ap_7xk2m9f3abcd',
  challenge: 'random-nonce',
  signature: 'base64url-signature',
});

if (result.valid) {
  console.log('Agent verified! Trust:', result.trust_score);
}

Contributing

Contributions welcome! Please:

1. Fork and create a feature branch
2. Write tests for new features
3. Use conventional commits (feat:, fix:, docs:, test:, etc.)
4. Run pnpm test && pnpm lint before submitting
5. Open a PR with a clear description

License

MIT