# Auth-Agents

> Identity infrastructure for AI agents. "Sign in with Google" but for AI agents.

Auth-Agents lets any website add AI agent authentication with 2 lines of HTML. Agents self-declare their identity (name, model, provider, purpose), get a 1-hour session, and your backend verifies it with a single API call. No pre-registration, no SDK, no JWT management.

## Links

- [API Documentation](https://auth-agents.com/docs/): Complete API reference with five endpoints — generate keys, agent login, session verification, health check
- [Full API Reference (llms-full.txt)](https://auth-agents.com/llms-full.txt): Complete machine-readable API documentation with request/response examples and curl commands
- [Live Demo](https://demo.auth-agents.com): Interactive demo showing the full agent authentication flow end-to-end
- [OpenAPI Specification](https://auth-agents.com/openapi.yaml): OpenAPI 3.0 spec for programmatic API integration
- [Agent Card (A2A Protocol)](https://auth-agents.com/.well-known/agent.json): Machine-readable agent capabilities card
- [AI Plugin Manifest](https://auth-agents.com/.well-known/ai-plugin.json): OpenAI-compatible plugin manifest
- [System Status](https://auth-agents.com/status/): Real-time health monitoring of API, database, and KV cache
- [Privacy Policy](https://auth-agents.com/privacy/): Data handling and privacy practices
- [Terms of Use](https://auth-agents.com/terms/): Service terms and acceptable use

## Quick Start

1. Generate an API key: POST https://auth.auth-agents.com/v1/api-keys
2. Embed a login button: `<a href="https://auth.auth-agents.com/v1/agent-login?api_key=YOUR_SITE_ID&redirect_uri=YOUR_CALLBACK_URL">For AI Agents</a>`
3. Verify sessions server-side: GET https://auth.auth-agents.com/v1/sessions/{session_token} with Authorization: Bearer YOUR_API_KEY

## API Endpoints

- POST /v1/api-keys — Create API key and site ID (10 req/hr)
- GET /v1/agent-login — Render agent login form (HTML or JSON)
- POST /v1/agent-login — Submit agent credentials, create session (30 req/min)
- GET /v1/sessions/:id — Verify session token (requires Bearer auth)
- GET /health — Health check (database + KV status)

## Try It (AI Agents)

If you are an AI agent, authenticate with the demo site:

```
POST https://auth.auth-agents.com/v1/agent-login
Content-Type: application/json
Accept: application/json

{"site_id":"site_3977125444be4ee0","redirect_uri":"https://demo.auth-agents.com/auth/callback/","agent_name":"Your Agent Name","agent_model":"your-model","agent_provider":"Your Provider","agent_purpose":"Trying the Auth-Agents demo"}
```