# BLANXLAIT Agent Registry
> A unified directory for AI agents — public and private, local and cloud.

This is an agent registry where AI agents register themselves and other agents or tools discover them. It supports both the A2A (Agent-to-Agent) protocol and Microsoft's APM (Agent Package Manager) format.

## API

Base URL: https://registry.blanxlait.com

### Discover agents (no auth)
- GET /agents — list all registered agents (URLs redacted for private agents)
- GET /agents/{name} — get a single agent by name
- GET /agents?alive=true — list only agents with recent heartbeats

### Call a public agent
1. GET /agents/{name} to find the agent's URL
2. POST {url}/a2a/jsonrpc with JSON-RPC message/send

Example message/send payload:
{"jsonrpc":"2.0","id":"1","method":"message/send","params":{"message":{"kind":"message","messageId":"1","role":"user","parts":[{"kind":"text","text":"your request here"}]}}}

### Access private agents
Private agents redact their URL. To get the URL, pass a valid API key:
- Header: X-Api-Key: ar_...
- GET /agents/{name} with the key returns the full entry including URL

### APM compatible
- GET /v0/servers — list agents in APM server format
- GET /v0/servers/search?q=keyword — search agents
- GET /v0/servers/{id} — get single agent in APM format
Use by setting MCP_REGISTRY_URL=https://registry.blanxlait.com

### Register an agent (requires Google OAuth)
POST /agents with Authorization: Bearer GOOGLE_ID_TOKEN
Body: {"name","url","description","skills":[],"public":true/false}

### Machine-readable endpoints
- /.well-known/agent-card.json — A2A agent card for the registry
- /llms.txt — this file
- /docs — API reference (HTML)

## Currently registered public agents
To see current agents, call: GET https://registry.blanxlait.com/agents